前言¶
在 DeepSeek Harness（DSH）裏做文獻綜述或寫技術報告時，引用往往散落在多輪迴復裏：一輪裏是 DOI，另一輪是 APA 行，更早的幾輪只提了論文名。手工整理慢且容易漏；讓模型直接生成 .bib 又常見頁碼、DOI、作者順序被「補全」成錯誤信息，往往在投稿前才被發現。DSH 生態按「一切皆插件」擴展能力；社區目錄（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係，插件需自行審閱源碼與許可證後再啓用。
下面介紹 dsh-refkeeper（維護者 ymwang92，分類：聯網工具）：它讀取你選定的對話範圍，解析其中出現的引用，向 Crossref、OpenAlex、arXiv、DataCite 等註冊庫覈對元數據，將通過校驗的條目導出爲 BibTeX 或 RIS，無法確認的條目單獨隔離，不進入默認導出庫。
這是什麼¶
dsh-refkeeper 是面向 DeepSeek Harness 的插件，npm 包名同爲 dsh-refkeeper（當前資料中版本 0.1.1，許可證 MIT）。一句話定位：Verify and export the references your DeepSeek Harness conversation already cited——即從當前會話裏已經出現的引用出發做校驗與導出，而不是讓模型憑記憶編書目。
核心功能¶
採集範圍與識別方式¶
可從單輪、最近 N 輪或整段會話採集。識別 DOI、arXiv id、ISBN、報告號，以及 APA、GB/T 7714、IEEE 風格的參考文獻行。默認不把工具輸出當作引用，減少「從未在正文用過卻被寫進庫」的條目。
註冊庫校驗¶
並行查詢 Crossref、OpenAlex、arXiv、DataCite。條目被接受需同時滿足：題名匹配、年份相差不超過一年、第一作者匹配，且至少一個註冊庫返回記錄。字段以註冊庫爲準；對話與註冊庫都不支持的字段不會寫入導出文件。
無法確認且註冊庫有明確不一致的條目進入 refs/quarantine.json（隔離，默認不導出）。註冊庫暫時不可達時爲 unverified，仍留在庫中可稍後重試——網絡失敗不視爲引用錯誤。
註釋與導出¶
捕獲後，由當前 profile 的默認模型爲每條（單次捕獲最多 12 條、超時 60 秒）填寫四個短字段：summary、relevance、evidence、caveats；引文必須在對話原文中出現，否則丟棄。用戶手寫註釋可通過 ref_save 寫入，已有用戶註釋不會被覆蓋。
導出 BibTeX、RIS 或兩者；範圍可以是最近一次捕獲、勾選的條目或整個庫。同一導出兩次字節一致，條目排序與 citekey 穩定。
界面入口¶
編寫區工具行（與工作模式、模型選擇並列）增加一項：❝ Refs（中文界面爲 ❝ 引用）。點擊後在編寫區上方打開捕獲面板，無獨立側欄或懸浮窗。
安裝與啓用¶
在 DSH 中打開 Settings → Plugins → Add plugin，輸入包名：
dsh-refkeeper
包發佈在 npm，一步安裝、無需本地 build（tarball 內含已構建的 lib/）。在當前 profile 啓用後重新加載。
若跟蹤倉庫而非 npm 版本，在同一對話框粘貼 Git 地址（資料原文）：
https://github.com/ymwang92/dsh-refkeeper
倉庫同樣提交 lib/，該路徑也無需 build。
插件以當前 DSH 進程的權限運行；安裝前請閱讀 GitHub 倉庫 源碼與 MIT 許可證。package.json 要求 Node ^22.19.0 || >=24.0.0 與 dsh: *。
典型用法¶
- 打開已包含文獻引用的對話，點擊
❝ Refs/❝ 引用打開捕獲面板。 - 選擇範圍，執行 Capture & save。
- 面板列出已保存條目與進入 ⚠ 隔離區的條目；取消勾選不需要導出的項。
- 選擇 BibTeX 和/或 RIS，點擊 Export this capture。
等價的命令形式（資料原文）：
/refs capture --scope=all --save
/refs export --format=both
輸出寫在會話工作區內的 refs/ 目錄。可在面板中指定導出目錄路徑一次，會記在 refs/settings.json；會話工作區外的路徑會被拒絕（宿主僅允許在工作區內寫入）。
閱讀副本示例文件爲 refs/annotated.md；書目數據在 refs/refs.json，隔離區在 refs/quarantine.json。
適用場景與注意¶
適合：已在 DSH 多輪對話中引用論文、需要可覈對元數據的 BibTeX/RIS，並希望在導出裏保留「爲何引用、對話中的原句證據」的開發者或寫作者。
注意：
- 依賴聯網查詢註冊庫；離線或註冊庫不可達時部分條目爲
unverified，需稍後重試。 - 中文 GB/T 7714 行與中文題名通過字符 bigram（Dice ≥ 0.90）與註冊庫匹配，與純英文 token 匹配策略不同。
- 捕獲超過 12 條或無可用模型時，書目字段仍保留，註釋可能跳過（捕獲結果會說明原因）。
結尾¶
dsh-refkeeper 把「對話裏真實出現過的引用」當作唯一來源，用公開註冊庫約束元數據，並把無法確認的條目與可導出庫分開，適合在 DSH 裏做完文獻檢索式對話後再整理參考文獻。目錄頁：SkillHub - ymwang92/dsh-refkeeper；源碼與完整說明：GitHub - ymwang92/dsh-refkeeper。
