前言¶
DeepSeek Harness(DSH)採用插件化架構,允許開發者將特定工具無縫集成到智能體工作流中。在學術寫作或研究自動化場景中,生成規範參考文獻和驗證元數據往往涉及繁瑣的手動查詢或編寫定製的解析邏輯。dsh-cite 插件直接解決了這個問題:通過 Crossref API 提供標準化的文獻元數據查詢與引用格式化能力。
插件簡介¶
dsh-cite 是 DeepSeek Harness 的一個插件,由 STARDUSTLC666 維護。它通過 Crossref REST API 查詢文獻元數據並格式化引用。插件提供五個工具,包含自檢功能,零運行時依賴,全平臺通用。
安裝與啓用¶
使用以下命令在 Web profile 下安裝插件:
dsh plugin --profile web add dsh-cite
卸載時使用:
dsh plugin --profile web remove dsh-cite
核心功能¶
插件提供五個工具,覆蓋文獻查詢、引用生成、DOI 校驗與自檢。
-
cite_lookup
查詢文獻元數據。支持 DOI 精確查詢或題錄檢索。參數中需提供doi或query至少一個,limit控制返回數量(1-10,默認 5)。 -
cite_format
生成規範引文。參數doi必填,style指定格式(支持 gb-t-7714 / apa / mla / chicago)。 -
cite_bibtex
生成 BibTeX 條目。參數doi必填,key爲可選的 BibTeX 鍵。 -
cite_check
從文本提取 DOI 並併發校驗是否存在。併發數爲 3,保持輸入順序。參數text必填,maxChecks控制最大檢查數(1-50,默認 10)。 -
cite_health
自檢工具。探測 Crossref 連通性並報告延遲,無需參數。
典型用法¶
示例 1:獲取指定 DOI 的 GB/T 7714 引用
用戶:給我 10.1038/nature12345 的 GB/T 7714 引用
Agent:
cite_format { doi: "10.1038/nature12345", style: "gb-t-7714" }
→ LeCun Y, Bengio Y, Hinton G. Deep learning[J]. Nature, 2015, 521(7553): 436-444.
示例 2:校驗文本中 DOI 的有效性
用戶:檢查這段參考文獻的 DOI 是否有效
Agent:
cite_check { text: "..." }
注意事項與限制¶
- 環境要求:Node 版本需爲 22.19 及以上的 22.x,或 24 及以上。
- 數據源:數據源爲 Crossref REST API,無需 API key。
- 輸出格式:引文爲純文本輸出;格式按常見模板生成,正式投稿前請覈對目標期刊的細節要求。
- 隱私:不採集、不上傳任何本地文獻數據。
生態信息¶
該插件收錄在 DSH 社區目錄: