前言¶

在 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