dsh-novel-fish

DSH 小说摸鱼

在真实聊天的原生思考或工具区域中阅读本地小说：多选需要的区域类型，主动展开时保留原始内容，在明显分隔线下追加章节名和一段纯文本小说。重复展开不跳段，另一处首次展开才继续。小说不写入会话、不发送给模型。

适配 DSH Web 0.2.1-rc.2。没有独立阅读页、假会话、工作区入口或阅读工具栏。

当前版本：0.1.4

支持思考、其他工具调用、打开文件、运行命令、文件搜索五类多选和全选；保留原文、原生图标与交互，以分隔线追加章节/纯文本。修复编码、EPUB 解压、正文结构和关闭竞态问题。93 项自动测试通过；本轮真实 GUI 全流程受 Cua 绑定限制未完成，详见 0.1.4 验证与补验清单。发布产物见 v0.1.4。

开始读

1. 在 插件 页启用 小说摸鱼，进入 左下角头像 → 设置 → 通用设置 → 小说摸鱼。不依赖旧版本；不要同时启用两个接管思考的阅读插件。
2. 导入 .epub、.txt 或 .md，用“当前书籍”下拉选择一本书。旁边显示自动保存的分段进度，并可删除选中书籍。不提供粘贴文本入口。
3. 打开“阅读区域类型”下拉，勾选 思考 / 工具调用 / 打开文件 / 运行命令 / 文件搜索，可全选或全不选。五类不重叠，适用于任意会话中的对应原生区域，无需选择具体步骤。
4. 图标和箭头固定跟随 DSH 原生行为。主标题、补充文字用下拉预设；选择“自定义…”才出现输入框。空主标题保持各区域自己的原生标题。
5. 关闭设置，主动展开所选原生区域。原始思考或工具输入输出在上，横线、章节和小说在下；不覆盖原文，不改模型回答。已完成历史区域同样可用。不可展开的卡片不生成额外控件。

自动展开或已恢复展开的区域保留原文，但不读取小说；需要先收起，再主动展开。空选和关闭阅读都不消耗进度。设置页只管理书籍和显示，不是阅读入口。

安装 0.1.4

已有可运行的 DSH Web 0.2.1-rc.2 后，在下方插件市场中安装，或在终端安装固定版本：

dsh plugin --profile web add github:gongfpp/dsh-novel-fish#v0.1.4

发布版本包含浏览器构建产物，无需先安装开发依赖。也可从 v0.1.4 发布页 下载 gongfpp-dsh-novel-fish-0.1.4.tgz：

dsh plugin --profile web add ./gongfpp-dsh-novel-fish-0.1.4.tgz

web 是 profile 名称；使用其他 profile 时替换它。升级保留当前浏览器的书库和进度。安装后刷新现有 DSH 页面；若仍未加载新代码，重启原来的 dsh web，不要另开服务器。发布与安装验证范围见 发布记录。

已收录的公共可搜索市场

• Open Plugin Market：已审核收录 0.1.4。在 DSH「插件 → 发现 → 索引源」添加 https://dshopen.org/index.json，搜索 小说摸鱼 并选择 0.1.4 安装；使用已固定 Git 提交的发布版本，不依赖 npm。
• DSH Market：可视化市场已收录 dsh-novel-fish，支持搜索及 GitHub Release 包安装。尚未安装市场插件的用户可以运行 dsh plugin --profile web add dshmarket，重启 dsh web 后打开「插件 → Plugin Market」；在线详情页也提供安装命令。

以上收录均已核对公开市场数据；不代表已在所有客户端完成 GUI 实测。仅支持 DSH Web 0.2.1-rc.2。其他社区收录状态另行列出。

DSH 自定义插件市场

DSH 当前没有默认的统一第三方插件目录。本项目提供符合官方格式的自建索引源，不代表官方审核或推荐：

https://raw.githubusercontent.com/gongfpp/dsh-novel-fish/main/index.json

