前言¶
做论文写作、文献整理或 agent 任务时，常会遇到一个问题：引用列表看起来完整，但作者、年份、卷期页、DOI 可能有误；手动逐条查 Crossref、OpenAlex、arXiv 又比较碎。DeepSeek Harness 的插件生态允许把工具挂进会话，dsh-reference-checker 就是其中一类面向 DSH 的参考文献检查工具。
它提供模型工具 reference_checker，可以把论文或粘贴的文献列表逐条核对 Crossref、OpenAlex、arXiv，并生成按输入样式改写的更正版引用。
这是什么¶
dsh-reference-checker 是一个 DeepSeek Harness 插件，仓库为 Yu-tao-Li/dsh-reference-checker，许可证为 MIT。它解决的问题是：在 DSH 会话中快速检查一批引用是否能从公开书目数据源中找到对应记录，并给出可用于替换的更正版引用。
输入可以是 .pdf、.bib、.tex、.txt、.md 文件路径，也可以是粘贴文本。插件读取给定文件，查询 Crossref、OpenAlex、arXiv，对每条文献给出判定，并生成更正版引用。
运行环境要求 Node >= 22，跨平台，无原生依赖；唯一运行时依赖是 pdf-parse（MIT）。
核心功能¶
- 提供 DSH 模型工具
reference_checker。 - 支持
.pdf/.bib/.tex/.txt/.md文件路径，或粘贴文本作为输入。 - 并发查询 Crossref、OpenAlex、arXiv 三个书目数据源。
- 对每条文献给出
found、partial、not_found、error判定。 - 按输入样式生成更正版引用，支持 APA、GB/T 7714、IEEE、Vancouver、MLA、Chicago、Harvard、ACS、BibTeX。
- 默认检查前 50 条，硬上限 200 条；超过上限时，在结果中标记
truncated。 - 插件只读取给定文件，不写文件；网络访问仅限 Crossref、OpenAlex、arXiv 的 API。
安装与启用¶
安装命令：
dsh plugin --profile web add github:Yu-tao-Li/dsh-reference-checker
安装后重启 dsh web，或重启 dsh 进程。重启完成后，reference_checker 在所有会话可用。
典型用法¶
可以直接对 agent 说：
检查这份论文的参考文献是否真实
然后把文件给它。也可以把文献列表直接粘过去。
工具参数如下：
| 参数 | 说明 |
|---|---|
path |
文件路径，支持 .pdf / .bib / .tex / .txt / .md；相对路径相对会话工作区解析 |
references |
粘贴文本：一行一条引用（任意常见样式），或整段 BibTeX |
maxRefs |
检查上限，默认 50，硬上限 200 |
如果输入是文件，插件会基于该文件中的引用内容进行检查；如果输入是粘贴文本，插件会基于粘贴的引用列表逐条处理。
适用场景与注意¶
适合在 DSH 会话中快速检查引用是否能在 Crossref、OpenAlex、arXiv 中找到对应记录，或者需要得到按原样式改写的更正版引用。
使用前注意：
1、not_found 不等于造假。未被 Crossref、OpenAlex、arXiv 收录的出版物同样可能查不到，需要人工核对最接近记录。
2、扫描件 PDF（无可提取文本层）会被拒绝；需要使用文本版 PDF，或直接粘贴参考文献。
3、插件以当前 dsh 进程权限运行；安装前应检查源码与许可证。该插件许可证为 MIT，唯一运行时依赖 pdf-parse 为 MIT。
4、插件只读取给定文件，不写任何文件；网络访问仅限 Crossref、OpenAlex、arXiv API。
5、默认单次检查 50 条，请节制批量使用，不要循环反复跑。
结尾¶
dsh-reference-checker 的价值在于把“逐条查引用、核对记录、按样式改写”这类机械步骤放进 DSH 会话中，适合需要在写作或审校流程里快速校验参考文献的场景。
GitHub 仓库：https://github.com/Yu-tao-Li/dsh-reference-checker。社区目录入口未在本文事实中确认；如需查看目录，建议以仓库 README 为准。
