前言¶

在 DSH（DeepSeek Harness）里读论文，常见做法是先把 PDF 转成文本贴进对话，或依赖外部阅读器，标注和结论很难和智能体共用。换会话后，之前划过的段落、写下的判断往往要重新找一遍。维护者 jypjypjypjyp 的客户端插件 dsh-vibe-reading（Vibe Reading）把阅读界面放进 DSH 右侧边栏：PDF 按原样渲染，选中即可高亮与批注，论文级笔记与代码目录和 agent 跨会话复用，并通过 @ 与 vibe_reading 工具把论文上下文交给模型，而不是反复粘贴全文。

下面介绍插件定位、能力、安装步骤与典型用法；事实以 GitHub 仓库 README 与 package.json（当前版本 0.4.1）为准。

这是什么¶

dsh-vibe-reading 是归类为「客户端」的 DSH 插件，面向在 Web 配置下使用 DSH 的开发者与研究者。一句话：右侧边栏里的论文工作台——原样打开 PDF，读到的留下，AI 接着用。

插件声明依赖 dsh-better-sidebar（^0.28.2），阅读器入口挂在 better-sidebar 上；仓库采用 MIT 许可，随包内嵌 pdf.js 3.11（Apache-2.0，许可见 public/LICENSE-pdfjs.txt）。运行环境要求 Node.js >=20。

核心功能¶

阅读与标注¶

• 在侧栏中上传或拖拽导入 PDF；阅读器使用 vendored pdf.js 渲染，保留版式与字体。
• 选中正文可用浮出菜单做高亮与批注；面板分为 标注（挂在某页某段原文，第二行显示关联笔记）、笔记（论文级分块结论，可多条增删改）、代码（「开源仓库 / 本地复现仓库」两个页签，各有目录浏览）。

正文解析（两套引擎）¶

导入后默认静默用 markitdown 转一份 Markdown。「更多 → 解析正文（MinerU）」会中断该流程、改用 MinerU（需配置 Token），底部进度条显示进度。解析结果与原件分目录存放（见下文存储布局）。

与智能体协作¶

• 工具栏 </> 打开「代码」页；@ 把 /dsh-vibe-reading 与论文目录写入输入框，由 DSH skill 机制按需加载，而非把全文粘进对话。
• Host 侧提供 vibe_reading 工具：list 列库或读某篇全部标注与笔记；create / update / delete 管理页级标注；note / update_note / delete_note 管理论文级笔记；code 读写该论文关联的代码仓库路径。阅读器「AI 查找仓库」即引导 agent 走 code 相关动作。
• 插件在 apply() 中注册运行时 skill dsh-vibe-reading（工具清单、目录结构、何时写、每条多长等），规则强调：标注挂原文、笔记记判断，每条一句话不超过 40 字，只写结论与依据。

设置¶

工作目录、MinerU Token、模型、语言等统一在 DSH 左侧「插件」→ dsh-vibe-reading 详情页，由 DSH 自带设置表单渲染；阅读器内「设置」跳转到同一页。

存储与目录¶

• 内部库：~/.dsh/vibe-reading/（<uuid>.pdf 原件、<uuid>.json 元数据、settings.json）。
• 对外论文文件夹：~/.paper_reading/<论文名>/，含 pdf/、markdown/（可能带 images/）、remote/（开源实现）、local/（本地复现）；标注与笔记写入 notes.md，元信息在 meta.md。

其它行为¶

结构损坏的 PDF（如缺少 xref / %%EOF）打开时会说明，并提供「下载原件」「重试」，便于用外部工具修复后再导入；阅读器不尝试改写原件。

安装与启用¶

从 GitHub 安装（官方 README 命令）：

# 从 GitHub 安装
dsh plugin --profile web add github:jypjypjypjyp/dsh-vibe-reading

# 或在本地插件目录里 link 进去（开发调试）
dsh plugin --profile web add link:./projects/dsh-vibe-reading

装完后重启一次 dsh web（Host 路由在启动时注册）。重启后，右侧边栏的 + 中应出现「Vibe Reading」。

若当前 profile 未激活 dsh-better-sidebar，插件页可能出现「缺少依赖：右侧边栏」横幅；点「安装依赖」会执行 dsh plugin --profile <名字> add dsh-better-sidebar 并写入 dsh.profile.bundles，需再次重启。没有侧栏时插件仍会加载，但没有入口。

社区目录页：dsh-vibe-reading @ SkillHub。DSH 插件生态由社区站点与仓库自行维护，与 DeepSeek / 幻方无官方从属关系。

典型用法¶

1. 打开右侧边栏，点 +，选择「Vibe Reading」。
2. 点工具栏上传或拖入 PDF。需要 MinerU 解析时，在「⋯」或「更多」中选择「解析正文（MinerU）」，并在插件设置中配置 Token。
3. 阅读时选中文字使用浮出菜单做标注；在「笔记」栏整理论文级结论；在「代码」页维护 remote / local 仓库路径，或用「AI 查找仓库」让 agent 回填。
4. 对话里使用 @ 注入 /dsh-vibe-reading 与论文目录，或让模型调用 vibe_reading 列出、读取、创建标注与笔记。

适用场景与注意¶

适合谁：经常在 DSH Web 里读论文、希望 PDF 原样阅读且标注与 agent 共享的人；需要把论文与开源/本地复现代码目录一起管理的人。

权限与安全：插件以当前 dsh 进程权限 读写 ~/.dsh/vibe-reading/ 与 ~/.paper_reading/（及设置中的工作目录）。安装前建议浏览 源码 与 LICENSE；MinerU Token 等敏感项通过 DSH 秘密字段配置，勿写入公开文档。

依赖：Web 客户端插件；无 better-sidebar 则无 UI 入口，需按上文安装依赖。

结尾¶

dsh-vibe-reading 把「读 PDF、留标注、记判断、连代码」收进 DSH 右侧边栏，并用 skill 与 vibe_reading 工具把阅读成果交给后续对话复用。进一步了解请看 GitHub 仓库 与 SkillHub 目录页。