前言¶
在 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 / 幻方無官方從屬關係，並非官方應用商店。
