前言¶
在 DSH 里做长文阅读时，常见做法是丢给模型要摘要，或自己翻 EPUB、TXT 再在对话里贴片段。摘要容易丢掉章节在全书里的位置；贴片段则难形成「一章一章讲透、还能对照原文」的节奏。下面介绍社区插件 dsh-book-library（维护者 shenj13）：在 DSH 左侧栏提供书库，导入 EPUB / TXT / Markdown，按章流式讲解、可选语音朗读，数据落在本机 Markdown，与 dsh-deep-reading 读写格式一致。
这是什么¶
dsh-book-library 是 DeepSeek Harness 的 Web 侧栏插件（engines.dsh: >=0.2.0-rc.2，当前 package 版本 1.29.3，MIT）。定位不是摘要工具或目录搬运，而是逐章真正读懂：这一章在全书里起什么作用、作者怎么写、讲解侧可以持不同观点。文字讲解走 DSH 当前默认模型；语音可选火山引擎豆包或 macOS 本机 say。
核心功能¶
导入与书架¶
- 支持 EPUB、TXT、Markdown 选文件上传，自动切章；可从正文识别书名（文件名不规范也可改书名）。
- 书封「⋯」可改书名、删除、看简介；字号可调，界面缩放不影响 DSH 其它区域。
- 删除书籍进入回收站
~/.dsh/book-library/trash/，可恢复。
逐章五段式讲解¶
点任意一章，讲解框流式生成；生成后本地缓存，同一章不再重复调用模型。固定结构：
| 段落 | 内容 |
|---|---|
| 本段落概括 | 两三句交代事实：谁、在哪、发生什么、停在哪 |
| 文章美句 | 原句逐字摘录并标段号，说明好在哪；没有则直说 |
| 作者表达 | 作者意图与写法；本章在全书中的结构角色 |
| AI 观点 | 对文本的判断，可不同意作者 |
| AI 认为需要补充点 | 遗漏前提或读者宜补的背景 |
篇幅随原文：正文短则讲解短，讲解不会比原文更长。
原文对照与互动¶
- 讲解中的段号
[7]可点击，滚动到原文第 7 段并高亮；讲到哪段，原文对应段落淡色标出，且只显示相关段落。 - 播放条下可边听边问；另有不绑章节的整书即时答疑。
- 一章念完可自动接下一章；未讲过的章会先讲解再念；同一时间只一路声音。
语音与导出¶
- 念出来听：默认豆包（火山引擎）TTS，语气随情节由模型定；亦可选 Mac 自带朗读。
- 导出：已讲章节可装订为单页 HTML，便于打印或转发（浏览器本地生成）。
数据与隐私¶
书和笔记在本机 $DSH_HOME/deep-reading/books/（默认 ~/.dsh/deep-reading/books/），每书一目录，章节与讲解为纯 Markdown；阅读偏好在 ~/.dsh/book-library/preference.md。发给模型的仅为当前章正文、书名与目录、阅读偏好；语音仅发送待朗读文本。插件自带导入器，不依赖 deep-reading 原生二进制，格式与 dsh-deep-reading 一致（book.json、chapters/NNN.md、lecture/、memory/），两边成果可互通。
安装与启用¶
在终端执行官方安装命令：
dsh plugin install dsh-book-library
或在 DSH 插件市场搜索「书库」一键安装。装完后左侧栏出现「书库」图标。
启用前请自行查看 GitHub 仓库 源码与 MIT 许可证；插件以当前 DSH 进程权限运行，导入的文件与生成内容均写在本机目录。
用之前的配置¶
- 文字讲解：在 DSH 设置里选择默认模型即可，无需为本插件单独配模型。
- 语音：若用豆包，在插件「设置」中填写应用号（App ID）与访问密钥；若不想接云服务，macOS 上可选用本机朗读。
典型用法¶
- 打开左侧「书库」，上传 EPUB / TXT / Markdown。
- 在书架选书，点某一章，等待五段式讲解流式完成（之后同一章读本地缓存）。
- 需要听书时在讲解区启动朗读；播放过程中用下方提问框追问段落含义，或用整书答疑。
- 读完后在导出功能生成单页 HTML 存档。
适用场景与注意¶
适合需要按章精读、希望讲解有结构（概括、原文美句、作者意图、独立观点）且要对照原文段落的读者；也适合希望笔记以 Markdown 留在磁盘、可与 dsh-deep-reading 目录互通的场景。
注意：语音依赖第三方服务或 macOS 环境；非 Mac 用户以文字讲解为主。社区目录页 skillhub.cn 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-book-library 把「导入—逐章讲解—对照原文—可选 TTS—本机 Markdown」收进 DSH 侧栏，适合在 Harness 里长期啃书而不是一次性摘要。
- 目录页：https://www.skillhub.cn/plugins/shenj13/dsh-book-library
- 源码：https://github.com/shenj13/dsh-book-library