在「发现」页添加索引后安装 小说摸鱼 0.1.4；已添加本索引的用户刷新索引后查看新版本。若没有「发现」页，先启用实验性功能中的「自定义插件索引」（旧版名称「自定义插件市场」）。完整说明见 市场接入说明。

先停用其他接管思考渲染的阅读插件。 不依赖旧插件，也不支持两个阅读插件叠加运行。

续读规则

• 当前页面首次主动展开所选区域 A：读取并成功保存进度后，在原文末尾追加一段。收起再展开 A 仍用缓存。
• 首次主动展开另一处所选区域 B：读取下一段。缓存跨组件重挂载保留，不依赖模型是否正在运行。
• 自动恢复展开、加载历史、流式更新和模型结束不加载小说，不覆盖真实内容。
• 刷新后缓存清空；再次主动展开旧 A，从这本书保存的进度继续，不恢复旧片段。
• 切书清空临时缓存，各书分别保存进度；读取失败不推进，书末停止、不循环。
• 初次加载书库失败时禁止覆盖未知的已存数据，并明确报错。

文件与本地数据

EPUB 使用 epubjs 的 Container、Packaging、Navigation 解析器解析容器、OPF 和导航，按 linear spine 顺序读取 XHTML。ZIP 与 XML 读取失败直接报错。只抽取正文，不执行脚本、不加载书内图片或外部资源，不复刻原书排版。

TXT/MD 保留基本段落、章节；默认每段约 600 个 Unicode 字符，优先在段落/句子边界结束。支持严格 UTF-8 和带 BOM 的 UTF-16LE/BE，未知编码明确报错，不乱码入库；GBK 请先另存 UTF-8。导入只解析一次，聊天按需读一个已分好的段落。EPUB 仅分块解压实际使用项并校验 CRC，累计读取上限 128 MiB；这不是峰值内存保证，解码、XML 和整本分段另需内存。EPUB 图片不显示，纯图片书不支持。

书籍、段落、设置和每本书的进度存在当前浏览器、当前站点的 IndexedDB。设置保存区域类型，不保存会话／步骤位置列表或小说绑定；片段缓存只在当前页面插件实例内。不同浏览器/站点不共享，不提供多标签同步。升级本插件时保留原书库和进度，清理站点数据则会删除书库。只导入你有权使用的内容。

兼容与历史验收

原生正文插槽不提供标题接口。本插件对具体 DSH DOM 标记中的文字做窄适配，更新原生 shimmer 文字层；不覆盖原生图标、按钮、箭头、布局或事件。思考原文仍用官方 Factory，工具原文节点保持；小说以自己的分隔线和纯文本追加。不替换聊天根节点，不修改 DSH 安装文件。具体定位、工具末尾 DOM 适配和限制见 宿主适配说明。

0.1.4 通过 93 项自动测试（含市场源契约）。当前 Cua 无法获得新版真实 GUI 的可变更精确绑定，未宣称完成本轮人工悬停、键盘及真实 A/B/C 全流程。新版验证、七项修复和手工清单见 0.1.4 记录。0.1.3 原生显示记录 和 0.1.2 追加阅读记录 仅为历史证据。

历史验收记录 与 0.1.1 设置改进 保留各自版本的验证范围，不替代本轮运行证据。

开发

Node.js 24.19.0、pnpm 12.11.2 为此次构建环境：

pnpm install --frozen-lockfile --ignore-scripts
pnpm verify
pnpm pack

安装不批准依赖脚本，构建使用 esbuild 平台二进制。运行依赖打入客户端产物，普通用户安装压缩包无需运行开发脚本。

• chat-adapter.js：唯一 DSH 接入模块。
• store.js / persistence.js：页面缓存、串行读写及本地持久化。
• segments.js / epub.js：导入解析和统一分段。
• settings.js：最小设置。

许可

本项目为 MIT；书本图标为本项目原创 SVG。构建时生成 第三方依赖许可，包含 JSZip 预打包的子依赖声明。旧仓库仅作只读行为参考，没有复制其独立阅读、工作区或兼容状态系统。