前言¶
在 DSH（DeepSeek Harness）裏做開發或長會話時，技術文檔、電子書常常散落在磁盤各處。用系統自帶閱讀器切窗口，和 Web 工作區裏的對話、工作區文件很難對齊；把書當成普通附件上傳，既不符合「本地庫」的用法，也不便保存進度與書籤。
dsh-bookshelf 是面向 DSH Web 界面的客戶端插件：在左側邊欄增加 Bookshelf，在主面板提供書架網格，並內置 PDF.js 與 EPUB 閱讀器；閱讀數據落在本機 $DSH_HOME/bookshelf，重載頁面或重啓後仍可恢復。下面介紹它是什麼、能做什麼，以及如何安裝與使用。
這是什麼¶
- 名稱：dsh-bookshelf（GitHub：
Chriszzx/dsh-bookshelf，維護者 Chriszzx） - 分類：客戶端插件（
dsh.client.platform爲web，向 Web GUI 注入ui-bookshelf等能力） - 許可：MIT（
package.json標註版本0.3.0） - 一句話：面向 DeepSeek Harness Web GUI 的本地 PDF/EPUB 書架，帶內置閱讀器與本機 Books 右側邊欄能力（見項目簡介與 README）
插件不採集遙測、不上傳書籍；刪除書架條目不會刪除你鏈接或導入的原始文件。
核心功能¶
資料中已覈實的能力如下。
導入與書架¶
- Import books 菜單：
- Import book files…：文件選擇器或拖拽，將文件複製進書架（不刪除原件）。
- Link a folder…：對文件夾做軟鏈接納入書架；Windows 在無符號鏈接權限時改爲分階段複製並標記爲 copy。
- Apple Books import（僅 macOS）：搜索本機書庫並鏈接已下載的 EPUB/PDF；EPUB 源目錄可按需打包。
- Shelf：封面網格、搜索、排序、重命名、刪除。
閱讀器¶
- PDF.js：適應頁寬/頁面/自定義縮放，單頁或連續滾動，頁書籤，進度恢復。
- EPUB：分頁或滾動、目錄、版式、明/暗主題、自動雙頁、全屏、書籤、進度恢復。
與對話、工作區聯動（EPUB）¶
Page discussion：將當前可見頁捕獲到所選工作區下的 .dsh-bookshelf/<id>.md，打開帶 @file 草稿的原生會話（默認不發送消息），並在靜態 Books 右側邊欄標籤中展示該頁。
界面與數據¶
- 中英文界面。
- 庫、封面、進度、書籤與默認項存放在：
$DSH_HOME/bookshelf/{library.json,books,state.json,defaults.json,covers}
切換面板可保留當前打開的書、搜索/排序與滾動位置；整頁刷新後回到書架視圖，閱讀進度仍保留。
安裝與啓用¶
環境要求¶
README 與 package.json 一致要求：
- DSH：
>=0.2.0-rc.2且<0.3.0 - Node：
^22.19.0 || >=24.0.0 - 官方 bundle 平臺：
darwin、win32（macOS 或 Windows）
安裝前請確認本機 DSH 與 Node 版本滿足上述範圍；插件以當前 DSH 進程權限訪問文件系統，安裝前建議瀏覽源碼與 MIT 許可證。
從 GitHub 安裝¶
dsh plugin --profile web add github:Chriszzx/dsh-bookshelf
bundle 會插入 ui-bookshelf；替換客戶端文件後需重新加載 Web 頁面。
若使用本地檢出目錄（非本文推薦路徑，僅摘自 README）：
dsh plugin --profile web add /absolute/path/to/dsh-bookshelf
典型用法¶
- 在側邊欄打開 Bookshelf，進入 Import books。
- 按需選擇：
- Import book files… — 選一個或多個 EPUB/PDF，或直接拖到書架上。
- Link a folder… — 選文件夾，預覽其中的書，以軟鏈接（或 Windows 回退複製）加入書架。
- Apple Books（macOS）— 搜索本機書庫並鏈接已下載的書。 - 在書架網格中打開書，使用內置閱讀器閱讀；EPUB 需要討論當前頁時，使用 Page discussion 在工作區生成 Markdown 並打開會話草稿。
進度與書籤保存在 Host 側，而非瀏覽器臨時存儲。
平臺與注意事項¶
README 平臺表摘錄如下（Linux 未聲明書架與閱讀器支持）：
| 平臺 | 書架 + 閱讀器 | 文件導入 | 文件夾鏈接 | Apple Books |
|---|---|---|---|---|
| macOS | 是 | 是 | 軟鏈接 | 是 |
| Windows | 是 | 是 | 需開發者模式等權限，否則複製 | 否 |
| Linux | 未聲明 | — | — | 否 |
Windows 文件夾鏈接：需要 SeCreateSymbolicLinkPrivilege；否則 Host 自動保存分階段複製並標記 copy。可開啓 設置 → 隱私和安全性 → 面向開發人員 → 開發人員模式（之後註銷再登錄），或以提升權限運行 DSH 以獲得真實軟鏈接。純文件導入與拖拽不需要符號鏈接權限。
Apple Books：僅 macOS；書庫不可用時需爲 DSH 授予完全磁盤訪問；未下載的書顯示爲不可用。
隱私：刪除條目會移除書架內文件、封面與閱讀狀態，不會跟蹤或刪除鏈接源；Page discussion 文件留在工作區 .dsh-bookshelf/，除非你發送引用它們的消息，否則不會進入模型上下文。
社區目錄 SkillHub 插件頁 與 GitHub 倉庫 爲獨立信息來源，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」思路，安裝與升級以 README 與倉庫發佈爲準。
結尾¶
dsh-bookshelf 把本地 PDF/EPUB 收進 DSH Web 工作流：統一書架、內置閱讀、本機持久化進度，並在 EPUB 場景下把當前頁接到工作區與 Books 側欄。若你主要在 macOS 或 Windows 上使用 DSH Web GUI，且需要邊讀邊在同一界面裏起草基於書頁的對話，可按上文命令安裝並在重載頁面後從 Bookshelf 開始導入。
- 目錄頁：https://www.skillhub.cn/plugins/Chriszzx/dsh-bookshelf
- GitHub：https://github.com/Chriszzx/dsh-bookshelf
