前言¶
DeepSeek Harness（DSH）的核心理念是“一切皆插件”。當智能體或開發者需要處理學術文獻時，通常面臨跨數據源檢索效率低、引文格式難以統一、以及批量提取 BibTeX 數據繁瑣的問題。flan246/dsh-lit-search 旨在解決這些痛點，它將 Crossref、OpenAlex 和 Semantic Scholar 的能力整合在一起，提供統一的命令行接口和 DSH 工具集。
插件定位¶
這是一個集成式的學術文獻工具包，支持 DSH 插件、獨立 CLI 和 Agent Skill 三種形態。它主要服務於需要構建學術研究型 Agent、撰寫論文或進行文獻管理的開發者。
核心功能¶
- 合併檢索：同時查詢 Crossref、OpenAlex 和 Semantic Scholar，按 DOI 去重，返回標題、作者、年份、期刊及引用次數。支持通過
--from/--to過濾年份，或按引用數、日期、相關性排序。 - 引文格式化：默認支持中文論文常用的 GB/T 7714 標準，也支持 GB/T 7714 數字格式（如
[1]-style）、APA 和 BibTeX。 - 批量 BibTeX 生成：針對一組 DOI 生成合並的
.bib文件，並單獨列出生成失敗的條目。 - 相關文獻：基於 OpenAlex 的
related_works接口，獲取指定 DOI 的相關論文。
安裝與啓用¶
通過官方目錄安裝插件：
dsh plugin add dsh-lit-search
安裝完成後，DSH 會註冊四個工具：lit_search、lit_cite、lit_bib 和 lit_related。
典型用法¶
安裝成功後，可直接通過命令行調用工具，或在 Agent 中使用上述工具名稱。以下是 CLI 的典型用法：
# 檢索論文，限制返回數量
npx dsh-lit-search search "attention is all you need" -n 5
# 檢索 2024 年後的論文，並按日期排序
npx dsh-lit-search search "moe" --from 2024 --sort date
# 生成 BibTeX 格式的引文
npx dsh-lit-search cite 10.1038/nature14539 -s bibtex
# 生成 GB/T 7714 數字格式的引文（適用於中文論文）
npx dsh-lit-search cite 10.1038/nature14539 -s gbt7714-numeric
# 批量生成 BibTeX 文件
npx dsh-lit-search bib 10.1038/nature14539 10.48550/arXiv.1706.03762
# 獲取相關文獻
npx dsh-lit-search related 10.1038/nature14539 -n 5
所有命令默認輸出人類可讀文本。若需機器輸出，可在子命令前添加 --json（例如 npx dsh-lit-search --json search "transformers"）。
適用場景與注意¶
- 數據源：所有接口均爲免費公共 API，無需申請 API Key。
- 網絡層：HTTP 請求設置了 10 秒超時，遇到 5xx 或網絡錯誤會重試一次，User-Agent 設置爲禮貌的
mailto:格式。 - 錯誤處理：程序退出碼定義如下：
0表示成功，1表示業務邏輯錯誤，2表示用法錯誤。 - 安全提示：插件以當前進程權限運行，建議在使用前確認源碼內容與許可證（MIT）。
總結¶
對於需要構建學術研究型 Agent 或處理論文引用的開發者，dsh-lit-search 提供了一個輕量且無需配置的解決方案。更多技術細節和源碼可參考其 GitHub 倉庫。
