前言¶
DeepSeek Harness（DSH）采用插件化架构。在开发智能体或处理文档时，开发者通常需要在本地阅读 PDF 并将其内容快速注入对话上下文。现有的文档查看方式往往与 DSH 的对话流割裂。dsh-book-reader 插件提供了一套内嵌的 PDF 阅读与标注方案，旨在将阅读过程与对话、笔记流程打通，减少手动复制粘贴的步骤。
插件定位¶
该插件由 davidwellscn-maker 维护，目前处于第一期 MVP 阶段。它基于 dsh-better-sidebar 扩展侧边栏，集成了开源 PDF 渲染库，为 DSH 提供基于 Web 的 PDF 阅读与标注能力。所有核心数据存储在本地，标注信息可跨会话持久化。
核心功能¶
-
内嵌 PDF 阅读器
插件在侧边栏新增「📚 读书」Tab。基于react-pdf-viewer渲染，支持翻页、缩放和页码显示。打开任意.pdf文件时，系统会自动调用该阅读器。 -
文字高亮与批注
选中 PDF 中的文字后，会显示浮动操作栏。- 高亮：点击高亮按钮，可选择添加批注内容，标注会以黄色高亮形式显示。
- 删除：再次点击高亮区域即可删除该标注。
标注数据会持久化保存。
-
对话集成
选中文字后，点击「📤 发到对话」按钮，选中内容会自动追加到 DSH 的输入框中。系统会自动附加当前 PDF 的文件路径和页码引用，便于在对话中精准定位原文。 -
状态检查
Tab 顶部提供实时状态条，显示插件加载状态或路由连通情况。
安装与启用¶
安装该插件需要使用 DSH Desktop 环境。安装完成后必须完全重启应用，以加载 Host 端新增的路由。
dsh plugin --profile desktop add github:davidwellscn-maker/dsh-book-reader
安装命令执行完毕后，请执行以下步骤启用插件：
1. 退出 DSH Desktop（快捷键 ⌘Q）。
2. 重新打开 DSH Desktop。
3. 打开任意 .pdf 文件，侧边栏会出现「📚 读书」Tab。
典型用法¶
- 阅读 PDF：在 DSH Desktop 中打开目标 PDF 文件，点击侧边栏的「📚 读书」切换视图。
- 添加批注：在 PDF 中选中一段关键文字，点击出现的「💛 高亮」按钮，输入批注内容并保存。
- 发送到对话：选中一段文字，点击「📤 发到对话」，光标会自动跳转到输入框末尾，内容已附带文件路径和页码。
注意事项¶
- 依赖项：该插件依赖
dsh-better-sidebar侧边栏服务。 - 路由加载：Host 端新增的路由需要在安装后重启 DSH Desktop 才能生效。
- 数据存储：标注数据保存在书籍目录下的
.book-reader/annotations.json文件中。 - 许可协议：遵循 MIT 许可证。
