dsh-research-refs：引文规范化工具链

前言¶

在 DeepSeek Harness (DSH) 的工作流中，经常需要处理从文档或网页直接粘贴的引文。这些引文往往格式混乱、字段不全。手动整理既耗时又容易出错。dsh-research-refs 插件将这一过程自动化，通过代码完成解析、验证、去重和格式化，使智能体能够快速产出规范的参考文献列表。

它是什么¶

dsh-research-refs 是一个 DSH 插件，由 Parker-xia 维护，属于工作流类别。它基于开源的 research-refs 技能构建，但将其重构为确定性的工具链。核心逻辑由代码驱动，智能体仅负责流程编排。

核心功能¶

插件包含四个工具及一个编排技能，按顺序处理引文数据：

1. refs_parse：解析杂乱的引文文本。支持编号、空行、类型标记等策略，尽力识别字段。无法解析或字段缺失的条目会被标记 flags。
2. refs_verify：通过 Crossref 验证并补全信息。
   • 若有 DOI，查询 works/{DOI} 获取卷期页、期刊和年份。
   • 若无 DOI，按标题 + 作者搜索。相似度 ≥ 0.9 自动应用，否则返回前 5 个候选供选择。
   • 中文引用标记为“不可在线验证”。
3. refs_dedup：自动去重。判断依据为 DOI 相同，或标题相似度 ≥ 0.85 且第一作者姓氏相同。保留字段最完整或已验证的条目，并报告移除项。
4. refs_format：输出标准化格式。
   • 支持格式：GB/T 7714-2015 / APA / Vancouver。
   • 英文作者标准化为“姓 初始”（如 ZHANG S），中文作者保留全名。
   • 结尾列出待处理项目。可选写入 .md 文件。
5. research-refs 技能：负责编排流程（解析 -> 确认 -> 验证 -> 去重 -> 请求样式 -> 输出），并强制执行“绝不编造字段”的规则。

安装与启用¶

安装依赖：

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

将插件添加到 DSH 组合配置中。在 cordis.yml 或智能体预设的 agent.cordis.yml 中追加以下内容：

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

或使用 bundle patch 机制（dsh bundle patch）。

依赖说明：
* 需要主机提供 tools 服务。fs 和 skills 是可选的，缺失时会降级并标记。
* 需要满足 Node 版本要求：Node >= 22.19.0 或 >= 24.0.0。
* 已在 @deepseek-ai/dsh@0.1.0-rc.6 上测试通过。

典型用法¶

在对话中粘贴一段杂乱的引文，并发出清理指令。

用户输入示例：

clean up these references:
1. Zhang S et al. 2021. Deep learning for CT reconstruction...
2. Wang S (2024) Image reconstruction algorithms...

智能体响应流程：
智能体加载 research-refs 技能，并按步骤报告处理状态：

[refs_parse] 2 entries split, all fields recognized...
[refs_verify] #1 verified (DOI), #2 candidates awaiting choice...
[refs_dedup] 2 kept, none removed
[refs_format] GB/T 7714-2015 output...

技术细节¶

• 网络验证：在线验证使用 Node 原生 fetch（DSH Node ≥ 22）。该插件不注册外部 web fetch 提供商，因此不会与主机的网络配置产生冲突。若原生 fetch 不可用（如沙盒环境），会自动降级使用 ctx.web 服务。
• 许可证：MIT。

生态背景¶

DSH 遵循“一切皆插件”的理念。本插件收录于独立站点 catalog_url，与 DeepSeek 或幻方官方无从属关系。

参考资料¶

• GitHub: https://github.com/Parker-xia/dsh-research-refs