更新记录

1.6.0（2026-05-17） 下载此版本

v1.6.0（当前版本）

• 新增：控制台自动翻章独立配置（consoleAutoNext / consoleAutoNextDelay），与状态栏完全分离
• 新增：进度保存节流，1秒内多次操作只写一次文件
• 修复：scrollBack 翻到上一章末尾后定时器立刻再翻章的 bug
• 修复：暂停后继续不从当前句开始，现在精确从暂停那句续上
• 修复：手动模式下控制台跟着状态栏自动播放的问题
• 修复：手动模式下显示自动播放相关提示的问题
• 修复：取消选择文件会重置当前阅读状态
• 修复：目录跳章后不解除暂停
• 修复：hasContent 英文标点误判，改为中文标点优先
• 修复：控制台自动翻章递归调用问题
• 修复：进度恢复时 segIndex 未同步设置
• 修复：关闭插件时节流定时器未正确清理

v1.5.0

• 新增：阅读进度自动保存，翻章/翻段/目录跳转时自动保存
• 新增：多本书独立记录进度，互不干扰
• 新增：下次打开弹窗询问从上次继续还是从头开始
• 新增：状态栏模式进度精确恢复到上次读的段落
• 新增：暂停/继续自动播放（alt+p），状态栏颜色变灰提示暂停状态
• 新增：控制台模式自动翻章功能
• 修复：控制台暂停后切换状态栏暂停状态丢失的问题
• 修复：状态栏和控制台定时器互相干扰问题
• 修复：打开新书时未正确重置所有播放状态

1.4.0（2026-04-22） 下载此版本

v1.4.0（当前版本）

• 新增：epub 支持 NCX/NAV 锚点精确切割，同一文件内多个章节正确分割
• 新增：epub 兼容属性任意顺序的 OPF 文件格式
• 修复：HTML 格式标签未清理直接输出的问题
• 修复：HTML 改用 h1~h3 标签直接分章，不再依赖章节正则
• 优化：MD 新增删除线、下划线粗体、引用块清理
• 优化：四种格式 HTML 实体解码更完整，支持 &#数字; 格式
• 优化：兜底逻辑修复，HTML 格式兜底时也会清理标签

1.3.1（2026-04-16） 下载此版本

v1.3.1（当前版本）

• 新增：自动跳过空章节、简介页，直接进入正文
• 新增：状态栏按句子分段显示，阅读体验更流畅
• 新增：自动播放读完一章后自动切换下一章
• 优化：章节识别正则，兼容更多中文小说格式
• 优化：手动翻段到章节末尾时自动跳下一章

v1.2.0

• 新增：支持 epub 电子书格式
• 新增：支持 md / html 格式
• 新增：状态栏手动滚动模式（alt+, / alt+.）
• 新增：状态栏文字颜色自定义

v1.0.0

• 初始版本发布
• 支持 txt 格式
• 控制台输出 / 状态栏显示两种模式
• 支持上一章、下一章、目录跳转

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

📖 摸鱼神器 - 小说阅读器

在 HBuilderX 控制台或状态栏中阅读本地小说，输出格式伪装成日志，摸鱼必备！

✨ 功能特色

• 📚 支持 txt / md / html / epub 四种格式
• 🖥️ 两种显示模式：控制台输出 或 状态栏逐句显示
• ⏱️ 状态栏支持自动播放和手动翻段两种方式
• ⏸️ 支持暂停 / 继续自动播放（Alt+P）
• 🔄 自动播放读完一章后自动切换下一章，全程无需操作
• 💾 自动记录阅读进度，下次打开可从上次位置继续
• 📚 多本小说独立记录进度，互不干扰
• 📑 支持目录跳转，想看哪章点哪章
• ⏭️ 自动跳过空章节、简介页，直接进入正文
• 🎨 状态栏文字颜色自定义
• 🔤 控制台频道名称自定义（改成 Console 更隐蔽）
• 📖 epub 支持 NCX/NAV 锚点精确切割，章节划分更准确

📦 安装方法

在 HBuilderX 插件市场购买后，点击导入插件，重启 HBuilderX 即可使用。

🚀 快速开始

第一步： 点击顶部菜单 文件 → 📖 打开小说文件

第二步： 选择本地的小说文件（支持 txt / md / html / epub）

第三步： 如有历史进度，弹窗选择从上次继续或从头开始

第四步： 插件自动解析章节，开始在控制台或状态栏显示内容

⌨️ 快捷键一览

🖥️ 两种显示模式

控制台模式（默认）

完整章节内容输出到控制台，格式伪装成运行日志：

[10:30:45] INFO  ─── 第三章 初入江湖 ───
[10:30:45] INFO  进度: 3 / 1040 章
[10:30:45] LOG   少年站在山顶，望着远处连绵的群山，心中思绪万千。
[10:30:45] LOG   师父说过，江湖险恶，切不可轻信他人。
[10:30:45] INFO  5秒后自动翻下一章...

状态栏模式

文字在底部状态栏按句子逐段显示，极度隐蔽：

📖 少年站在山顶，望着远处连绵的群山，心中思绪万千。

• 自动模式：每段停留固定时间后自动切换，读完一章自动进入下一章，全程无需操作
• 手动模式：用 Alt + , / Alt + . 自己控制阅读节奏，随时暂停

