前言¶
在 DeepSeek Harness（DSH）里做研究或系统读论文，常见做法是本地 PDF 加笔记工具，再在侧边栏或外部窗口里和模型对话。PDF 高亮、结构化笔记、按论文维度的共读上下文，以及「一个课题下的多篇文献怎么串起来」，往往分散在不同应用里。下面介绍的 dsh-paper-desk（维护者 fexas）是 DSH 的客户端类插件：在侧边栏增加 Papers 入口，用三栏布局（左侧 DSH 侧栏、中间 PDF 或项目脑图画布、右侧 DeepSeek 对话 / Markdown 笔记本）把项目、文献、标注和 AI 笔记放在同一套界面里；数据以本地明文文件存放，不依赖独立数据库。项目 README 说明界面、AI 精读笔记与共读对话默认面向中文用户。
这是什么¶
dsh-paper-desk 的定位是：面向 DeepSeek Harness 的、形态接近 Zotero 的论文阅读工作台——支持 PDF 高亮、AI 精读笔记、共读对话，以及按项目维护的 React Flow 脑图。插件当前版本为 1.2.0（见仓库 package.json），许可证 MIT。社区目录页：skillhub.cn 插件页；源码与说明：GitHub fexas/dsh-paper-desk。
核心功能¶
以下能力均来自项目 README，按使用路径归纳。
项目与文献库¶
- 两类项目：Research（找问题、建方法、比 benchmark）或 Learning（概念依赖、时间线、阅读队列、回忆练习）。每个项目统一保存论文、标签、标注、对话、笔记与脑图。
- 拖入 PDF：上传、解析并按
Author et al. - Year - Title形式归档；标题、作者、年份来自 PDF 元数据与首页。 - 论文行（Zotero 式）：展开可见
paper.pdf、notes.md及附录等；额外文件原样存储、不解析。 - 打开阅读：点 Read，或在论文行非交互区域双击。
PDF 阅读与标注¶
- PDF.js 阅读器：适应宽度 / 缩放、翻页、可选文本、四色高亮、段落锚点笔记、选中翻译、对选中段落「问 AI」。
- AI 精读笔记：首次打开时由 DeepSeek 生成结构化 Markdown（TL;DR、核心问题、相关工作、方法动机与要点、实验阅读方式、优缺点与展望等）；右侧可编辑、预览、自动保存，并支持「AI 重写」。
- 共读对话：每篇论文独立 DeepSeek 会话，上下文包含正文、生成笔记、高亮与引用段落；会话持久化。
笔记、标签与检索¶
- 支持
$...$、$$...$$等数学公式（KaTeX）；代码片段与货币符号不被误渲染。 - Zotero 式标签芯片；可按多标签过滤，并搜索标题、作者、标签与笔记摘要。
项目脑图¶
- 每项目一份持久化
mindmap.json；Research / Learning 使用不同模板种子节点，均可编辑；整理布局 使用 dagre 自动排版。 - 从 论文库 点击或拖拽论文到画布；节点可关联论文、反向链接；右侧可在 对话（整图 + 文献元数据 + 可选选中节点交给 DeepSeek）与 节点（编辑标题、类型、Markdown、关联论文）之间切换。
数据形态¶
无数据库；目录结构示意如下（README 原文）：
paper-desk/
projects/
scaling-inference-for-sbi/
project.json
mindmap.json
mindmap-chat.json
papers/
kuhmichel-et-al-2026-high-dimensional-simulation-based-inference/
paper.pdf
paper.txt
notes.md
annotations.json
chat.json
attachments/
删除项目或论文会移入 projects/.trash/，而非直接抹掉。除模型请求外，PDF、文本与聊天记录留在本地。
环境与依赖¶
- DeepSeek Harness 0.2.x，需启用 Web GUI 并配置 DeepSeek 类 provider。
- 现代 Chromium 系 Web 渲染环境（含 DSH Desktop）。
- 插件使用当前 DSH profile 的 provider / model，不单独索要 API Key；未显式配置时会选用 profile 中第一条可用的 DeepSeek Flash / Chat 路由。
- 本地开发构建需 Node.js 22+（普通用户通过 DSH 安装托管包时无需自行
npm run build）。
安装与启用¶
在 DSH 中打开 Settings → Plugins，从 GitHub 安装 bundle fexas/dsh-paper-desk 并启用。若宿主提示安装新包后需重启，则重启 DSH。
可选配置写在 profile 的插件行（字段以 README 为准）：
- id: dsh-paper-desk
name: dsh-paper-desk
config:
provider: deepseek-account
model: deepseek-flash
# dataDir: /absolute/path/to/paper-desk-projects
数据目录默认位置¶
| 安装方式 | 默认 projects/ 位置 |
|---|---|
本地 file: 链接的 checkout |
<plugin-root>/projects/ |
托管插件（位于 node_modules） |
$DSH_HOME/paper-desk/projects/（常见为 ~/.dsh/paper-desk/projects/） |
可通过 config.dataDir 覆盖为绝对路径。
典型用法¶
- 安装并启用插件后，在 DSH 侧边栏进入 Papers，新建 Research 或 Learning 项目。
- 将 PDF 拖入项目，待解析完成后双击论文行或使用 Read 打开三栏阅读界面。
- 首次打开等待右侧生成 notes.md 精读笔记；在 PDF 中高亮、写段落笔记，必要时选中段落翻译或「问 AI」。
- 使用论文专属 共读对话 追问；标签与搜索用于在多篇文献间筛选。
- 在项目内打开 项目脑图，从论文库拖入节点，用 整理布局 排版；在脑图右侧用 对话 做课题或学习路径层面的讨论。
架构上，浏览器端 client.js（PDF.js、KaTeX、React Flow 等已打包）通过 RPC 访问宿主 paperDesk 命名空间读写 projects/ 下的 JSON 与 Markdown；浏览器不直接访问文件系统。
适用场景与注意¶
适合：已在 DSH 0.2.x 中使用 DeepSeek provider、希望把「文献库 + PDF 标注 + 结构化 AI 笔记 + per-paper 对话 + 项目级脑图」收拢到同一宿主界面、并愿意以本地文件夹作为唯一数据源的用户。
注意：
- DSH 社区插件目录（如 skillhub.cn）为独立生态站点，与 DeepSeek / 幻方无官方从属关系；安装前请自行审阅 源码 与 MIT 许可证。
- 插件以当前 DSH 进程权限运行，可读写你配置的
dataDir及上传的 PDF；仅向已配置的模型发起推理请求。 - README 截断处另含性能说明（如 PDF 分块并行加载）；若遇大文件或渲染问题，以仓库最新 README 与 Issues 为准。
结尾¶
dsh-paper-desk 把 Zotero 式文献管理与 DSH 侧栏、DeepSeek 精读笔记和共读对话、按项目的 React Flow 脑图叠在同一套客户端插件里，并用明文项目目录避免厂商锁定。进一步了解可访问 社区目录页 与 GitHub 仓库。
