dsh-paperlens：文獻檢索科研副駕駛插件

前言¶

DeepSeek Harness (DSH) 生態採用“一切皆插件”的設計理念。針對科研場景中的文獻檢索、引用格式化及管理需求，開發者常需集成外部服務或編寫腳本。dsh-paperlens 是一個原生 Cordis 插件，提供多源學術檢索、引文格式化、文獻導出及本地 SQLite 文獻庫管理。它完全重寫了功能思路，不依賴瀏覽器認證，數據不出機器。

核心功能¶

插件提供以下工具，覆蓋從檢索到歸檔的全流程：

paper_search：跨源檢索學術論文。支持 OpenAlex 和 CrossRef，按相關性排序，自動去重，並提供元數據完整度評分（0-100）。
paper_details：獲取單篇論文的完整元數據，包括擴展摘要、作者信息、被引次數及原始鏈接。
paper_cite：生成標準引文格式，支持 APA 7th、MLA 9th、GB/T 7714、Chicago 17th 和 Vancouver。
paper_import_doi：批量導入 DOI，自動充實元數據並可選存入文獻庫。
paper_save：將論文存入本地 SQLite 文獻庫，支持收藏夾分類、標籤管理及閱讀狀態標記（unread/reading/read）。
paper_export：將整個文獻庫導出爲 RIS、BibTeX 或 CSV 格式。

安裝與啓用¶

安裝插件後，插件會通過 dsh.bundle.patch 自動掛載，無需手動修改配置文件。

安裝命令：

# 本地開發安裝（file: 路徑免 allowBuilds）
dsh plugin --profile web add file:D:/Coding/DSH-Plugin/dsh-paperlens

# 或從 GitCode 安裝（包內已包含 lib/，無 prepare 腳本）
dsh plugin --profile web add https://gitcode.com/foqiang/dsh-paperlens.git

配置說明¶

插件依賴 cordis.patch.yml 配置數據源。在 DSH 配置文件中插入以下內容：

- insert:
  - id: dsh-paperlens
    name: dsh-paperlens
    config:
      sources:
        openalex: { enabled: true, email: "you@example.com" }
        crossref: { enabled: true, email: "you@example.com" }
      defaultMaxResults: 20
      # libraryDir: 默認爲 ~/.dsh/paperlens/

注意：OpenAlex 使用郵箱註冊可提升 polite pool 優先級。

典型用法¶

檢索論文：在 DSH 會話中使用 paper_search 工具，指定關鍵詞進行跨源檢索。
生成引用：使用 paper_cite 工具，將論文 DOI 或 ID 轉換爲 GB/T 7714 等格式。
管理文獻：使用 paper_save 將論文存入本地庫，使用 paper_export 導出爲 BibTeX 格式供 LaTeX 使用。

適用場景與注意事項¶

數據隱私：數據僅經開放學術 API 傳輸，文獻庫存於本機 ~/.dsh/paperlens/library.db，無明文 API Key 必需，數據不出機器。
源限制：目前不包含需瀏覽器認證的源（如 CNKI、萬方、Scopus、ScienceDirect）。
KV Cache 影響：插件默認不注入任何模型可見上下文（無 systemPrompt section），僅在調用工具時產生一次性結果，對 KV cache 穩定前綴無影響，採用 append-only 會話記錄。

生態與許可¶

該項目受 PaperLens 工作流啓發，但代碼全部重寫。許可證爲 MIT 許可證。