前言¶

在 DeepSeek Harness（dsh）裏做文獻調研，常見做法是手動打開 Semantic Scholar、PubMed 或 arXiv，把標題、摘要複製回對話，再讓模型歸納。跨平臺檢索時還要自己合併重複條目、對齊 DOI 與引用格式，步驟分散，上下文也容易被打滿。

下面介紹的 dsh-ai4scholar（維護者 literaf，GitHub 倉庫 literaf/dsh-ai4scholar）把學術檢索能力做成 dsh 原生 agent 工具：一次安裝後，模型可直接調用 Semantic Scholar、PubMed、Google Scholar、arXiv、bioRxiv/medRxiv、DOI 解析等接口，並支持全文閱讀、自動引用與科研繪圖。後端由 ai4scholar.net 提供，與 OpenClaw、Codex、Hermes 上的 AI4Scholar 插件覆蓋同一套能力。

這是什麼¶

dsh-ai4scholar 是面向 DeepSeek Harness 的聯網類插件（npm 包名 dsh-ai4scholar，當前版本 v0.3.3，MIT 許可證）。它以 38 個原生工具的形式接入 dsh，覆蓋文獻檢索、詳情與引用關係、PDF 全文、自動引用（auto_cite）以及科研圖（sci_draw）。

所有返回論文列表的工具使用統一記錄結構（標題、作者、年份、venue、引用數、DOI/PMID/arXiv ID、URL、開放獲取 PDF、摘要），便於模型在不同平臺間串聯調用。全文類工具按 offset / max_chars 分片返回 PDF 文本，避免長文撐爆上下文；計費工具的結果會在 Web UI 中以引用卡片展示，並附帶 credits 消耗信息。

核心功能¶

統一檢索¶

search_papers 可一次查詢橫跨 Semantic Scholar 與 PubMed（可選 arXiv、Google Scholar），按 DOI / arXiv ID / PMID / 標題去重，多平臺命中的條目優先排序。

按平臺拆分的工具族¶

Semantic Scholar 側工具包括 search_semantic、search_semantic_bulk、search_semantic_snippets、get_semantic_citations、get_semantic_references、read_semantic_paper 等；PubMed、arXiv、bioRxiv/medRxiv 各有對應的 search / get / download / read 工具，完整列表見 GitHub README。

Credits 可見¶

計費工具在聊天卡片標題中顯示本次消耗與剩餘額度（例如 Semantic Scholar: protein folding · 10 credits · 4,990 left）。模型側結果末尾附帶 AI4Scholar credits — this call: … · this session: … · remaining: …。/ai4scholar 命令渲染餘額卡片；get_ai4scholar_credits 向模型返回相同數字。arXiv、bioRxiv/medRxiv、DOI 相關免費工具不顯示 credits 行。

安裝與啓用¶

環境要求：Node.js ≥ 22.19（或 ≥ 24）、pnpm，以及已全局安裝的 dsh。

# 0. 檢查 Node 版本
node -v
npm i -g pnpm                     # 若已安裝可跳過

# 1. 安裝 DeepSeek Harness
npm i -g @deepseek-ai/dsh
dsh --version

# 2. 安裝插件（Web 配置檔；無頭 CLI 用 --profile headless）
dsh plugin --profile web add dsh-ai4scholar

# 3. 啓動 Web UI
dsh web                           # 默認 http://127.0.0.1:3080

啓動後在瀏覽器中完成一次性配置：

1. Settings → Models — 填入 DeepSeek API Key（platform.deepseek.com）。
2. Settings → Plugins → AI4Scholar — 填入 AI4Scholar API Key（ai4scholar.net）並保存。密鑰寫入 dsh 憑證存儲（$DSH_HOME/.credentials.yaml，權限 0600），保存時通過插件路由 GET /ai4scholar/balance 校驗，下一筆工具調用即生效，無需重啓。

無 Web 設置頁時（如 headless），可通過環境變量或文件注入密鑰，優先級從高到低：export AI4SCHOLAR_API_KEY=… → $DSH_HOME/.credentials.yaml → 項目或 $DSH_HOME 下的 .env。可用 dsh --profile web --dump-config 查看 # == dsh-ai4scholar 配置段。

升級插件：

dsh plugin --profile web add dsh-ai4scholar@latest

然後重啓 dsh web。發佈後會同步到 npmmirror，國內默認 registry 通常在約一分鐘內可拉到新版本。

典型用法¶

選好工作區文件夾後，直接用自然語言提問。README 中的示例如下：

Find recent papers on CRISPR base editing for sickle cell disease and compare their delivery methods.

Search PubMed for GLP-1 receptor agonists and cardiovascular outcomes since 2022, sorted by date.

Which paper is “Attention Is All You Need”? Give me its DOI and citation count.

模型會根據任務自動選用 search_papers、search_pubmed、search_semantic 等工具；需要全文時調用 read_arxiv_paper、read_by_doi 等，並受 readMaxChars（默認 60000 字符）限制。寫稿階段可讓模型調用 auto_cite 生成帶 BibTeX 的引用列表。

斜槓命令 /ai4scholar 可隨時查看當前賬戶餘額、會員狀態與會話消耗。

配置項¶

插件在 profile 中掛載爲 id: ai4scholar。默認值可通過 cordis.patch.yml 覆蓋（patch 會替換整個 config，保留的鍵需全部寫出）：

- id: ai4scholar
  config:
    apiKeyEnv: AI4SCHOLAR_API_KEY
    baseUrl: https://ai4scholar.net
    semanticScholar: true
    pubmed: true
    googleScholar: true
    arxiv: true
    biorxiv: true
    doi: true
    fullText: true
    autoCite: true
    sciDraw: true
    creditsTool: true
    command: true
    balanceRoute: true
    showCredits: true
    defaultMaxResults: 10
    maxResultsCap: 50
    abstractMaxChars: 600
    readMaxChars: 60000

可按需關閉某一平臺或功能族（例如僅保留 arXiv 與 DOI），減少模型可見工具面。

適用場景與注意¶

適合誰： 在 dsh 裏做系統性文獻調研、跨庫比對、讀開放全文、整理引用或生成科研示意圖的研究者與開發者。需要 Google Scholar 引用數或 Semantic Scholar 引用圖時，需準備 AI4Scholar API Key 並關注 credits 消耗；純 arXiv / 預印本 / DOI 開放獲取場景可使用免費工具族。

運行權限： 插件以當前 dsh 進程權限運行，可訪問網絡與本地工作區。安裝前建議閱讀 源碼 與 MIT 許可證，確認工具調用範圍符合你的安全策略。

生態說明： DeepSeek Harness 採用「一切皆插件」架構；SkillHub 等社區目錄由第三方維護，與 DeepSeek / 幻方無官方從屬關係。本插件依賴 ai4scholar.net 後端，部分能力按平臺計費，免費平臺無需 API 額度即可使用檢索與閱讀類工具。

結尾¶

dsh-ai4scholar 把分散在多站的學術檢索、全文閱讀、引用生成和繪圖能力收斂爲 dsh 內 38 個可編排工具，統一數據結構，並在 UI 層透明展示 credits。若你已在用 DeepSeek Harness 做研究輔助，可按上文步驟安裝並配置 API Key 後直接在工作區對話中使用。

• 社區目錄：skillhub.cn/plugins/literaf/dsh-ai4scholar
• 源碼與文檔：github.com/literaf/dsh-ai4scholar