⏸️ 暂停 / 继续

按 Alt + P 随时暂停或继续自动播放：

手动翻章、目录跳转时会自动解除暂停，恢复播放

💾 阅读进度

• 每次翻章、翻段、目录跳转时自动保存进度
• 关闭 HBuilderX 时也会自动保存
• 下次打开同一本书时弹窗询问：

📖 道诡异仙 — 检测到上次阅读记录，请选择
▶ 从上次继续：第305章 · 第12段 · 第三百零五章 云雾散去
↺ 从头开始：第1章

• 多本小说各自独立记录，互不干扰
• 进度保存在插件目录下的 reading-progress.json

⚙️ 个性化设置

进入 工具 → 设置 → 插件配置 → 摸鱼阅读器 进行个性化配置：

注意： 只有 channelName（控制台标签名）修改后需要重启 HBuilderX 才能生效，其余设置改完后翻一次章节即可立即生效，无需重启。

📚 支持格式详情

TXT ✅ 推荐

兼容市面上绝大多数中文小说章节格式，稳定性最高：

第一章 标题        第001章 标题       第一回 标题
【第一章】标题     ===第一章===       序章 / 楔子
尾声 / 终章        番外 / 后记        Chapter 1
上部 / 下部        卷一 / 卷二        （一）（二）

⚠️ 可能失败： 文件编码为 GBK/GB2312，建议用记事本另存为 UTF-8 后再导入

Markdown ✅

• 支持 # / ## / ### / #### 标题作为章节分割
• 自动清理 **粗体** / *斜体* / ~~删除线~~ / > 引用块 等语法符号
• 同时兼容中文小说章节格式（如 第一章 xxx）

⚠️ 可能失败： 没有任何标题，纯段落文本，会整本显示为一章

HTML ✅

• 自动提取 <h1> ~ <h3> 标签内容作为章节标题
• 完整清理所有 HTML 标签、CSS、JavaScript、HTML 注释
• 支持   / & / &#数字; 等 HTML 实体解码

⚠️ 可能失败： 章节不是用 h1~h3 标签划分，或文件编码不是 UTF-8

EPUB ✅

• 支持标准 epub2 / epub3 格式
• NCX/NAV 锚点精确切割：同一 HTML 文件内的多个章节也能正确分割
• 章节标题优先从 NCX/NAV 目录读取，保证标题准确

⚠️ 可能失败： DRM 加密保护的 epub（购买的正版电子书）无法解析，这是加密机制限制，无法绕过

🐟 摸鱼技巧

最隐蔽组合：

• 显示模式改为 statusbar（状态栏）
• 播放方式改为 auto（自动）
• 停留时间设为 5000（5秒换一句）
• 颜色改为 #ffffff（白色，和编辑器主题融合）
• 控制台频道名改为 Console（改完需重启）

这样文字安静地在底部状态栏滚动，领导经过完全不会发现 😄

紧急情况：

• 领导突然走来 → Alt+P 暂停，状态栏颜色变灰，什么都没发生
• 想继续看 → Alt+P 再按一次，从刚才那句精确继续

❓ 常见问题

Q：打开小说后控制台没有内容？ A：前几章可能是简介、版权说明等短章节，插件会自动跳过，直接从第一个正文章节开始显示。

Q：章节没有正确分割，全部显示成一章？ A：部分小说的章节格式比较特殊，用文本编辑器打开确认章节标题格式。TXT 确认是否为支持的章节格式；HTML 确认章节是否用 h1~h3 标签划分。

Q：TXT 文件打开后显示乱码？ A：文件编码可能是 GBK/GB2312，用记事本打开，另存为 UTF-8 编码后重新导入即可。

Q：epub 文件打开失败？ A：请确认是标准 epub 格式。DRM 加密保护的 epub 无法解析，这是加密机制限制，无法绕过。

Q：epub 章节标题显示为"第X章"而不是真实标题？ A：该 epub 没有包含 NCX/NAV 目录，插件使用默认序号代替，内容仍可正常阅读。

Q：修改了设置不生效？ A：只有 channelName（控制台标签名）需要重启 HBuilderX 才能生效。其他所有设置改完后翻一次章节即可立即生效，无需重启。

Q：进度记录在哪里？如何清除？ A：保存在插件目录下的 reading-progress.json，删除该文件即可清空所有书的进度记录。

Q：状态栏颜色怎么设置？ A：填写十六进制颜色值，例如白色 #ffffff、绿色 #00ff00、黄色 #ffcc00、青色 #4ec9b0。

Q：其它问题？ A：每次修改插件的配置项后建议重启HBuilderX。如果设置了自动相关配置，切换过程中 , 控制台没有任何章节或者状态栏没有任何内容输出，很有可能是暂停了，需要快捷键Alt + P恢复

💰 支持作者

如果觉得好用，欢迎请作者喝杯咖啡 ☕

哪怕一块钱，都是对作者最大的鼓励 🙏

觉得好用的话也欢迎推荐给身边的同事～

使用过程中遇到问题，欢迎在插件市场评论区留言反馈。

如果觉得好用，一个好评就是对作者最大的支持 ⭐

本插件代码已加密，禁止反编译及二次分发。