前言¶
做論文寫作、文獻整理或 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 爲準。