前言¶

在 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