前言¶
DeepSeek Harness（DSH）的思考步骤默认在聊天流中展开。如果你想在思考过程中阅读本地小说，又不想让模型看到、不想把小说写入会话，现有的 DSH 生态里没有现成方案。本插件通过“窄适配”的方式，只在真实聊天中用户选中的思考步骤里读取本地文本，不与模型交互，也不修改会话数据。
是什么¶
DSH 小说摸鱼 是一个 DSH 插件，用于在真实思考步骤中阅读本地小说。它由维护者 gongfpp 开发，分类属于“记忆”。插件适配 DSH Web 0.2.1-rc.2，不提供独立阅读页、假会话或工作区入口。小说只出现在用户主动展开的目标步骤中，其余地方保持原样。
核心功能¶
- 只在真实聊天中选中的思考步骤里展示小说片段。
- 支持导入本地 EPUB、TXT、MD 文件，或直接粘贴文本。
- 每次主动展开目标步骤时读取一段，重复展开同一步骤使用缓存，首次展开另一目标才继续下一段。
- 小说不混入模型思考，不写入会话，不发送给模型。
- 书籍、段落、设置和进度保存在当前浏览器、当前站点的 IndexedDB 中，不同浏览器/站点不共享。
- EPUB 使用 epubjs 的 Container、Packaging、Navigation 解析器，按 linear spine 顺序读取 XHTML；TXT/MD 按段落/章节解析，默认每段约 600 Unicode 字符。
- 导入 EPUB 有 128 MiB 解压上限，极大文件可能受浏览器资源限制。
- 支持为每本书设置图标、主标题、补充文字；空主标题使用 DSH 当前语言的“思考”。
安装与启用¶
确保 DSH Web 已运行在 0.2.1-rc.2。在终端执行：
dsh plugin --profile web add github:gongfpp/dsh-novel-fish#v0.1.0
安装后刷新现有 DSH 页面。若更换已安装版本仍未加载，重启原来的 dsh web，不要另开一个服务器。
也可从 v0.1.0 发布页 下载 gongfpp-dsh-novel-fish-0.1.0.tgz，在下载目录执行：
dsh plugin --profile web add ./gongfpp-dsh-novel-fish-0.1.0.tgz
从插件市场安装：
- 在 DSH 的自定义插件市场「发现」页添加索引：
https://raw.githubusercontent.com/gongfpp/dsh-novel-fish/main/index.json
- 若没有「发现」页，先启用实验性功能中的「自定义插件市场」。
- 选择 小说摸鱼 并安装。
启用前先停用其他接管思考渲染的阅读插件，避免冲突。
典型用法¶
- 在 插件 页启用 小说摸鱼，进入 账号菜单 → 设置 → 通用设置 → 小说摸鱼。
- 导入
.epub、.txt、.md，或粘贴文本；在书籍列表选中一本书。 - 设置图标、主标题、补充文字；空主标题使用 DSH 当前语言的“思考”。图标输入符号或 emoji。
- 点 选择目标思考步骤，关闭设置窗口，在真实聊天中点选一个或多个思考步骤。选择动作不消费小说；再回到设置点 完成选择。
- 主动展开目标步骤阅读。已完成的历史步骤同样可用；如果 DSH 折叠了外层“已完成／工作过程”分组，先按原生交互展开该分组。
续读规则¶
- 当前页面首次主动展开目标 A：读取并成功保存进度后展示一段。收起再展开 A 仍用缓存。
- 首次主动展开目标 B：读取下一段。缓存跨组件重挂载保留，不绑定小说、会话生命周期或模型运行状态。
- 自动恢复展开、加载历史、流式更新和模型结束不加载小说。
- 刷新后缓存清空；再次主动展开旧 A，从这本书保存的进度继续，不恢复旧片段。
- 切书清空临时缓存，各书分别保存进度；读取失败不推进，书末停止、不循环。
- 初次加载书库失败时禁止覆盖未知的已存数据，并明确报错。
文件与本地数据¶
EPUB 使用 epubjs 的 Container、Packaging、Navigation 解析器解析容器、OPF 和导航，按 linear spine 顺序读取 XHTML。ZIP 与 XML 读取失败直接报错，不依赖电子书渲染器的异步页面生命周期。只抽取正文；不执行脚本、不加载书内图片或外部资源，不复刻原书排版。
TXT/MD 保留基本段落、章节；默认每段约 600 Unicode 字符，优先在段落/句子边界结束。导入时解析一次，聊天每次只读取一个已经分好的段落。EPUB 累计解压读取上限为 128 MiB；整本导入需要本地内存，极大文件可能受浏览器资源限制。
书籍、段落、设置和每本书的进度存在当前浏览器、当前站点的 IndexedDB。目标定位属于设置，不含片段索引或小说绑定；片段缓存只在当前页面的插件实例内。不同浏览器/站点不共享，不提供多标签同步或旧版数据迁移。清理站点数据会删除书库。只导入你有权使用的内容。
兼容与验收¶
原生正文插槽不提供标题/图标接口。本插件采用对具体 DSH DOM 标记的窄适配，停用即移除本地覆盖；不替换聊天根节点，不修改 DSH 安装文件。版本变化需重新验收，不能把设置预览当作实际效果。
适用场景与注意¶
适合想在思考过程中阅读本地小说、且不希望模型看到或干扰模型的 DSH 用户。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
结尾¶
本插件通过窄适配的方式，在真实思考步骤中实现本地阅读，不污染会话与模型交互。了解更多与源码：DSH 小说摸鱼。
