前言¶
在 Harness 里打开 PDF 做对照或审阅时，常见做法是整份丢给 Agent，或反复复制某段原文再写问题。段落一多，上下文容易散，Agent 也不容易对齐「第几页、哪一句、你要改什么」。下面介绍社区插件 PDF 批注（仓库 hybridIce/dsh-plugin-pdf-annotator）：在预览里拖选文字、逐条写批注或仅引用原文，攒够多条后一次性插入草稿或直接发送，每条都会带上文件路径、页码与选中文本。
这是什么¶
PDF 批注 是 DeepSeek Harness 的客户端插件，维护者为 hybridIce，在社区目录中归类为工作流。它替换（或并列于）文档预览头部的查看器：选中的句子在 PDF 上编号高亮，批注集中在下方列表，再与当前会话的 Agent 批量交互。批注保存在 Harness 本地应用存储，不会写回原 PDF。
当前 package 版本为 0.1.2，许可证 MIT。运行环境要求 Harness 0.2.1-rc.3 或更新的 0.2.x（engines.dsh 为 >=0.2.1-rc.3 <0.3.0）；Harness 仍处于开发预览阶段，后续接口变化可能影响兼容性。
核心功能¶
依据仓库 README，插件提供以下能力：
- 选句批注：拖选 PDF 文字，添加批注或选择「仅引用」原文。
- 高亮与定位：批注对应高亮与编号，可在列表中定位、编辑、删除。
- 批量发送：多条一次提交；Agent 确认接收后清除已发送项，失败时保留。
- 配合草稿：可将批注追加到输入框末尾（保留原有文字与引用），或只发送这批批注而不动其他草稿与附件。
- 本地保存：按会话与文件持久化；保存失败时提示并支持重试。
- 阅读工具：缩放、适应宽度、中英文界面，以及跨行文本整理。
发送给 Agent 的内容包含文件路径、页码、所选原文与你的批注。正在发送时新增或修改的批注会保留，供下一次提交。
安装与启用¶
安装前请知悉：第三方插件在当前 DSH 进程权限下运行，安装前应自行查看源码与许可证（本插件为 MIT，并随附 PDF.js 等第三方声明见仓库 THIRD_PARTY_NOTICES.md）。
在 App「发现」页安装¶
- 打开 插件 → 实验性插件 → 更多，启用 自定义插件索引（部分版本名称为 自定义插件市场）。
- 切换到 发现 → 添加索引源，粘贴：
https://raw.githubusercontent.com/hybridIce/dsh-plugin-pdf-annotator/main/index.json
- 选择 PDF 批注 · 社区插件 索引，打开 PDF 批注 卡片，点击 安装 并确认来源。
- 安装后启用插件；打开 PDF，在预览头部选择 PDF 批注 查看器。
索引支持中英文名称和介绍；添加一次后可从「发现」页浏览版本。已安装时卡片显示 已安装。
从 GitHub 安装¶
- 打开 插件 → 添加插件 → 安装第三方插件。
- 输入仓库地址：
https://github.com/hybridIce/dsh-plugin-pdf-annotator
- 安装后启用 PDF 批注；若应用提示重启，请先完成正在运行的任务再重启。
- 打开 PDF，在预览头部选择 PDF 批注 查看器。
仓库已包含编译产物，安装时无需手动构建。
从安装包安装¶
在 Releases 下载 dsh-plugin-pdf-annotator-0.1.2.tgz，保存到固定位置，在「添加插件」中输入该文件的完整路径。
完全退出桌面版后，macOS 可使用：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add /path/to/dsh-plugin-pdf-annotator-0.1.2.tgz
Web 版使用对应 profile，例如：
dsh plugin --profile web add /path/to/dsh-plugin-pdf-annotator-0.1.2.tgz
典型用法¶
- 打开 PDF，拖选一句或一段文字。
- 点击 添加批注，写下要求并保存；不需要评论时选择 仅引用。
- 继续选择其他位置，批注会汇总到列表。
- 选择提交方式：
- 插入输入框：批注追加到当前草稿，可补充总体要求后一起发送。
- 立即发送：只提交这批批注；输入框原有草稿和附件保留。
如需使用 Harness 内置 PDF 查看器，可在预览头部的查看器菜单中切换。
适用场景与注意¶
适合：逐段审论文档、合同或技术 PDF，希望 Agent 逐条看到「页码 + 原文 + 你的指令」，而不是一次粘贴大段无关上下文。
限制（README 说明）：
- 文字选择依赖 PDF 的文本层；无文本层的扫描件需先做 OCR。
- 批注不会写回 PDF，也不会自动跨设备同步。
- 需要密码的 PDF 暂不支持。
DeepSeek Harness 的生态理念是「一切皆插件」；社区插件目录（如 SkillHub 上的条目）为独立站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
