前言¶

在 DeepSeek Harness（dsh）里做文献相关智能体时，常见做法是单独维护一份 HTML 精读报告、另找一套 ingest/build 脚本，再在 Web UI 里自己接路由或外链。报告浏览、PDF 入库、Agent 调用精读流水线、书库索引重建往往分散在多个目录和对话指令里。DSH-Paper-DeepRead 把「文献精读库」静态站点和 paper-deepread-html 技能打成一个可安装的 Web 插件：一次安装后侧边栏打开书库，模型侧有统一工具查文献、管上传与成稿，面板里还能上传 PDF 并配合 Agent 跑精读或对接独立站点做自动精读。

这是什么¶

DSH-Paper-DeepRead 由 HaoKuo 维护，在 SkillHub 上归类为「记忆」类插件。它解决的是：在 dsh Web 配置下，把预置的 deep-read 书库、生成报告的技能，以及上传/管理/检索能力收进同一个插件包，而不是自己拼静态资源和 skill 目录。

一次安装包含两块内容：

1. 文献精读库（Paper Deepread library） — 内置带交互式单页 HTML 报告的静态书库（README 中说明当前打包了 2025–2026 年间四篇示例文献，含 Nature Communications / bioRxiv / Anthropic · BigHat Biosciences 等来源）。插件通过 GET|HEAD /paper-deepread/* 托管 library/，默认入口为 /paper-deepread/index.html。
2. paper-deepread-html skill — 完整精读流水线（SKILL.md、build/ingest 脚本、报告与书库模板等）。若 ~/.dsh/skills/paper-deepread-html 不存在则安装；自 v1.2.0 起按 SKILL.md 的 version: 与内容哈希同步，用户改过的副本会保留，配置 skillSync: "keep" 可关闭更新。

插件还注册模型工具 paper_deepread（列文献、子串检索、读报告或 Web URL），以及 paper_deepread_uploads、paper_deepread_reports（驱动上传 → ingest → build 流程）。

核心功能¶

侧边栏与托管书库¶

• 左侧栏 Paper Deepread 入口，主面板全高展示书库页，支持新标签打开与刷新。
• 路由托管 bundled library/，处理 Content-Type、路径解码与目录遍历防护；无额外 npm 运行时依赖（主机侧为 Node 内置模块加 @deepseek-ai/dsh-tools peer）。

模型工具¶

• paper_deepread：返回 paper id、中英标题、期刊、标签、TL;DR、报告/PDF 绝对路径与编码后的 Web URL；支持在标题、摘要、全文等字段上做子串搜索。
• paper_deepread_uploads：list / ingest / env / delete 等，管理受管 inbox 中的 PDF。
• paper_deepread_reports：list / build / rebuild / delete / hide 等，组装或维护报告与书库索引。

插件本身不直接调用模型；上传页会给出预填指令，复制到对话里由 Agent 调用上述工具并执行 bundled skill。

面板三页：文献库 | 上传 | 报告管理¶

• 上传：拖拽或选择 PDF，写入 <dataDir>/uploads/<id>.pdf（默认 80 MB 上限，校验 %PDF- 魔数），可查看进度与状态并删除。
• 报告管理：表格中打开报告、隐藏/取消隐藏、删除报告目录；重建索引 用 build_library.py 确定性重建 index.html / index.md（不经过模型）。
• bundled 书库页头还有「上传」「管理」，对应自包含控制台 library/manage.html，在站点根或 /paper-deepread/manage.html 下均可通过相对 API 工作。

受管数据默认在 $DSH_HOME/paper-deepread（即 ~/.dsh/paper-deepread/）：

~/.dsh/paper-deepread/
├── library/          首次从打包书库 seed，之后归用户所有
├── uploads/          待精读的 PDF
├── work/<id>/        ingest 输出与 Agent 撰写的报告源
├── state.json        上传 inbox 与状态
├── skill-state.json  已安装 skill 版本与内容哈希（v1.2.0+）
└── .seed.json        一次性 seed 标记

报告状态大致为：uploaded -> ingested -> reported（失败时记 failed）。若配置 legacy 项 libraryDir，则以该目录为受管根且跳过 seed，可指向已有本地文献精读库。

技能版本同步（v1.2.0+）¶

读取 SKILL.md frontmatter 的 version:，在 <dataDir>/skill-state.json 记录哈希；仅更新插件当初安装且未被用户改动的副本，旧版备份到 <skillsDir>/.backup/，不降级。/api/state 与 paper_deepread 工具会报告 skillVersion / installedSkillVersion。

可选：自动精读（对接独立站点，v1.2.0+）¶

配置运行中的 Paper Deepread 站点（deploy/serve.py，README 要求站点 ≥ 1.4.0，含 /api/health 与上传 token、队列控制）后，上传 页顶部出现 自动精读 卡片：

config:
  siteUrl: http://127.0.0.1:8080

卡片每 8 秒通过插件代理查询 worker/队列/书库数量；PDF 经 POST /paper-deepread/api/site/upload 转发至站点（120 s 超时），重复上传、token、限流等反馈按站点 JSON 展示；上传 token 仅存在该页 sessionStorage，插件不持久化站点凭证。未配置 siteUrl 时仍可用「上传 + Agent 工具」路径独立完成精读。

环境与版本¶

许可证：MIT（package.json）。

安装与启用¶

从 GitHub Release 下载 dsh-paper-deepread-1.5.2.tgz，在 Web profile 下安装：

dsh plugin --profile web add ./dsh-paper-deepread-1.5.2.tgz

重启 Web UI：

dsh web

浏览器打开 http://127.0.0.1:3080，点击左侧 Paper Deepread。书库也可直接访问 http://127.0.0.1:3080/paper-deepread/index.html。更完整的验证与卸载步骤见仓库 docs/install.md。

典型用法¶

1. 浏览内置书库：侧边栏进入文献库，或新标签打开 /paper-deepread/index.html，阅读交互报告与原文 PDF。
2. Agent 检索某篇文献：在对话中让 Agent 调用 paper_deepread，按标题、期刊、标签或摘要搜索，再读取本地报告路径或 Web URL。
3. 上传并由 Agent 精读成稿：在 上传 页拖入 PDF，复制页内预填指令到对话；Agent 依次使用 paper_deepread_uploads（如 ingest）与 paper_deepread_reports（如 build），状态在 inbox 与报告管理中可见。
4. 维护书库索引：在 报告管理 隐藏/删除条目，或点击 重建索引；无需再跑模型。
5. 对接独立站点自动排队精读（可选）：本地或远程启动 Paper Deepread 站点，在插件配置中设置 siteUrl，在 自动精读 卡片上传 PDF，到 <siteUrl>/manage.html 查看队列与成稿。

适用场景与注意¶

适合：已在 dsh Web 环境做科研/文献类 Agent，希望书库、PDF inbox、精读 skill 与 UI 一体交付；或已有 paper-deepread-html 工作流，想减少手工同步 skill 与静态资源。

注意：

• 插件随当前 dsh 进程权限运行，安装前应阅读仓库源码与 MIT 许可证，确认数据目录与上传 API 符合你的安全策略。
• 自动精读依赖外部站点可用性与可选 upload token；插件不代替你保管站点凭据。
• SkillHub 目录页为社区生态索引，与 DeepSeek / 幻方无官方从属关系；安装包以 GitHub Release 与 README 为准，勿凭插件名拼接未在文档出现的 dsh plugin add github:... 命令。

结尾¶

DSH-Paper-DeepRead 把文献精读库、paper-deepread-html 技能、侧边栏管理与三类模型工具捆在一起：浏览、上传、Agent 精读、索引重建可以在同一 Harness 会话里完成；需要后台 worker 时再配 siteUrl 即可。更多信息见 SkillHub 目录页与 GitHub 仓库。

• 目录页：https://www.skillhub.cn/plugins/HaoKuo/DSH-Paper-DeepRead
• GitHub：https://github.com/HaoKuo/DSH-Paper-DeepRead