literaf/dsh-ai4scholar · 上手攻略

  • 仓库：literaf/dsh-ai4scholar
  • 链接：https://github.com/literaf/dsh-ai4scholar
  • 分类：academic-literature / research-tool / deepseek-harness-plugin
  • 作者：Tom
  • 更新：2026-08-18

是什么

dsh-ai4scholar 是 DeepSeek Harness（dsh）的官方学术文献插件，提供 38 个原生 Agent 工具，覆盖文献检索、全文获取、引用管理、科学图表生成等科研写作全流程。

它本质上是一个 Node.js 包（dsh 插件），安装后在 dsh web 界面中注册 38 个工具，并通过 ai4scholar.net 的 API 接入 Semantic Scholar（2 亿+ 论文）、PubMed、Google Scholar、arXiv、bioRxiv / medRxiv 等学术数据库，以及 DOI 全文获取和 auto_cite / sci_draw 写作辅助功能。MIT 许可证。

解决什么问题

大模型 Agent 做学术研究时最大的痛点是没有可靠的文献工具接口：需要自己去写爬虫 / 找 API / 处理各种数据库的认证和格式不一致问题。

dsh-ai4scholar 把这些全部封装成标准化的 Agent 工具，让 DeepSeek 模型（或接入 dsh 的任意模型）直接调用：搜文献、下载 PDF、读全文、批量获取作者信息、自动生成带 BibTeX 的引用、画科学图表。工具之间可链式调用，输出格式统一，不必为每个数据库单独写适配代码。

快速安装

前置依赖

  • Node.js ≥ 22.19（或 ≥ 24）
  • pnpm（dsh 使用 pnpm 管理插件）
  • DeepSeek Harness（dsh）
# 1. 确认 Node.js 版本
node -v

# 2. 安装 pnpm（如未安装）
npm i -g pnpm

# 3. 全局安装 DeepSeek Harness
npm i -g @deepseek-ai/dsh
dsh --version

# 4. 安装本插件（web profile）
dsh plugin --profile web add dsh-ai4scholar

# 5. 启动 dsh web
dsh web
# 输出：http://127.0.0.1:3080

# 6. 在浏览器中配置（首次）
# Settings → Models → 填入 DeepSeek API Key（platform.deepseek.com）
# Settings → Plugins → AI4Scholar → 填入 AI4Scholar API Key（ai4scholar.net）→ Save

⚠️ 中国大陆用户注意：插件发布后会同步推送到 npmmirror，国内默认 npm 源可在 1 分钟内获取最新版本。如遇网络问题，确认 npm registry 指向淘宝 / npmmirror。

升级插件

# 升级到最新版本
dsh plugin --profile web add dsh-ai4scholar@latest
# 然后重启 dsh web

核心用法

基础文献检索

dsh 启动后，在 Web UI 的对话框中直接用自然语言提问，模型会自动调用对应工具：

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

（模型会自动拆解：search_semantic + search_pubmed + 去重合并 → 返回带 DOI 和引用数的文献列表）

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.

批量获取论文详情

# 通过 dsh web UI / CLI 调用，或在 Code Mode 中使用工具链：
# search_semantic_bulk: 批量查多篇论文的详情
# get_semantic_author_papers: 查某作者所有发表
# get_semantic_citations / get_semantic_references: 引用图

全文获取

# 通过 DOI 下载任意论文（有机构访问权限时）
download_by_doi   # 下载 PDF
read_by_doi       # 读取 PDF 全文（按 offset/max_chars 分片，40 页论文不会撑爆 context）

# 通过 arXiv ID
download_arxiv
read_arxiv_paper

# 通过 bioRxiv / medRxiv
download_biorxiv / download_medrxiv
read_biorxiv_paper / read_medrxiv_paper

⚠️ 付费墙内论文：只有在机构网络下运行 dsh 才能下载；非机构网络会返回着陆页提示手动获取。

自动引用生成

auto_cite

在写作中调用此工具，自动插入真实引用 + 参考文献列表 + BibTeX 条目。调用记录和费用（credits）在工具卡片标题中显示。

科学图表生成

sci_draw

生成 / 编辑 / 美化 / 组合 / critique / SVG 导出科学图表，支持矢量格式输出。

余额查询

/ai4scholar balance

显示当前账号剩余 credits、详细消费分解、会员状态。

CLI / Headless 模式下的 API Key 配置

Headless 模式没有 Settings 页面，API Key 通过环境变量注入：

# 方式一：环境变量（最高优先级）
export AI4SCHOLAR_API_KEY=<your-key>

