前言¶

在 DeepSeek Harness（DSH）裏做開發或跑智能體時，面板側欄常被各類插件佔用，但多半與「讀文檔」無關。若手頭有一批 EPUB、PDF 或掃描得到的教材資料，常見做法是另開一個閱讀器或瀏覽器標籤，與 Harness 上下文割裂，進度也不好和設備上的書庫統一。

下面介紹維護者 Lroyia 發佈的 dsh-book-reader（npm 包名 @lroyia/dsh-book-reader）。它是一個跑在 DSH 內的本地書籍閱讀器插件：指定本地目錄後遞歸掃描常見電子書格式，在面板裏建立書架並離線閱讀。文件始終留在本機磁盤，插件自述不復制、不上傳、不聯網。社區目錄 skillhub.cn 將其歸類爲「記憶」相關插件；GitHub 倉庫 Lroyia/dsh-book-reader 當前星標爲 0，許可證爲 MIT。

這是什麼¶

一句話定位：基於 DSH 開發的本地書架插件，在 Harness 面板中完成掃描、管理與閱讀。

宿主側（index.js）負責讀文件並註冊 /api/book-reader/* 路由；瀏覽器側（client.js）提供側欄圖標以及書架、掃描、閱讀三個界面，二者僅通過插件自有 HTTP 接口通信。

核心功能¶

本地掃描與書架¶

• 填寫本地文件夾絕對路徑（宿主提供原生選擇器時可點「瀏覽…」），遞歸查找 .epub、.txt、.pdf、.docx。
• 勾選後加入書架；入庫分批進行，界面會顯示進度。
• 書架記錄標題、作者、體積、格式、封面與閱讀進度，持久化在 ~/.dsh-book-reader/library.json。

閱讀與管理¶

• 閱讀器提供章節目錄、上下章切換、字號調節、護眼閱讀背景（經主題服務疊加 token，不影響頁面其餘部分），閱讀進度自動保存。
• 快捷鍵：← / → 翻章，Esc 回書架。
• 排序：按加入時間、最近閱讀、文件名，各支持正序／倒序，選擇會被記住。
• 分組：按文件夾、作者、格式（也可不分組），分組標題可摺疊。
• 搜索：按書名、作者或文件名即時過濾。
• 正文插畫按原位呈現；雙擊放大，滾輪縮放、拖動移動，點空白處或右上角關閉。封面在書架作縮略圖，封面與插畫緩存於 ~/.dsh-book-reader/cache/。

格式支持與邊界¶

README 中寫明的邊界包括：掃描件 PDF 無文字層時會提示不可提取文字（不做 OCR）；舊版二進制 .doc 掃描時跳過；部分 PDF 圖像編碼（如 JPEG 2000）會跳過。

插件強調 零第三方依賴：npm install 之後不需額外包；EPUB/DOCX 解壓、PDF 解析、圖片解碼均用 Node 自帶能力實現。

安裝與啓用¶

需要 DeepSeek Harness 0.2+（自帶 Node.js 22.12+ 運行時）。package.json 中當前版本爲 0.1.0。

從 npm 安裝（推薦）¶

圖形界面：插件頁 → 安裝插件 → 填入包名：

@lroyia/dsh-book-reader

命令行：

dsh plugin --profile desktop add @lroyia/dsh-book-reader

說明：dsh plugin 將參數轉交給 profile 目錄裏的 pnpm，因此任何 pnpm 能識別的安裝寫法均可使用。

裝完後在插件頁將「書架」啓用，左側欄會出現對應圖標。

典型用法¶

1. 點側欄「書架」圖標，點右上角 掃描文件夾。
2. 填入本地目錄絕對路徑，或通過「瀏覽…」選擇目錄。
3. 勾選要入庫的書，點 加入書架。
4. 點 開始閱讀；左側爲目錄，用 ← / → 翻章，Esc 返回書架。

數據、隱私與適用注意¶

插件只讀取已進入書架的文件，不會掃描未點名的目錄。接口帶同源迴環閘門，僅本機迴環且由瀏覽器發起的請求可進入。刪除整個 ~/.dsh-book-reader 目錄會清空插件數據，原始電子書文件仍在原路徑。

適用場景：希望在 DSH 同一界面裏管理並閱讀本地電子書、且接受以當前 DSH 進程權限讀盤的開發者或使用者。

安裝前建議：插件以 DSH 進程權限讀取你指定的路徑；安裝前應自行查看 GitHub 源碼 與 MIT 許可證，確認路徑與合規要求符合你的環境。DSH 生態主張「一切皆插件」；skillhub.cn 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-book-reader 把掃描、書架與閱讀收進 Harness 側欄，在完全本地的前提下覆蓋 EPUB / TXT / PDF / DOCX 四類常見格式，並自研 PDF 解析以儘量還原段落與插圖。若你需要在智能體開發環境中順手讀教材或文檔集，可按上文命令安裝啓用。

• 社區目錄：https://www.skillhub.cn/plugins/Lroyia/dsh-book-reader
• 源碼與說明：https://github.com/Lroyia/dsh-book-reader