前言¶
在 DeepSeek Harness（DSH）里做智能体或日常对话时，长文本往往只能「看」：公版书要自己去各站找链接，手里的 EPUB、PDF 也很难和对话、笔记放在同一套环境里。单独装听书 App 又和 DSH 的模型、插件生态脱节。
下面介绍社区插件 搜书听（npm 包名 dsh-audiobook，仓库 AIcivilization/dsh-audiobook）：在 DSH 右侧栏或独立 Web 面板里搜公版书库、导入本地文件，用 Edge 神经语音、浏览器系统语音或离线 Kokoro 朗读，并支持进度记忆、语音记心得、按章节问 AI。维护者为 AIcivilization，许可证 MIT（见仓库 README）。
这是什么¶
搜书听 的定位是：把一本书变成可在 DSH 内收听的有声书体验——「搜一本书，或者导入一本书，读给你听」。书名、作者、角色名、模糊情节都可用来找书；声音与语速可调，自动记住听到哪。插件登记在 dsh-plugin.org，也可通过 npx dsh-audiobook 脱离 DSH 单独使用。
运行要求（README 原文）：Node.js ≥ 20；DSH web / desktop profile；ffmpeg 可选（安装后可将本地语音压成 MP3）。书、进度、心得等数据落在运行 DSH 的机器上的 ~/.dsh/dsh-audiobook/。
核心功能¶
搜书与书源¶
面板顶部搜索框支持书名、作者，或「只记得角色名 / 大概情节」的检索。流程上先在 DSH 所选模型帮助下猜候选书目，再到书源中匹配；找到后可「加入书架」，下载完成后出现在书单。
| 书源 | 说明 |
|---|---|
| Project Gutenberg | 约 7 万本公版书，英文为主，含部分中文古籍（多为繁体） |
| 中文 / 英文维基文库 | 公版古籍、民国作品等；大书导出 EPUB 可能需一两分钟 |
| Internet Archive | 公有领域或 CC 授权且有文字版；扫描版 OCR 可能有错字并会标注 |
| Standard Ebooks | 精校排版英文公版书 |
仅对接公版与授权免费源；受版权保护的现代书搜不到时，README 建议购买正版电子书后自行导入。可同时走 DSH「网页搜索」插件拿链接，或在搜索框下使用可配置的百度、必应、Google、豆瓣读书等外链；支持 OPDS 自建书库（Calibre、calibre-web、Kavita 等），结果可并入书源列表一键加书架。实际下载由 运行 DSH 的机器 发起，网络环境决定各源是否可用。
导入本地文件¶
支持拖入、选文件或填写本机路径。格式与处理方式见 README：TXT（多编码）、EPUB（无 DRM）、PDF（需文字层）、DOCX、Markdown / HTML；RTF / DOC 仅在 macOS 经 textutil 转换。纯文本按常见章标题分章，否则约每 8000 字一段。
朗读与语速¶
正文按约 20–30 秒一段切分，当前段高亮，可点任意段起播。
| 方式 | 要点 |
|---|---|
| 浏览器朗读 | 设备自带语音，文字不出设备 |
| 微软 Edge（edge-tts） | 多种中英文神经语音；插件启动时自动安装组件，需联网，文字发往微软服务器 |
| 本地离线 Kokoro | 完全离线，首次约 147 MB 模型；合成较慢，首段等待较长 |
语速 0.75×–2.5×；Edge 与本地语音由播放器变速且音调不变。每段进度会持久化，换设备可续听。若已安装 DSH 插件「听懂」，可复用其 Kokoro 与 Edge 组件。
心得、问 AI 与导出¶
播放条支持语音记心得（本地 SenseVoice，约 241 MB 首次下载）、按听书位置挂靠、AI 整理口头语、自动标题与按日期浏览。播放条左侧可向 AI 提问当前章节上下文，默认防剧透。心得本支持按章 / 按时间查看、搜索、导出 Markdown，并可发现 Obsidian、Logseq、DSH 笔记类插件等导入目标。书库页提供跨书心得检索与「AI 帮我回顾」最近 7 / 30 天记录。
在 DSH 对话里调用的工具¶
README 列出 8 个注册工具，可直接用自然语言驱动，例如：
- 找书并下载：
audiobook_search、audiobook_download - 导入路径：
audiobook_import - 书架与进度：
audiobook_books - 正文检索与摘要：
audiobook_text - 跳转：
audiobook_goto - 心得：
audiobook_notes、audiobook_add_note
安装与启用¶
先完全退出 DSH，将 desktop 换成你的 profile 名后执行：
dsh plugin --profile desktop add dsh-audiobook
重新打开 DSH，在对话页打开右侧栏，选择「搜书听 · 读书给你听」。若在 VPS 上部署 DSH，README 建议手机浏览器访问 https://<你的域名>/api-dsh-audiobook/panel；前置 nginx 时需调大 client_max_body_size（默认约 1 MB）。VPS 上更推荐 Edge 或浏览器朗读，离线 Kokoro 对 CPU 要求高。
可选配置写在 profile 的 cordis.patch.yml（字段以 README 为准）：
- id: dsh-audiobook
config:
provider: dsh-model-workbuddy-ai
model: workbuddy-ai/deepseek-v4.1-flash-sg
edge: false
ffmpeg: /opt/homebrew/bin/ffmpeg
threads: 2
workers: 2
更新与卸载在 DSH「设置 → 搜书听」；卸载只移除插件，数据仍保留在 ~/.dsh/dsh-audiobook。
典型用法¶
面板听书：安装后从右侧栏进入，搜公版书或导入文件，选朗读方式与语速即可。
对话里让 AI 操作（README 示例意图）：
- 「帮我找那本主角叫贾宝玉的书来听」
- 「把我读《呼啸山庄》的心得整理一下」
- 「把 ~/Downloads/三体.epub 导入搜书听」
- 「跳到阿青出场的地方」
不启动 DSH 的 CLI（package 提供 dsh-audiobook 命令）：
npx dsh-audiobook import ~/Downloads/书.epub
npx dsh-audiobook serve
npx dsh-audiobook list
serve 默认打开 http://127.0.0.1:4811。问 AI、整理心得等需 OpenAI 兼容接口时，可用 --base-url / --api-key / --model 或环境变量 AUDIOBOOK_BASE_URL、AUDIOBOOK_API_KEY、AUDIOBOOK_MODEL；未配置时走本机 dsh-model 网关。
适用场景与注意¶
适合希望在 同一台运行 DSH 的环境 里完成找书、听书、记笔记并与模型对话的用户；公版检索、本地导入、离线朗读与心得沉淀是主要价值。
安装前建议自行阅读 GitHub 仓库 源码与 MIT 许可证。插件以 当前 dsh 进程的用户与权限 运行，可访问本机路径与网络；Edge 朗读会把文本发往微软服务器，浏览器朗读与本地 Kokoro、SenseVoice 识别按 README 说明在本地或约定边界内处理。微软 Edge 语音依赖非官方 edge-tts 路径，存在失效风险。受版权保护的作品请通过正版渠道获取后导入，不要指望插件提供未授权书目。
社区目录页（与 DeepSeek / 幻方无官方从属关系）：skillhub.cn 插件页。DSH 生态奉行「一切皆插件」，搜书听是其中面向 有声书朗读 / 读书笔记 的一类能力实现；npm 当前版本见包元数据（如 0.6.0）。
结尾¶
搜书听把公版书源检索、多格式导入、多路 TTS、进度与心得、以及对话侧工具串进 DSH，长文阅读可以「边听边记、边问边跳」。需要细节命令、数据目录结构与开发模块划分时，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/AIcivilization/dsh-audiobook
- GitHub：https://github.com/AIcivilization/dsh-audiobook
