前言¶
DeepSeek Harness (DSH) 是一個基於插件的智能體開發平臺。在使用大模型進行學術研究或文檔寫作時，模型有時會編造論文、作者或 DOI 等文獻信息，即產生“幻覺”。DeepSeek Harness 學術文獻插件旨在解決這個問題。它作爲純工具型插件接入 DSH，負責真實數據源的檢索與引用格式生成，從機制上杜絕模型編造文獻信息。
核心功能¶
該插件提供以下核心能力：
- 多數據源檢索：支持 arXiv 和 Semantic Scholar 兩個公開數據源。檢索時支持關鍵詞、作者、年份範圍過濾，並支持相關性、日期或引用數排序。
- 單篇論文詳情：可按 paperId、DOI 或 arXiv ID 獲取論文的完整元數據，包括摘要、作者列表、期刊/會議名稱、引用數以及 PDF 鏈接。
- 引用格式生成：本地確定性生成 GB/T 7714、APA 和 BibTeX 三種格式的引用，不依賴大模型。
- 本地文獻庫管理：支持將檢索到的文獻加入當前會話的文獻庫。文獻庫具備會話隔離、自動去重（基於 DOI/arXiv ID/標題）功能，支持刪除、清空及批量導出。
- 側邊面板與防幻覺：提供可視化的側邊面板（支持淺色/深色主題適配），用於查看歷史記錄、管理文獻庫。系統 Prompt 強制要求學術文獻必須經工具檢索，禁止編造。
安裝與啓用¶
安裝前請確保已安裝 DeepSeek Harness 環境，版本需滿足 Node.js 22+，並使用 Web profile。
安裝命令¶
執行以下命令將插件添加到 Web profile：
dsh plugin --profile web add dsh-plugin-academic-paper
重啓生效¶
安裝完成後，需重啓 Web profile 使插件生效：
dsh web
驗證¶
重啓後，DeepSeek Harness 網頁右下角會出現“📚 文獻”膠囊入口。點擊即可展開側邊文獻庫面板，此時模型即可使用 academic_* 系列工具。
配置項¶
插件支持行配置，修改後通常無需重啓即可熱更新生效。主要配置項包括：
enable：是否啓用插件（默認 true）。default_source：默認數據源，可選arxiv、semantic_scholar或both。max_results：單次檢索最大返回條數（1-50，默認 10）。default_cite_format：默認引用格式，可選gb_t_7714、apa或bibtex。request_timeout：API 請求超時時間（秒，默認 15）。max_library_size：單會話文獻庫上限（默認 500）。
典型用法¶
通過自然語言與模型交互，即可調用上述功能：
- 檢索文獻：
> “幫我檢索關於 transformer 的論文，最近 5 年，來源 arXiv” - 獲取詳情：
> “檢索 Vaswani 2017 那篇 Attention Is All You Need 的詳細信息” - 生成引用：
> “把這篇文獻加入文獻庫，然後用 GB/T 7714 生成引用” - 導出文獻庫：
> “導出文獻庫爲 BibTeX 和 Markdown”
注意事項¶
- 純工具型：本插件不提供付費全文下載服務，僅返回元數據與公開摘要。
- 數據隔離：文獻庫、檢索歷史及緩存僅保存在內存中，按會話隔離，插件卸載或 Harness 重啓後自動清空，無磁盤殘留。
- 許可證：遵循 MIT 許可證。
結尾¶
該插件通過對接公開 API 並在本地進行確定性處理，爲 DSH 提供了可靠的學術文獻檢索與引用管理能力。對於需要嚴謹引用背景的開發者或研究者，這是一個必要的輔助工具。
- GitHub: https://github.com/zhaoxuejie/dsh-plugin-academic-paper
