前言¶

在 DeepSeek Harness（DSH）里读论文，常见做法是自行打开 PDF 或 TeX，再把片段贴进对话。路径、章节和页码往往要手工补全，笔记也容易和原文脱节。若希望论文库、章节导航、公式渲染和「选中即提问」留在同一套界面里，并让模型通过统一工具按章节检索、记笔记或整理审稿材料，需要把阅读流程做成插件而不是零散脚本。

下面介绍社区插件 dsh-paper-reader-studio（维护者 SpBs2004，分类：记忆）：在 Harness 左侧增加「论文」面板，并注册 paper 工具供对话调用。插件以 bundle 形式发布，MIT 许可；当前 package 版本为 0.2.1。生态上 DSH 主张「一切皆插件」，目录站点 SkillHub 插件页 与 GitHub 仓库为社区维护，与 DeepSeek / 幻方无官方从属关系。

这是什么¶

dsh-paper-reader-studio 给 Harness 装一个「论文」页：论文库 → 章节大纲 → 正文（.tex 经解析并用 KaTeX 渲染公式；.pdf 默认走 pdf.js 页面阅读）→ 笔记；支持中英对照、划选送入当前对话，以及模型侧 paper 工具（列库、大纲、按章节读、搜索、写笔记、审稿材料等）。

打开方式：左侧栏面板列表中的「论文」图标（paper-reader）。主界面为三栏：

论文库（根目录下拉 + ＋/⚙ 目录管理） │ 大纲 + 正文                    │ 笔记

核心功能¶

论文目录（面板管理，无需改配置）¶

左上角根目录栏右侧：

• ＋ 打开「论文目录」弹窗：输入或粘贴绝对路径，点「添加」。
• ⚙ 打开同一弹窗：查看各目录来源与论文数，逐项「×」移除。
• 「浏览…」优先调用宿主原生目录选择器；没有则直接粘贴路径。

目录来源分三种：工作目录（宿主默认，可移除）、配置默认（cordis.patch.yml 的 roots）、手动添加（面板里加的）。增删即时生效并持久化，不必重启或改配置文件。

状态文件默认位于 <DSH_HOME>/paper-reader/roots.json（Windows 上多为 C:\Users\<你>\.dsh\paper-reader\roots.json），只记录相对配置的 added / removed 增量；同一 profile 的会话共用这份列表。

三种用法¶

1. 读：左侧选论文 → 中间显示章节大纲与正文。.tex 保留行号；.pdf 默认进入页面阅读，也可切回文本模式。点大纲可跳转（PDF 到对应页）；标题栏 ↗ 在右侧预览中打开文件（.tex 跳到当前章行号）。
2. 问：正文或 PDF 页面中划选 → 浮条选「解释 / 质疑 / 审稿视角」→ 自动回到对话，提问携带论文路径、章节、页码与原文引用。「翻译」在浮层出译文；「摘录」写入论文同目录的 <论文>.notes.md。
3. 让模型用：对话中模型可调用 paper 工具，例如：

paper({ action: 'list' })
paper({ action: 'outline', path: 'D:/papers/.../x.tex' })
paper({ action: 'read', id: 'abc123', section: 'Convergence analysis' })
paper({ action: 'search', id: 'abc123', query: 'differential inclusion' })
paper({ action: 'note_add', id: 'abc123', note: { kind: 'question', text: '…', quote: '…' } })
paper({ action: 'review', id: 'abc123' })
paper({ action: 'bib', id: 'abc123' })

另有 notes_read、translate 等；note_add 是唯一写操作。模型侧还有 roots / root_add / root_remove，与面板共用同一套目录逻辑。

PDF 页面阅读¶

