Parker-xia/dsh-research-refs

dsh-research-refs

一个 DeepSeek Harness (DSH) 插件，可将杂乱粘贴的引用转换为格式统一的参考文献。它源自 opencode 的 research-refs 技能，并重建为确定性的工具链——解析、验证、去重和格式化均由代码完成，而技能仅负责编排流程。

功能特性

四个工具加一个编排技能：

| 工具 | 用途 |
|---|---|
| refs_parse | 将杂乱的引用文本拆分为单条条目（编号 → 空行 → 类型标记策略），尽力解析字段；字段缺失或拆分不确定的条目会带有 flags |
| refs_verify | 通过 Crossref 验证并补全：有 DOI 时，查询 works/{DOI} 以补全卷/期/页码、期刊和年份；无 DOI 时，按标题 + 作者搜索（相似度 ≥ 0.9 自动应用，否则返回前 5 个候选供用户选择）。中文参考文献标记为“无法在线验证” |
| refs_dedup | 自动去重：DOI 相同，或标题相似度 ≥ 0.85 且第一作者姓氏相同；保留最完整/已验证的条目，并报告被移除的内容 |
| refs_format | 按 GB/T 7714-2015 / APA / Vancouver 输出；英文作者规范为“SURNAME Initials”（例如 ZHANG S），中文作者保留全名；末尾附待处理条目列表；可选写入 .md 文件 |

research-refs 技能教会模型按“解析 → 与用户确认 → 验证（候选选择）→ 去重 → 询问样式 → 输出”编排流程，并强制执行铁律：绝不编造字段——任何无法验证的内容都标记为待处理。

安装

npm i github:Parker-xia/dsh-research-refs

添加到你的组合

追加到你的 DSH 组合（cordis.yml 或某个 agent 预设的 agent.cordis.yml）中：

- id: research-refs
name: 'dsh-research-refs'

或使用 bundle 补丁机制（dsh bundle patch，参见 cordis.patch.yml）。

已针对 @deepseek-ai/dsh@0.1.0-rc.6 测试——预览版迭代很快，因此升级时请固定此版本或查看 GitHub Discussions。需要宿主 tools 服务；fs / skills 为可选（能力会优雅降级，缺失时会被标记）。

在线验证是自给自足的：refs_verify 使用 Node 原生 fetch（在 DSH 的 Node ≥ 22 引擎上始终可用）直接与 Crossref 通信——它不要求宿主配置任何 web fetch 提供程序，也不会注册一个（因此绝不会与宿主提供程序冲突）。如果原生 fetch 不可用（例如在动态沙箱内），它会自动回退到 ctx.web 服务。

用法

粘贴一段杂乱的引用，然后说类似“清理这些参考文献”的话。agent 会加载技能，并在流程的每一步进行报告：

你：清理这些参考文献：
1. Zhang S et al. 2021. Deep learning for CT reconstruction...
2. Wang S (2024) 图像重建算法……

Agent: [refs_parse] 已拆分 2 条条目，所有字段均已识别……
[refs_verify] #1 已验证（DOI），#2 候选条目待选择……
[refs_dedup] 保留 2 条，未删除任何条目
[refs_format] GB/T 7714-2015 输出……

许可证

MIT