前言¶
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 許可證。