PDF 默认按原版页面渲染（连续滚动、懒渲染、工具栏翻页与缩放、TextLayer 支持划选提问并带 p.N）。每篇记住页码与缩放；大纲点击可跳页。标题栏「文本模式」可回到提取文本视图（可搜索、可复制、可中英对照）。pdf.js 动态加载，不打进首屏 client.js；宿主提供只读路由 /paper-reader/file 与 /paper-reader/static/pdfjs/…，根目录外文件 404。若出现「PDF 渲染失败：… 404」，通常需重启 Harness 或重新加载插件以加载新版宿主路由。

配置（cordis.patch.yml）¶

笔记格式¶

笔记为 <论文>.notes.md，追加写入，条目形如：

## 2026-11-03 18:40 · 摘录 · §3.2 · L412
> 原文引文……

笔记正文……

安装与启用¶

插件以 bundle 装入某个 profile：桌面版对应 desktop，dsh web 对应 web。较新的 dsh CLI 会拒绝直接操作 desktop profile（由 Electron 独占管理），桌面版请用方式一；命令行适用于 web / headless / 自建 profile。

安装前请知悉：插件在当前 dsh 进程权限下运行，可访问你配置的论文根目录；安装前应自行查看 GitHub 源码 与 MIT 许可证（vendor/pdfjs/ 为 Mozilla pdf.js，Apache-2.0）。

方式一：应用内安装（推荐；桌面版仅能如此）¶

在 DSH 会话中说：

安装插件 github:SpBs2004/dsh-paper-reader-studio

即调用：

plugin_manager(action="install_bundle", target="github:SpBs2004/dsh-paper-reader-studio")

本地开发可把 target 换成插件目录绝对路径，会以 link: 依赖安装。

方式二：命令行（web / headless / 自建 profile）¶

需与 Harness 版本一致的 dsh CLI 和 pnpm：

dsh plugin --profile web add github:SpBs2004/dsh-paper-reader-studio

命令行安装不会热加载，装完需重启对应 Harness 进程。确认：package.json 含 dsh-paper-reader-studio，且出现在 dsh.profile.bundles。

卸载与升级（git 依赖固定安装时 commit，升级先删再装）：

dsh plugin --profile web remove dsh-paper-reader-studio
dsh plugin --profile web add github:SpBs2004/dsh-paper-reader-studio

方式三：本机目录（开发）¶

dsh plugin --profile web add link:E:\path\to\dsh-paper-reader-studio

装完后刷新页面（Ctrl+R）。宿主半有路由等改动时需重载插件或重启 Harness。

典型用法小结¶

先做目录：面板 ＋ 添加本机论文绝对路径（或依赖 cordis.patch.yml 的 roots）。再选一篇 .tex 或 .pdf 读大纲与正文；划选后用浮条解释或摘录。需要模型批量处理时，在对话中让它 paper({ action: 'list' }) 后 read / search / review。PDF 全文查找可切文本模式，或用 paper 的 search。

适用场景与限制¶

适合：本机已有 TeX/PDF 论文目录，希望在 Harness 内统一浏览、记 .notes.md、并把带出处的选段送入对话；也让 agent 按章节读文献或出审稿摘要。

需注意（摘自 README）：

• PDF 页面阅读依赖宿主路由；升级宿主半后需重载插件。
• PDF 页面模式暂不支持全文查找；扫描版无文本层时划选无法带出可选中文本。
• 右侧 PDF 预览不支持跳到第 N 页；面板内页面阅读支持。
• 公式多为 KaTeX MathML；少数宏可能显示为等宽源码；定理编号与复杂 TeX 计数器可能和编译结果不完全一致。

结尾¶

dsh-paper-reader-studio 把论文库、大纲、KaTeX/PDF 阅读、选段对话和 paper 工具收进一个面板，目录可在 UI 里维护而不必频繁改配置。需要安装说明与细节时，以仓库 README 为准。

• 插件目录页：https://www.skillhub.cn/plugins/SpBs2004/dsh-paper-reader-studio
• GitHub：https://github.com/SpBs2004/dsh-paper-reader-studio