dsh-paperforge：在 DSH 里读论文：边读、边问、边记

前言¶

在 DSH 中开发智能体时，阅读技术论文并整理笔记是常见的高频动作。现有的做法往往需要切换应用，将阅读器与对话、笔记工具割裂。dsh-paperforge 插件通过将 PDF 论文库、专属 AI 会话与本地 Markdown 笔记整合，解决了“边读、边问、边记”的需求，让思考过程直接沉淀在 DSH 的工作流中。

这是一个记忆类插件，由 PhysicalAI-0 维护。它允许你在 DSH 网页界面中列出并阅读工作区里的 PDF，通过划词、截图等方式生成笔记，并在专属会话中向 AI 追问。

核心功能¶

插件主要提供以下能力：
1. 论文库：在左侧栏列出工作区内的 PDF 文件，点击即可进入阅读布局。
2. 标注：支持划词高亮（六色）和框选截图，选中的内容会自动写入笔记目录。
3. Ask AI：在选中段落或页头使用 Ask AI，问题会自动带上 @论文、页码与选段上下文，发送给本篇论文的专属会话。
4. Markdown 编辑：支持块级编辑，点击即可修改源码，离开即自动保存。插件与 AI 的改动会自动合并。
5. Summary：在论文库的会话页签中勾选多个会话，AI 会将其汇总成一份 Markdown。
6. 复制路径：在任意文档页头点击复制图标，可快速获取文件路径。

安装与启用¶

确保你的 DSH 版本为 0.1.7+，且 PATH 中包含 pnpm。

使用官方安装命令添加插件：

dsh plugin --profile web add github:PhysicalAI-0/dsh-paperforge

安装后，在存放论文的目录启动 dsh web，左侧栏会出现「论文」入口。若需卸载，执行：

dsh plugin --profile web remove dsh-paperforge

配置与用法¶

插件提供少量配置项，可覆盖默认行为。在 ~/.dsh/profiles/web/cordis.patch.yml 中添加：

- id: paperforge
  config:
    workspaceRoot: <论文目录的绝对路径>   # 缺省 = 启动 dsh web 的目录
    notesDir: paperforge_notes          # 笔记根目录名
    model:                              # 论文会话用的模型
      provider: deepseek-official
      name: deepseek-flash
      reasoningEffort: high

典型工作流如下：
1. 启动 dsh web，在论文目录下点击左侧「论文」。
2. 选中段落，使用 Ask AI 向 AI 追问，上下文会自动带上论文引用。
3. 划下重要文字和图表，自动收进笔记；勾选会话生成 Summary。
4. 需要时，配置 workspaceRoot 或 notesDir 调整存储位置，或配置 model 指定论文会话的模型。

注意事项与限制¶

1. 界面限制：右侧栏最多两栏（DSH 限制），如需更多窗口请拖成浮动。
2. 编辑限制：Markdown 按块编辑，撤销只在当前块内生效；跨块的引用式链接与脚注可能不生效。
3. Summary 限制：DSH 每条消息最多引用 3 个会话，插件会分批发送。
4. 同名文件冲突：不同目录下的同名 PDF 会共用一个笔记文件夹。
5. 权限运行：插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

结语¶

dsh-paperforge 通过将阅读、对话与笔记一体化，适合需要在 DSH 中深度研究论文的开发者。更多细节与源码请参考 GitHub 仓库。