前言¶
在 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/。
格式支持与边界¶
| 格式 | 说明 |
|---|---|
| EPUB | 使用 Node 自带能力解包，章名取自书内目录，封面自动抽取。 |
| TXT | 自动识别 UTF-8 / UTF-16 / GB18030，并按「第 N 章」等标题切章。 |
| 插件自研解析器：对象表、内容流、ToUnicode 还原文字；有书签按目录分章，否则按页分章。 | |
| DOCX | 解析 WordprocessingML 正文、标题层级与内嵌图片。 |
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 能识别的安装写法均可使用。
装完后在插件页将「书架」启用，左侧栏会出现对应图标。
典型用法¶
- 点侧栏「书架」图标，点右上角 扫描文件夹。
- 填入本地目录绝对路径，或通过「浏览…」选择目录。
- 勾选要入库的书，点 加入书架。
- 点 开始阅读；左侧为目录，用
←/→翻章，Esc返回书架。
数据、隐私与适用注意¶
| 位置 | 内容 |
|---|---|
~/.dsh-book-reader/library.json |
书架元数据与阅读进度 |
~/.dsh-book-reader/cache/<bookId>/ |
从文档解出的封面与插画 |
插件只读取已进入书架的文件，不会扫描未点名的目录。接口带同源回环闸门，仅本机回环且由浏览器发起的请求可进入。删除整个 ~/.dsh-book-reader 目录会清空插件数据，原始电子书文件仍在原路径。
适用场景：希望在 DSH 同一界面里管理并阅读本地电子书、且接受以当前 DSH 进程权限读盘的开发者或使用者。
安装前建议：插件以 DSH 进程权限读取你指定的路径；安装前应自行查看 GitHub 源码 与 MIT 许可证，确认路径与合规要求符合你的环境。DSH 生态主张「一切皆插件」；skillhub.cn 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-book-reader 把扫描、书架与阅读收进 Harness 侧栏，在完全本地的前提下覆盖 EPUB / TXT / PDF / DOCX 四类常见格式，并自研 PDF 解析以尽量还原段落与插图。若你需要在智能体开发环境中顺手读教材或文档集，可按上文命令安装启用。
