前言¶

在 DeepSeek Harness（DSH）里做文献综述，常见做法是让智能体联网搜索，或接一套依赖浏览器登录态、自动化下载的管线。前者往往停在零散链接与未核验的题录；后者又容易牵涉机构 SSO、风控与合规边界。若目标只是「多源检索 → 核验去重 → 一份能离线浏览、能点进官方页面的交付物」，需要把学术 preset、文献 MCP 与交付契约捆在一起。

dsh-scholar-digest 由维护者 LiYang-cyber 发布，分类为联网工具，当前 GitHub 星标为 1。插件版本 0.1.1，MIT 许可。下面介绍它是什么、如何安装，以及从检索到交付的典型步骤。

这是什么¶

一句话：dsh-scholar-digest 是 DSH 上的一个 bundle，同时提供「学术研究」agent preset 与 download-paper 技能——多源文献检索、元数据核验，以及 HTML / XLSX / BibTeX / RIS / arXiv 批量下载脚本组成的「五件套」离线交付。

知网部分在服务端把知网空间链映射到可打开主站（kns.cnki.net）的链接，不依赖浏览器端油猴跳转，也不在插件内处理登录或 cookie。

两件核心交付¶

学术研究 preset¶

新建会话时在 preset 选择器中选「学术研究」。preset 带上学术向 persona，并挂载文献数据源与常规工具：

• CNKI（经随插件安装的 servers/cnki-search MCP，路径由插件运行时解析，无需手写目录）
• arXiv
• PubMed / Europe PMC（经 npx 启动）
• Semantic Scholar

检索侧工具名形如：mcp__cnki__search、mcp__arxiv__*、mcp__pubmed__*、mcp__semantic-scholar__*。

download-paper 技能¶

技能约定「一个专题 = 一个交付目录」。在同一份归一化条目上生成：

• 文献下载索引（HTML）
• 表格（xlsx）
• 文献清单（BibTeX、RIS）
• 批量下载 arXiv 的 PowerShell 脚本

并带来源追溯与交付自检说明（见 skills/download-paper/AGENTS.md）。

全文 PDF 是否可下，仍取决于机构 IP 或你在知网、出版商官方页面的登录状态；HTML 索引负责按主题分组摆好「点哪里」，不自动绕过访问控制。

工作流概览¶

研究主题
   │  preset：CNKI（主站链接）+ arXiv + PubMed + Semantic Scholar
   ▼
候选条目 ── 去重（DOI / arXiv ID / PMID / S2 ID / kns 主站 URL）── 核验 ── 分级
   │  skill：同一份条目数据
   ▼
<项目>/<专题>/  文献下载索引.html · 表格.xlsx · 文献清单.bib · 文献清单.ris · 批量下载_arXiv.ps1
   │  过程产物（检索记录、DOI 对照、知网条目清单）
   ▼
<项目>/_archive/<专题>/

去重与分级在 preset 检索之后、技能生成交付之前完成，避免同一文献在多份导出格式里口径不一致。

安装与启用¶

前置环境¶

• DeepSeek Harness 0.2.2-rc.1 及以上（engines.dsh 要求 >=0.2.2-rc.1 <0.3.0-0）
• uv（CNKI / arXiv / Semantic Scholar 源）
• Node.js >= 20（PubMed 源）

插件以当前 DSH 进程权限运行；安装前宜浏览仓库源码与 MIT 许可证，确认与本地合规要求一致。

安装命令¶

# npm 安装（推荐）
dsh plugin --profile desktop add dsh-scholar-digest

# 或从 GitHub 安装
dsh plugin --profile desktop add github:LiYang-cyber/dsh-scholar-digest

# 卸载
dsh plugin --profile desktop remove dsh-scholar-digest

装好后重启或重载应用：preset 选择器会出现「学术研究」，技能目录会出现 download-paper。

若你曾在 cordis.patch.yml 里手动定义过同名 preset（id: academic），需先删除该段再装插件，否则会 preset id 冲突。

典型用法¶

1. 新建会话，preset 选「学术研究」。
2. 建专题目录：<项目>_archive 与 <项目>\<专题名>\；可用 scripts/new-topic.ps1 建骨架，也可手建。
3. 用 preset 内 MCP 工具检索候选文献。
4. 按 skills/download-paper/AGENTS.md 第 3 节生成五件套。
5. 打开 HTML 索引，在官方页面完成 PDF 下载；交付前按 AGENTS.md 第 4 节自检。

将已有 xlsx 总表转为 HTML / RIS / arXiv 脚本时，可用技能自带的生成器（路径中的 <插件目录> 换成本地安装位置）：

uv run --with openpyxl python "<插件目录>\skills\download-paper\build_delivery.py" "<项目>\<专题>"

仓库 examples/demo-topic/ 提供虚构数据的完整交付示例，可直接打开 文献下载索引.html 查看形态。重新生成示例数据：

uv run --with openpyxl python examples/build_demo_dataset.py
uv run --with openpyxl python skills/download-paper/build_delivery.py examples/demo-topic

适用场景与注意¶

适合谁： 需要在 DSH 会话里做多源文献检索、题录去重，并希望输出可归档、可引用的 BibTeX/RIS 与离线 HTML 索引的个人或小团队研究者；知网使用场景限于公开检索与合规范围内的机构访问。

与常见路线的差异： 已有方案多走 CDP/Playwright、机构 SSO 或中继账号的自动下载。本插件刻意不碰登录态、不做风控对抗，只做链接映射与交付打包。CNKI 服务端基于 Biogod2020/cnki-search 并增加链接换算层。

已知限制（README 原文）：

• 四个文献 MCP 进程随 DSH 启动常驻，与当前会话是否选中该 preset 无关。
• 知网服务端走知网空间公开接口，覆盖空间题录，不是 KNS 全部馆藏。
• 主要在 Windows + DSH 0.2.2-rc.1 上实测；其他平台脚本虽按跨平台写法，未验证。
• arXiv 批量脚本内置约 3 秒请求间隔，不宜擅自改短。

合规： 不内置 cookie/token，不模拟登录；检索请遵守各数据源使用条款，勿用于批量抓取或再分发全文。

不装完整插件、仅想把 preset 写入 profile patch 时，可用 preset/gen-preset.py 手动生成 patch；此时技能需单独放进项目 .agents\skills\download-paper，且勿与插件版同名 preset 同时启用。

结尾¶

dsh-scholar-digest 把学术 preset、四路文献 MCP（含知网主站链接映射）与 download-paper 五件套交付绑在一个 DSH 插件里，适合把「找文献」和「整理成交付目录」放在同一条可复现工作流中。DSH 社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

• 目录页：https://www.skillhub.cn/plugins/LiYang-cyber/dsh-scholar-digest
• GitHub：https://github.com/LiYang-cyber/dsh-scholar-digest