# 方式二：写入 credentials 文件
# 文件路径：$DSH_HOME/.credentials.yaml
# 格式：ai4scholar_api_key: <your-key>

# 方式三：在项目 .env 或 $DSH_HOME/.env 中配置

验证配置是否生效：

dsh --profile web --dump-config
# 输出包含 # == dsh-ai4scholar == 部分即表示插件已加载

工具速查表

类别 工具 计费
综合搜索 search_papers（一次查全平台、去重） per platform
Semantic Scholar search_semantic、get_semantic_paper_detail、get_semantic_citations、get_semantic_references、get_semantic_author_papers、download_semantic、search_semantic_authors、get_semantic_recommendations、read_semantic_paper 等 15 个 credits
PubMed search_pubmed、get_pubmed_paper_detail、get_pubmed_citations、get_pubmed_related credits
Google Scholar search_google_scholar credits
arXiv search_arxiv、download_arxiv、read_arxiv_paper 免费
bioRxiv / medRxiv search_biorxiv、search_medrxiv、download_*、read_* 免费
DOI download_by_doi、read_by_doi 免费
写作 auto_cite、sci_draw credits
账户 get_ai4scholar_credits 免费

免费工具：arXiv、bioRxiv、medRxiv、DOI 相关工具均不扣 credits，是最经济的批量获取渠道。

典型适用场景

  1. 系统文献综述：一次 search_papers 跨 Semantic Scholar + PubMed + Google Scholar 并行检索，按 DOI/arXiv/PMID 去重，10 分钟完成初筛。
  2. 追踪某领域最新进展：按年份或引用数排序，自动下载 arXiv PDF 并分片读取全文，不超 context。
  3. 学术写作引用管理：完成论文后调用 auto_cite，自动生成符合期刊格式的参考文献列表和 BibTeX。
  4. 图表快速生成：用 sci_draw 生成论文figure草图，直接嵌入文档。
  5. 机构网络远程访问：在 VPN 环境下运行 dsh，付费墙论文也可通过 DOI 下载。

坑与注意

  1. 需要两个 API Key：DeepSeek API Key（platform.deepseek.com）和 AI4Scholar API Key（ai4scholar.net），缺一不可。
  2. Credits 有限：Semantic Scholar / PubMed / Google Scholar 调用按次扣费；免费工具（arXiv、bioRxiv、DOI）无限制，建议优先使用免费渠道做批量初筛。
  3. PDF 全文提取依赖 pdf-parse：扫描版（纯图片）PDF 无法提取文字，会显式报错，不要误以为是网络问题。
  4. 全文分片读取：40+ 页论文默认分片输出（readMaxChars=60000），长文献需要多次调用 offset 参数翻页。
  5. 模型选择影响工具调用效率：建议使用 DeepSeek V3 / R1 等较强模型以保证工具链编排质量。
  6. Session 余额不持久：credit tally 是进程级的，dsh 重启后清零；余额本身（get_ai4scholar_credits）始终从 API 实时查询，不受重启影响。
  7. 国内网络：如 ai4scholar.net 访问不稳定，可尝试科学上网；插件本身在中国大陆 npm 生态内发布，网络问题通常在 dsh 的 API 调用层面。

与同类对比

| | dsh-ai4scholar | Semantic Scholar API（官方） | Connected Papers | Elicit | |---|---|---|---| | 工具数量 | 38 个（整合型） | 单一 API | 单一 Web | 单一 Web | | Agent 集成 | ✅ 原生 | ❌ 需自己写 | ❌ | ❌ | | 多平台统一 | ✅ Semantic + PubMed + GS + arXiv 一次查 | ❌ 各自独立 | ❌ | ❌ | | 全文获取 | ✅ DOI / arXiv / bioRxiv | ❌ | ❌ | 部分 | | auto_cite | ✅ | ❌ | ❌ | ❌ | | 费用 | AI4Scholar credits | 官方免费（限流） | 免费 | 付费订阅 |

dsh-ai4scholar 的优势是Agent 原生集成和多平台统一接口，最适合需要把文献工具链式编排进自动化研究流程的场景。

一句话推荐结论

dsh-ai4scholar 把 38 个学术工具打包成一个 dsh 插件，让 DeepSeek 模型直接调文献、调全文、自动引用——做系统综述或需要频繁跨库查文献的科研工作者，这是目前集成度最高的开源方案；免费工具（arXiv/bioRxiv/DOI）不花 credits，值得优先利用。