前言¶
DeepSeek Harness（DSH）的插件化架构让扩展能力变得灵活，但开发者仍需在多个工具之间切换：打开文档、搜索关键词、切换到 AI 对话、再切回原文。频繁切换会打断阅读和思考的连贯性。下面介绍的 AI Book Shelf 插件将一个全格式阅读器、AI 解释面板、论文翻译与对比视图集成到 DSH 侧边栏，让阅读、检索和 AI 交互在同一界面完成。
插件定位¶
AI Book Shelf 是一个持久化的 DSH Web UI 插件，为 DSH 增加全格式阅读器、AI 解释面板、书籍与论文库、全文搜索与在线检索、翻译与中英对照等功能。该插件由 0avatar0 维护，当前版本为 v2.6.11，核心能力包括多格式阅读、选中文本 AI 解释、全文搜索、论文翻译与双语对照、资料夹模式等。
核心功能¶
多格式阅读¶
插件支持多种常见文档格式，包括 EPUB、PDF、TXT、Markdown、HTML、FB2 和 DOCX。EPUB 保留其 OPF 精神、目录、标题、列表、表格、图片和封面；PDF 通过文本层提取，按 8 页一个章节切分，扫描 PDF 需先进行 OCR；TXT 与文本文件自动按段落分块；Markdown 与 HTML 保留标题、段落、列表、引用和代码块；FB2 解析 FictionBook XML；DOCX 解析段落与一级至三级标题作为章节。
选中文本 AI 解释¶
在阅读页面选中任意文本后，右侧面板会打开 AI 解释轨道。浮动选择栏左侧有一个问题输入框，可在「解释」按钮左侧输入具体问题，按回车或点击「解释」发送；不输入问题则直接给出解释。发送时会附带书籍、章节、选中内容与上下文。解释流式返回，支持继续追问、折叠/展开、复制回答，以及快速问题（翻译、举例、背景）。所有 Q&A 线程保存在宿主端的归档目录下，刷新页面或重启 Harness 后仍可继续。
全书搜索与在线检索¶
读者可以使用 Ctrl/Cmd + F 对整本书进行全文搜索，搜索结果会显示章节、出现位置与文本片段，点击即可跳转并高亮所有匹配项。插件还提供「Search books」标签页，可从多个在线公共领域目录检索书籍：Project Gutenberg（含中文版）、Chinese Wikisource、Chinese Wikibooks、Standard Ebooks 等。搜索结果按来源流式呈现，打开书籍或切换页面不会中断搜索流。可选择启用的来源，也可添加自定义 OPDS 搜索 URL，但仅接受声明了 open-access EPUB 获取链接的条目。
论文模式¶
论文模式为英文 PDF 提供了专门的阅读与处理工作流。支持创建虚拟文件夹、拖拽论文、重命名文件夹，以及从论文卡片右键菜单导入文件夹、新建文件夹、重命名。阅读页面提供段落级翻译（生成 JSON 翻译文件）、人工修正、重新翻译、整篇翻译并生成新的中文论文、双语对照视图。双语视图复用书籍阅读器的 AI 解释轨道与选中解释栏，支持折叠/展开、继续追问、删除线程或单条问答。翻译框可单独折叠或全部折叠，高度可调，首次打开自动适配文本。
资料夹模式¶
资料夹模式是另一个独立的资料库，支持文件夹、多选导入（在文件选择器中使用 Ctrl/Cmd 或 Ctrl+A）、关键词搜索、流式 AI 摘要与文件夹级技能。创建文件夹时会添加一个空技能文件，可手动填写；导入的 SKILL.md 可替换默认技能；AI 摘要会遵循技能内容。书籍可以在卡片菜单中隐藏/取消隐藏或删除（移至 .epub-reader/trash）。
安装与启用¶
- 从 最新发布页面 下载
dsh-ai-book-shelf-2.6.11.tgz，或使用 npm 安装：dsh-ai-book-shelf@2.6.11。 - 在 DSH 中打开「Plugins → Add plugin」，选择下载的 tgz 文件，或粘贴 npm 包规格说明。
- 重载插件后，在侧边栏打开「AI 书架 / AI Book Shelf」即可使用。
典型用法¶
阅读书籍并解释选中内容¶
- 在侧边栏打开「AI 书架」。
- 选择一个已扫描到归档书架的书籍文件，或从在线目录导入书籍。
- 在阅读页面选中一段文字，右侧会自动打开解释轨道。
- 在选择栏左侧输入问题（例如「这段话的核心论点是什么？」），按回车或点击「解释」。
- 阅读流式返回的答案，可继续追问、折叠/展开或复制。
检索并阅读论文¶
- 在论文库中创建虚拟文件夹，将 PDF 论文拖入文件夹。
- 打开论文，在阅读页面使用
Ctrl/Cmd + F搜索关键词。 - 选择一个结果，阅读页面会跳转到对应章节并高亮所有匹配。
- 选中某段文字，使用解释轨道获取翻译或解释。
- 点击「翻译」按钮或使用双语对照视图进行段落级翻译与对照。
批量导入资料与生成摘要¶
- 在资料夹模式中，选中多个文件，使用 Ctrl/Cmd 或 Ctrl+A 进行多选导入。
- 在资料夹内使用关键词搜索，快速定位文件。
- 点击「AI 摘要」按钮，插件会对搜索结果生成流式摘要。
- 若有
SKILL.md文件，AI 摘要会遵循其中的技能定义。
适用场景与注意¶
该插件适合需要在 DSH 中进行文档阅读、论文分析与翻译、多格式资料管理的用户。它以当前 DSH 进程权限运行，安装前建议查看 GitHub 仓库与 MIT 许可证，确认源码符合安全与合规要求。插件依赖 DSH 版本 >=0.2.1-rc.2，需在兼容环境下使用。
结尾¶
AI Book Shelf 将阅读器、AI 解释、全文搜索、论文翻译与资料夹管理集成到 DSH 侧边栏，让阅读、检索和 AI 交互在同一界面完成。其多格式支持、在线检索与双语对照能力，适合需要长期管理书籍与论文的开发者与研究者。
- 目录页：https://www.skillhub.cn/plugins/0avatar0/dsh-ai-book-shelf
- GitHub：https://github.com/0avatar0/dsh-ai-book-shelf
