# read-tts

**Repository Path**: sprouting/read-tts

## Basic Information

- **Project Name**: read-tts
- **Description**: 本地看书、阅读、听书软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-27
- **Last Updated**: 2026-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 悦读 · read-tts



## 项目由来

这个项目其实想了挺久的，趁着Ai的东风就写出来了，主要调研了市面上大部分的阅读APP，真的没什么好用的，我这个还是电脑端阅读，几个需求始终没法满足，其实应用很简单，一般就是打开大文件不卡，能够语音阅读，智能排版，以及去广告等功能。花了2周时间终于搞定，算是基本可用吧。之后就是慢慢优化了。

![image-20260905225129966](README.assets/image-20260905225129966.png)

![image-20260905225157994](README.assets/image-20260905225157994.png)

![image-20260905225209105](README.assets/image-20260905225209105.png)

![image-20260905225222766](README.assets/image-20260905225222766.png)





## 技术栈

基于 Electron + electron-vite + Vue 3 + Pinia + Sherpa-ONNX + TypeScript 的本地 txt 电子书阅读 + 语音朗读桌面应用，亮色现代风格，全中文界面，绿色软件式配置（无需安装，可随目录拷贝）。

- [electron-vite](https://electron-vite.org/) 2.x：主进程 / preload / 渲染进程三端构建
- Electron 33（`contextIsolation` + `contextBridge`，渲染进程不直接触达 Node）
- Vue 3（`<script setup>`）+ Vue Router（memory history）+ Pinia
- TypeScript strict
- 运行时依赖：`iconv-lite`（编码转换）、`jschardet`（编码检测）、`sherpa-onnx-node`（Sherpa-ONNX 的 NAPI 原生语音包）；Piper 与 Sherpa-ONNX 的语音引擎与模型由你放入 `resources/` 目录（应用本地扫描发现，不做在线下载）





## 功能

功能一览：

- 支持离线语音阅读
- 支持智能分章
- 智能排版长文重排
- 智能去广告隐藏站点推广段
- 支持自动识别编码
- 精确断点恢复
- 语音阅读高亮滚动
- 智能排版常温重拍
- 三种导入方式：选择文件（可多选）、扫描整个文件夹（递归收集其中全部 txt）、整窗拖拽导入。只收 `.txt`；单文件超过 100MB 自动跳过并提示。
- 智能命名：导入即自动识别书名与作者（文件名解析为主、正文头部「书名/作者/著者：」等线索为辅，并净化 `[站点]`、`_作者` 等噪声），读不懂的名字随时可在卡片菜单里手动重命名（仅改书架显示名，源文件不动）。
- 卡片展示：渐变色封面（按书籍 id 哈希固定颜色，改名 / 换识别结果都不会变色）、书名、作者、文件大小、添加时间、阅读进度条。
- 排序：最近打开的自动置顶，新导入的排最前；启动时校验源文件是否仍在，失效记录自动清理。
- 搜索 + 分页：按书名模糊搜索，每页 24 本。
- 阅读历史：左侧「历史」列出最近打开的书，一键续读；打开某本时书架同步置顶。
- 单本操作菜单（卡片「⋯」）：
  - 打开所在文件夹：系统文件管理器中定位源文件；
  - 重命名；
  - 删除：二次确认弹窗；默认只从书架移除，可勾选「同时删除源文件」（红色警示），勾选后才会真正删除文件。
- 整本一体载入：中小书打开即把全书正文一次性载入，正文滚动条就是全书进度——随便拖到哪，进度就是哪；跨章无缝连续阅读，滚过章界不失真。仅超过极端规模（全书 >20 万段或 >5000 章，本库实际不达）才自动回退「快开 + 滚动/朗读续章」。
- 精确断点恢复：阅读位置用「全书段落号 + 段内偏移」锚定（旧版「章号+章内段」记录会在打开时自动迁移）。重切章、章数变化都不会让断点漂移。打开即显示 ≥0.1% 进度（界面 1 位小数），读到全书最后一段才精确 100%——大书开头进度不会纹丝不动。
- 进度落盘稳妥：手动翻页按「视口正在读的段落」记，听书时按「正在朗读的句子所在段落」记；离开阅读页 / 关窗口 / 切到后台前统一同步落盘，绝不把精确位置覆盖回章节开头。
- 左侧目录：展示智能分章结果，点击跳章（目标章在正文内直接滚动，不重建）。
- 阅读体验实时调：正文字号、行距、正文宽度、页面主题（纸白 · 羊皮纸 · 护眼绿）——设置项在阅读页与设置弹窗实时生效。
- 智能排版（智能分行）：阅读页工具栏开关，随书记忆。针对整段没有换行、被压成一个长段的「网抓版长文」，先按句切分、再把句子按对话节奏攒回自然段（对话独立成段、叙述攒句成段），观感接近正常排版的小说。纯展示层：视觉段仍挂在原段落号上，不改原文、不动进度与定位。
- 乱码自救（切换编码）：底部状态栏显示当前实际编码，点开即可在 UTF-8 / GBK / GB18030 / Big5 / UTF-16 LE/BE / Shift_JIS / EUC-JP / EUC-KR 间切换重读；手动选择会被记住，文件内容变化后也沿用。
- 朗读句高亮：正在朗读的段落高亮（可在设置关闭）。
- 智能去广告：自动隐藏网抓 txt 里夹带的站点推广段（下载站公告、更新地址、「本章未完 点击下一页」、每章重复的网址尾巴等），阅读与朗读都跳过、进度不受影响。书级开关默认开启、随书记忆；正文顶部提示「已隐藏 N 段」，可一键「显示原文」。识别与隐藏的实现思路见文末「设计思路」一节。



### 语音朗读（本地离线引擎，无需联网）

- Piper：轻量本地神经 TTS（spawn `piper.exe` 逐句合成 WAV）。引擎放 `resources/tts/piper/app/`（piper.exe + espeak-ng-data/DLL），中文模型放 `resources/tts/piper/model/`（`zh_CN-*.onnx` + 同名 `.onnx.json`），放入后自动可用。
- Sherpa-ONNX：官方 npm 原生包 `sherpa-onnx-node`，语音质量更佳（推荐中文 matcha-icefall-zh-baker 声学模型 + 独立 vocos 声码器）。模型放入 `resources/tts/sherpa-onnx/model/`（可用 `<模型目录>/` 分组），放入后重启自动发现。语音质量与选型详见文末「设计思路」。
- 参数与试听：语速 50%–200%、音色下拉、试听一句（用当前引擎 + 音色 + 语速直接合成播放）、「朗读时高亮当前段落并自动滚动正文跟随」开关。
- 从当前位置续读：从视口正在读的那句开始朗读（不必回到章首）；播放中可暂停/恢复、上一句/下一句、停止。
- 拖动正文 = 跟着换位置读：朗读中把正文拖到别处，播放队列自动切到新位置那句续读（旧合成音频随之清理，进度/高亮跟随）。
- 听书连读完全书：读到章末自动把下一章正文接到队尾并从新句起点续播，跨章无感，直到全书末尾置「已读完」。
- 防卡顿设计：合成分批（每批 15 句）+ 播放到批尾自动预取下一批；句间留 300ms 停顿更接近「一句一句」节奏；单句失败自动重试；停顿看门狗（2s 检查）同时盯合成与播放两类卡死，自动恢复。
- 听书进度跟读：书架进度随正在朗读的句子平滑推进。



### 底层能力（自动、用户基本无感）

- txt 编码自动检测：BOM 优先 → 采样统计（jschardet）→ UTF-8 兜底；结果回填书本，避免重复解析；文件内容变了且非手动指定编码时，会自动重新检测（不会用旧编码把新内容解成乱码）。
- 智能分章：能识别「第 N 章 / 序章·楔子·引子·正文 / 卷七 幽冥 / 1、初入江湖 / Chapter N / ☆★标题 / 【第 N 章】」等标题写法，并剔除文件前部紧邻无正文的「目录页」；对「每章正文压成一个长段、段首直接黏『第 X 卷第 Y 章 + 站点名/字数/日期』」的网抓文本，支持段内嵌章头抽取；实在没有可信章节结构时，整本作为一部连续内容（不做无意义的伪分章）。
- 大文件性能：解析全在主进程完成，12 本 LRU 解析缓存让重复打开秒开；正文按章/整本按需拉取，100MB 上限内的书也能流畅。
- 固定窗口 + 自绘标题栏：无边框、自定义标题栏（图标 + 标题 + 最小化 / 最大化还原 / 关闭，双击标题栏切换），窗口固定为「默认大小 / 最大化」两种状态——阅读正文时按住向下拖动不会误触窗口缩放。



## 快速开始

```bash
npm install
npm run dev
```

其他命令：

```bash
npm run typecheck      # 类型检查（vue-tsc web + tsc node）
npm run typecheck:web  # 仅渲染进程
npm run typecheck:node # 仅主进程 / preload
npm run build          # 构建（输出到 out/）
npm run preview        # 预览构建产物
```



## 目录结构

```
src/
  main/
    index.ts          # 主进程：窗口、设置持久化、txt 导入/编码检测/解析缓存、书名作者回填等 IPC
    txtParse.ts       # 纯函数：智能分章（含段内嵌章头）、书名/作者识别、智能去广告识别（detectAdParagraphs）
    tts.ts            # 语音合成分发：离线引擎队列泵 + 试听 + IPC（纯离线）
    ttsEngines.ts     # 语音引擎抽象 TtsEngine（统一接口）与资源目录定位 voiceRootDir
    piper.ts          # Piper 引擎：spawn piper.exe 逐句合成 WAV、残留清理
    sherpa.ts         # Sherpa-ONNX 引擎：模型扫描 + 逐句合成 WAV（原生 sherpa-onnx-node）
    declarations.d.ts # iconv-lite / sherpa-onnx-node 等缺失类型的手写声明
  preload/index.ts    # contextBridge 暴露 window.electronAPI（含全部 IPC 类型）
  renderer/
    index.html        # 入口 HTML
    main.ts / App.vue # 应用入口 + 根布局（全局标题栏 + 路由视图 + 亮色变量色板）
    router/index.ts   # 路由：/ 书架首页，/reader/:id 阅读页
    env.d.ts          # 渲染进程侧 electronAPI 类型（与 preload 同步声明）
    types/index.ts    # Book、AppSettings、IPC 传输类型
    stores/
      settingsStore.ts # 全局设置读写（settings.json：内存唯一真相 + 串行写盘 + 同步兜底）
      libraryStore.ts  # 书架：导入/排序/进度节流落盘/编码与书名回填/删除重命名
    views/
      Home.vue         # 书架首页（含阅读历史、关于、导入入口）
      Reader.vue       # 阅读页：整本正文渲染 + 断点恢复 + 智能排版 + 智能去广告隐藏 + 语音朗读
    components/
      layout/TitleBar.vue          # 无边框窗口自绘标题栏
      settings/SettingsDialog.vue  # 设置弹窗（阅读偏好 / 语音朗读 / 关于）
resources/
  icon.png            # 应用图标
  tts/                # 本地语音：<引擎>/app（引擎实际应用）+ <引擎>/model（模型），放入后自动发现
    piper/            # Piper：app/piper.exe 等；model/zh_CN-*.onnx + .onnx.json
    sherpa-onnx/      # Sherpa-ONNX：model/ 下放模型（matcha 模型组 + 共享 vocos 声码器）
```



## 配置说明

全局配置保存在应用目录下的 `settings.json`（开发态为项目根目录，打包后为 exe 所在目录，可随程序拷贝），已被 `.gitignore` 忽略。主要字段：

- `reading`：字号 / 行距 / 正文宽度 / 页面主题
- `tts`：朗读引擎（`piper` / `sherpa`，全部离线）、语速、音色、朗读高亮跟随
- `books`：书架记录（路径、大小、书名作者、编码、进度、全局段落号 + 段内偏移、最后阅读时间、该书「智能排版 / 智能去广告」开关等）
- `recentBooks`：最近阅读的书 id（按最近在前）



## 设计思路

两个智能功能（智能排版 / 智能去广告）共用同一条红线——只做展示层处理，绝不改动。原文与段落号。阅读进度 / 断点 / 书架进度都以「全书段落号 `paragraph` + 段内偏移」锚定，（章节只是给段落序列打包，切章不会改段落序），因此任何「增删、重排段落」都会让已存进度漂移。两个功能都只在「读者看到什么、朗读听到什么」上动手。



### 智能排版（智能分行）：把「一坨」长文重排成自然段

要解决的问题：网抓 txt 常把一整章甚至全书压成一行 / 几个超长段，段内无任何换行，
读起来是一大块不换行分段的文字。

- 数据流：工具栏「智能排版」是书级开关（`book.smartBreak` 随书记忆，默认关）。
  开启时正文不再逐段直出，改渲染 `Reader.vue` 里的 `smartRows`（computed 计算行）。
- 三步算法（都在 `Reader.vue`）：
  1. `smartReflowSentences`：按句末标点（。！？…）把长段切成一句句；句尾的闭引号（”』」）
     仍归上一句，不丢任何字符；
  2. `smartGroupBlocks`：把句子再攒回「自然段」。攒的过程中遇任一情况就断行成段：
     单段满 240 字封顶；叙述已攒 ≥4 句且 ≥130 字收段；当前段以闭引号收尾（一句话说完了）
     收段；下一句是对话引号开头时，先把当前叙述段收掉、让对话独立成段。一句话：对话独立
     成段、叙述攒句成段；
  3. `smartReflowParagraph`：长度 < `SMART_REF_MIN`(180) 的普通短段原样返回不重排，
     只处理真正「一坨」的超长段。
- 不破坏进度的关键：重排拆出的每个「视觉段」仍挂在同一个 `data-g`（原段全局段号）
  上。定位测量按 `data-g` 把一段的多个视觉块合并成「整段几何」（顶取最小、高取首块顶到
  末块底），段内滚动比例按整段算，重开断点恢复精确到段内。朗读完全不受它影响——朗读用自己
  的句子切分器 `splitForTts`，「分行视图」只管显示。**



白话说明：

第一步：切句子（`smartReflowSentences`）

- 做法：这一步确实是用句号、问号、感叹号来截断。
- 目的：把那一坨几千字的长文，切成一个“句子数组”。比如把“`他走了。她哭了。天黑了。`”切成 `["他走了。", "她哭了。", "天黑了。"]`。
- 细节：它很细心，会把对话结尾的闭引号（如 `”`）算在上一句里，保证文字不丢、不乱。
- 注意：到这里，它只是切出了“句子”，还没有开始“分段”。

第二步：攒段落（`smartGroupBlocks`）—— 这是最核心的“智能”

切出句子后，它开始像搭积木一样，把句子重新组合成“视觉段落”。在组合时，它严格遵守以下 4 个“阅读体验规则”：

1. 字数封顶（防长）：一段最多只能攒 240个字。如果攒着攒着到240字了，哪怕话没说完，也强制换行。这是为了防止重排后依然出现“一坨”长文。
2. 字数与句数底线（防碎）：一段至少要攒够 4句话 且 130个字 才能收段。这是为了防止出现“一句话一段”的碎屏现象，保证每段有足够的信息量。
3. 对话结束收段（顺逻辑）：如果当前攒的句子以闭引号（`”`）结尾，说明一个人说完了，立刻收段。
4. 对话独立成段（最关键的体验）：如果下一句是对话（以 “ 开头），它会立刻停止当前的叙述段落，让接下来的对话单独成段。
   - 为什么这样？ 因为网文中经常有“大段环境/心理描写 + 一句对话”的情况。如果不把对话独立出来，对话就会淹没在描写里，读者找对话很费劲。

总结成一句话就是：对话单独成段，叙述把几句话合在一起成段，且每段长度控制在 130~240 字之间。



### 智能去广告：隐藏网抓 txt 夹带的站点推广段

要解决的问题：从下载站 / 网页抓的 txt，正文里常被爬虫混入推广段（站点公告、更新地址、
「本章未完 点击下一页」、每章末尾重复的网址尾巴等），夹在章节间，读 / 朗读都突兀。

- 判定发生在主进程解析时（只在打开书时算一次，结果随解析缓存保存，不重复识别）：
  `src/main/txtParse.ts` 的 `detectAdParagraphs(paras)` 是纯函数——输入全书段落序列，
  输出「推广段的全局段号」数组（升序），绝不删 / 重排段落。两级判定，宁可漏、不可误删：
  1. 整段硬模板 `AD_HARD_PATTERNS`：整段几乎不可能是正文的站点措辞，例如
     纯网址 / 短链行、`本章未完…点击下一页`、站点署名尾（`笔趣阁小说网（www.biquge.info）`）、
     收藏 / 地址提醒（`请记住本站永久网址…`）；
  2. 跨章重复：注入广告的致命伤是「同一条文案每章都塞」。把每段归一化（去空白 + 小写）
     统计全书出现次数，同一文本出现 ≥3 次（`AD_REPEAT_MIN`）且带强站方措辞
     （`AD_STRONG_TOKEN_RE`：本站 / 下载 / 永久地址 / 公众号 / 加群 / 手机版…）才判推广。
     刻意不放「收藏 / 首发 / 求票」这类作者偶尔也写的宽泛词，避免误删作者章末感言；
     章末「（本章完）」这类正常标记也不删。
- 隐藏发生在渲染 / 朗读层（段落与段落号一律不动）：主进程把 `adParas` 随 `book:open`
  返回渲染层，Reader 建成集合后，`isAdPara(全局段号)` 让三条路径一起跳过推广段——
  ① 默认逐段渲染（`<p v-if>`）② 智能排版 `smartRows` ③ 朗读切句 `pushChunkSentences`
  （推广段不入句子表；因段号没有「首句记录」，朗读从该处起播时会自然向后找下一段）。
- 为什么不破坏进度锚：推广段是干脆不渲染成 `<p>`，而不是留空高 / `display:none`
  占位——空高节点会被「视口顶部量取」当成顶部段提前命中，把进度量到推广段上；完全不渲染则
  DOM 里只有真实正文段、段号又从 `data-g` 读，滚动测量与朗读永远落不到推广段。进度、断点、
  正文滚动条贴合全书进度都不受影响。
- 开关：`book.hideAds` 随书记忆、默认开启（只有用户关闭时才持久化该字段）。正文顶部
  提示「已隐藏 N 段站点推广/广告」并可一键「显示原文」。切换只清空并重建朗读句表，正文不重载、
  阅读位置不动。
- 想调强度 / 加规则看这里：识别阈值在 `src/main/txtParse.ts` 顶部常量（`AD_HARD_LEN_MAX`、
  `AD_REPEAT_MIN`、`AD_REPEAT_LEN_MIN/MAX`），模板正则表 `AD_HARD_PATTERNS` 直接增删即可；
  重排阈值在 `Reader.vue` 的 `SMART_REF_MIN` 与 `smartGroupBlocks` 里的内联判断。*



### 语音阅读

1、edge 的TTS 方案

该方案彻底抛弃，最后要全部丢弃掉这一块的代码，主要存在的问题就是会忽然卡顿，要求在线有网，朗读效果不好，朗读可能就崩溃了，不太受控。



2、Piper 

适合轻量级的语音模型，可以运行在很多小型的机器上面，只是因为它们都导出为 ONNX 格式且常用于 Home Assistant 等本地智能家居或离线配音场景，所以常被统称为“Piper 类”模型。

Piper 官方模型通常以 `vits-piper-` 开头。

使用Piper 需要一个 `.onnx` 文件加上一个配套的 `.json` 配置文件（里面定义了音素映射、采样率、说话人 ID 等）。并且 ONNX 模型内部的输入/输出节点名称是 Piper 引擎写死的。

推荐模型：`zh_CN-huayan-medium`（中文，女声，音质不错且兼容性好）或 `zh_CN-huayan-single`。可以在 Hugging Face 上搜索 `piper voices` 或访问 Piper 的官方模型仓库。



3、Sherpa-ONNX 推理引擎

需要下载的模型，需要 `.onnx` 声学模型文件，外加 `tokens.txt`（字典）、`lexicon.txt`（发音词典），通常还需要一个独立的声码器（Vocoder，如 `vocos.onnx`）。它的节点名称和数据处理流程与 Piper 完全不同。

支持Python安装，`pip install sherpa-onnx` ，还支持 npm， `npm install sherpa-onnx`

最推荐的模型：音质极好的 **`matcha-icefall-zh-baker`**（温柔女声，播音级），采用较新的 Matcha-TTS（基于条件流匹配 Conditional Flow Matching）架构，训练数据来自著名的 BiaoBei (Baker) 数据集，包含 12 小时的专业录音棚级单女声数据。得益于 Baker 数据集的录音棚品质以及 Matcha-TTS 架构的优势，它的发音清晰度、自然度、呼吸感和韵律通常是这三者中最好的，听起来最接近真人播音。

其他的模型还可以考虑下 vits-zh-hf-theresa、vits-zh-hf-fanchen-C。

可以去官网下载 jar，exe，安卓，鸿蒙，等等端， https://github.com/k2-fsa/sherpa-onnx/releases?spm=a2ty_o01.29997173.0.0.496455fbCCNQTi

官方模型下载库：https://k2-fsa.github.io/sherpa/onnx/tts/pretrained_models/index.html?spm=a2ty_o01.29997173.0.0.496455fbBmz9Ax

我们要下载 matcha 类型的，选择这个。

![image-20260904152224202](README.assets/image-20260904152224202.png)

找到 matcha-icefall-zh-baker 下载。

![image-20260904154147877](README.assets/image-20260904154147877.png)

这里直接下载即可，wget https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/matcha-icefall-zh-baker.tar.bz2

![image-20260904154711666](README.assets/image-20260904154711666.png)

还要下载声码文件：wget https://github.com/k2-fsa/sherpa-onnx/releases/download/vocoder-models/vocos-22khz-univ.onnx

最终解压后的，声码文件放进来，不解压。

![image-20260904160226388](README.assets/image-20260904160226388.png)





## 常见问题

- 启动崩溃 `Cannot read properties of undefined (reading 'on')`：部分环境（如某些 IDE / CI）预设了 `ELECTRON_RUN_AS_NODE=1`，会让 `electron.exe` 以纯 Node 模式运行。项目已在 `electron.vite.config.ts` 中自动移除该变量，若仍有问题可手动执行 `unset ELECTRON_RUN_AS_NODE && npm run dev`。
- Sherpa-ONNX 朗读没声音 / 报「找不到模型」：检查模型是否放对位置——`resources/tts/sherpa-onnx/model/`（可用 `<模型目录>/` 分组）内含声学模型（`model-steps-3.onnx` 或 `model.onnx`）、`tokens.txt`、`lexicon.txt`，并在组内或其上级放声码器 `vocos-22khz-univ.onnx`。放入后重启应用即自动发现。
- 朗读中途忽然没声音：多为该句合成 / 播放异常（本地引擎无网络断流问题）。应用会自动重启合成会话恢复（停顿看门狗）；若反复失败会提示，请检查语音引擎与模型文件是否就绪。
- 本地语音模型如何准备：应用不做在线下载，请自行把引擎/模型放入资源目录后重启——Piper：引擎放 `resources/tts/piper/app/`、模型放 `resources/tts/piper/model/`（`zh_CN-*.onnx` 与同名 `.onnx.json`）；Sherpa-ONNX：模型放 `resources/tts/sherpa-onnx/model/`（见上一条）。设置 → 语音朗读里选择引擎与音色。
- 书显示乱码：在阅读页底部状态栏点编码名，换一种编码即可；自动检测通常是准确的，乱码多见于中文站点文档用非 UTF-8/GBK 编码保存。



## 功能更新脉络

（git 提交主题归纳，便于了解功能演进）

1. 基础流程 → 去 AI 味 → 书架 UI 成型
2. 书本导入（选文件 / 扫文件夹）→ 自动编码识别 + 手动切换 → 重命名 / 删除 → 书架排序与历史
3. 大文件打开优化、精确进度记录与位置恢复（多次修复「重开回章节头」）
4. 语音朗读：接入 Edge TTS → 修复阅读/二次阅读卡顿 → 音色试听 → 阅读效果
5. 进度模型改为「全局段落号」锚定（参考成熟阅读 App 逻辑），重切章位置不漂移
6. 智能分章 / 书名作者自动识别 → 智能分页演进为「章节识别 + 段内嵌章头 + 整本一体」
7. 打开速度优化、章节目录展示与重构 → 新增书自动置顶
8. 本地 Piper 离线语音引擎（随包/一键下载）
9. 智能排版（智能分行）：网抓长文按句自动重排为自然段
10. 智能去广告：主进程识别站点推广段（整段硬模板 + 跨章重复检测），渲染 / 朗读层跳过隐藏（书级开关，可一键回看原文）