极简界面，硬核解析 —— 把难读的 TXT 目录，读清楚
1. 产品概述
何扰是一款以本地 TXT 纯文本为主力场景的阅读工具，由何扰软件工作室（HeRao Software Studio）开发。核心解决网文 TXT 目录解析困难的问题——面对目录难认、章节乱跳、标题样式不统一的 TXT 文件，何扰在您的设备上本地分析章节结构，让阅读重新变得顺畅。
核心能力
| 能力 | 说明 |
|---|
| 多模式目录解析 | 常规、探索、回响、超时空、秩感五种分析模式 |
| 语义光谱热力 | 内测版 基于本地 JSON 特征模型的段落打分与可视化（正式版不含） |
| 阅读档案 | 累计字数/时长/连续天数统计，支持云端同步 |
| 书架管理 | 本地导入、算法艺术封面 |
| 阅读增强 | 自动阅读、断行合并、正文搜索、笔记、可选字体 |
| 账户与云同步 | 注册登录、多设备绑定（最多 3 台）、云端 Pro 权益同步 |
支持格式
- TXT（主力）：纯文本，本地解析章节结构
- EPUB（有限支持）：可提取文字与目录，版式因书而异
版本说明
| 版本 | 获取方式 | 包名 |
|---|
| 国内正式版 | GitHub Releases 下载 APK | com.uutxtreader |
| 国际版 | Google Play | com.uutxtreader.intl |
| 内测版 | 开发者 sideload（不公开发布） | com.uutxtreader.internal |
公开发布包不含语义热力、可视化取证实验室及 PC 建模推送；第 9、15 节相关说明仅适用于内测版。
2. 安装与获取
国内版安装
- 访问 何扰 GitHub Releases
- 下载最新版
.apk 文件（herao-official-v*.apk）
- 核对 Release 页面提供的 SHA-256 校验值
- 在系统设置中允许「安装未知来源应用」
- 点击 APK 完成安装
国际版安装
在 Google Play 搜索「HeRao Reader」或直接访问 https://play.google.com/store/apps/details?id=com.uutxtreader.intl
系统要求
Android 8.0（API 26）及以上
请仅从何扰官方渠道获取安装包，自行承担第三方来源风险。
3. 快速入门
第一次使用
- 打开应用：首次启动进入书架页面（空白状态）
- 导入书籍：点击顶部右上角溢出菜单（⋮），选择「打开文件」或「本地导入」
- 自动解析：打开书籍后，何扰自动分析章节结构并生成目录
- 开始阅读：点击章节开始阅读，支持手势翻页
主界面导航
应用底部采用浮动导航栏，包含以下入口：
- 书架：管理所有导入的书籍
- 阅读档案：统计数据与洞察
- 设置：个性化配置
阅读时还会出现阅读器专用的顶部工具栏和底部章节进度条。
4. 书架与导入
所有书籍导入均通过书架页面右上角的溢出菜单（⋮）完成，提供两种导入方式。
打开文件
点击溢出菜单中的「打开文件」，调用 Android 系统文件选择器。您可以浏览设备存储中的任意位置，选择一个 TXT 或 EPUB 文件直接打开阅读。
- 适合单本快速打开，不经过书架
- 支持 TXT（
text/plain）和 EPUB（application/epub+zip）
- 打开后自动解析目录并进入阅读
本地导入
点击溢出菜单中的「本地导入」，弹出批量导入对话框。何扰会扫描设备存储中的 TXT 和 EPUB 文件，列出所有可导入的书籍供勾选，确认后批量加入书架。
- 适合批量添加多本书到书架
- 导入后书籍保留在书架中，随时继续阅读
- 支持 TXT 和 EPUB 格式
书架功能
| 功能 | 操作 |
|---|
| 搜索书籍 | 书架顶部搜索框按书名过滤（支持拼音） |
| 书籍排序 | 按书名、最近阅读、导入时间排序 |
| 删除书籍 | 长按进入多选模式后批量删除 |
| 多选导出 | 选中多本书后导出文件 |
| 书籍信息 | 查看文件大小、格式、编码等详情 |
算法封面
何扰会为每本书自动生成算法艺术封面——根据书名哈希生成独特的渐变色彩和几何图案，即使没有实体封面的 TXT 也能一眼辨认。可在设置中关闭此功能。
EPUB 导入
导入 EPUB 时，何扰提取文字内容和内嵌目录结构，转换为可阅读格式。复杂版式（表格、多栏、内嵌字体等）的还原效果因书而异。TXT 是主要使用场景，EPUB 为有限支持。
5. TXT 目录解析
这是何扰的核心能力。面对不同结构的 TXT 文件，提供五套分析模式。
5.1 日常主力模式（免费可用）
常规模式（默认优先）
- 适用场景：章节标题较规范的书——如常见的「第 X 章」「卷名 · 章节」等
- 特点：速度快、结果稳定，多数 TXT 默认走此路径
- 使用方式：目录页选择「常规模式」，或在章节识别中选择「自动识别」
探索模式
- 适用场景：标题写法比较「野」、卷标混用、常规方式目录仍对不齐时
- 特点：按这本书自己的行文习惯重新辨认章节，结果会被记住
- 使用方式：目录页选择「探索模式」，或在章节识别中主动切换
5.2 进阶模式 Pro/试用
回响模式
- 适用场景：常规与探索仍不满意时，用更强的分析梳理整本书的章节脉络
- 特点：适合结构特别难缠的文本
超时空模式
- 适用场景：排版个性明显的文本——古文、习惯使用非常规符号的书
- 特点：有概率识别出可用章节，效果因书而异
秩感模式
- 适用场景：以「第 1 章、第 2 章…」数字顺序为主线的长篇
- 特点：适合序号清楚但标题写法很杂的书
- 权限：目录页直接可用（秩感不依赖回响/超时空全局开关）
5.3 目录自动竞优 Pro/试用
可开启「自动选择目录解析模式」：何扰会先尝试常规，目录结构异常时自动升级到更强的分析模式，全程无需手动干预。还可开启「仅目录异常时竞优」子开关，仅在必要时才自动升级。
5.4 目录界面操作
- 模式切换：手动选择当前使用的解析模式
- 重新解析：切换模式后重新生成目录
- 章节跳转：点击章节标题快速跳转阅读
- 当前章节定位：阅读时点击目录自动定位到当前章节
6. 手势系统详解
何扰的阅读界面采用完整的手势交互体系。阅读页菜单中的「操作指南」按三步引导；以下文档结构与之一致，便于对照。
6.1 翻页与状态呼出
屏幕划分为三个纵向区域（左 30% / 中 40% / 右 30%）。
点击翻页与工具栏
| 区域 | 操作 | 效果 |
|---|
| 左侧 30% | 点击 | 上一页 |
| 右侧 30% | 点击 | 下一页 |
| 中间 40% | 点击 | 显示 / 隐藏顶部工具栏和底部进度条 |
滑动翻页（带动画）
| 手势 | 效果 |
|---|
| 从右向左横向滑动 | 翻到下一页 |
| 从左向右横向滑动 | 翻到上一页 |
滑动超过一定阈值后松手，页面以动画完成翻页；未超过阈值则回弹。
底部进度条拖拽
| 手势 | 效果 |
|---|
| 拖动底部 SeekBar | 在当前章节内快速定位阅读位置 |
松手后自动跳转到对应页面。进度条同时显示章节进度百分比。
6.2 调速与右缘手势
右侧边缘约 10% 宽度为感应区；进入自动阅读后，同一区域用于调速，并可配合全屏纵拖与左缘跟读校准。
普通模式 · 右侧边缘
| 区域 | 手势 | 效果 |
|---|
| 上半区 | 上下滑动 | 手势启动自动阅读 |
| 下半区 | 上下滑动 | 跳转热力段落 内测版 |
热力寻迹（内测版）需开启「语义可视化」与「内容审计界面」；上滑=上一个热力段落，下滑=下一个。触发时有触感反馈与 Toast 提示。
自动阅读 · 调速与进度
| 手势 | 效果 |
|---|
| 右侧约 10% 区域上下滑动 | 实时调整自动阅读滚动速度（上滑加快，下滑减慢） |
| 屏幕任意位置上下拖动 | 临时暂停自动阅读，手动拖动当前章节进度；松手后恢复 |
调速时屏幕中央会短暂显示当前倍速指示器。
左侧边缘跟读校准
| 手势 | 效果 |
|---|
| 左边缘按下后向下滑动 | 进入「跟读校准」模式，按实际阅读速度计算 CPM 并校准滚动速度 |
提示：首次启用自动阅读时尤为有用——先用跟读手势读 3~5 行，系统即可根据您的实际阅读节奏自动匹配合适的滚动速度。
自动阅读 · 点击翻页（补充）
| 区域 | 操作 | 效果 |
|---|
| 左侧 30% | 点击 | 上一页 |
| 右侧 30% | 点击 | 下一页 |
| 中间 40% | 点击 | 暂停/恢复 + 显示/隐藏工具栏 |
6.3 阅读舱与时空回溯
阅读舱统计
| 入口 | 操作 | 效果 |
|---|
| 底部状态栏区域 | 长按 | 打开阅读舱数据统计面板（进度、CPM、剩余时间等） |
| 阅读菜单 | 「阅读舱状态」 | 同上 |
时空回溯
在目录跳转、搜索跳转等产生阅读位置变化后，会记录回溯节点。有记录时左下角出现回溯图标（带数量角标）。
| 入口 | 操作 | 效果 |
|---|
| 左下回溯图标 | 点击 | 打开「时光胶囊」列表，点选节点回到当时位置 |
| 左下 / 右下感应区 | 上滑 | 同上 |
免费版列表显示 3 个节点；Pro 可保留更多回溯节点（以应用内说明为准）。
6.4 长按选词
| 操作 | 效果 |
|---|
| 长按正文任意位置 | 进入文字选择模式 |
| 拖动选区两端圆形拨杆 | 调整选区范围 |
| 拨杆拖到屏幕顶部/底部边缘 | 连续跨页翻动继续选择 |
| 选区内点击 | 弹出操作菜单（复制、搜索、添加笔记、反推正则） |
| 选区外点击 | 取消选择 |
自动阅读模式下长按选词行为与普通模式相同。
6.5 物理按键
7. 阅读体验
阅读器界面
何扰采用自研 Canvas 渲染引擎：
| 功能 | 说明 |
|---|
| 翻页动画 | 滑动翻页带弹性动画，支持横向滑动跟随 |
| 字体调整 | 字号、行距、字间距、段间距均可独立调节 |
| 夜间模式 | 纯黑或深灰背景 + 浅色文字，OLED 友好 |
| 阅读进度 | 底部 SeekBar 显示章节进度，顶部工具栏显示全书进度 |
| 断行合并 | 自动检测并合并硬换行，呈现流畅段落 |
| 自动阅读 | 全屏自动匀速滚动，支持手势调速和跟读校准 |
字体
支持系统内置字体和用户导入的自定义字体（通过字体选择器导入 .ttf 或 .otf 文件：设置 → 字体 → 从文件导入）。
自动阅读
自动阅读可通过以下方式启动：
Pro 可启用「智能初始化速度」：根据您在该书的历史阅读速度（CPM），自动计算匹配的初始滚动速度。
护眼提示
可在设置中开启「护眼提醒」：每隔 40/60/80/120 分钟，屏幕顶部弹出半透明提示条。点击自动消失。
阅读进度同步
应用自动记录每本书的最后阅读位置和章节，退出后重新打开自动恢复。同时记录阅读统计数据（字数、时长），用于阅读档案。
8. 搜索与笔记
全文搜索
| 模式 | 权限 | 说明 |
|---|
| 普通匹配 | 免费 | 精确匹配关键词 |
| 模糊匹配 | Pro/试用 | 容忍字符差异，扩大匹配范围 |
| 正则表达式 | Pro/试用 | 高级正则搜索 |
搜索结果以列表展示，点击跳转到匹配位置，匹配词高亮显示。
笔记
- 添加笔记：工具栏笔记按钮或长按选词菜单中选择
- 管理笔记：笔记列表查看、跳转、删除，支持附言
- 划线自动添加笔记：阅读设置中开启后，选中文本时自动添加笔记
9. 语义光谱热力
内测版 实验性能力。国内正式版与国际版 release 包不提供本节功能。
功能概述
在目录结构理顺后，使用本地 JSON 特征模型为正文段落打分，以半透明色带呈现语义「光谱」。帮助识别文本中的高能片段和结构异常点。
三层可视化
- 正文层热力背景：在阅读画布上按句段叠加热力底纹，可独立开关，默认约 30% 透明度。
- 目录语义染色：章节安全分驱动目录项色调，一眼看出置信度分布。
- 热力寻迹：跳转上一/下一热力段落。可在设置中开启「语义热力寻迹手势」，通过右侧边缘滑动触发。
模型管理
- 导入模型：通过系统文件选择器导入
.json 热力模型文件
- 网络调试：通过 PC 建模工作站 Wi‑Fi 推送（UDP 28257 发现）
- 模型切换：在实验性设置中选择当前使用的模型
模型格式
JSON 特征模型包含四种角色类型的规则：
| 角色 | 用途 |
|---|
| 氛围 | 环境描写、情绪铺垫 |
| 动作 | 打斗、移动、身体行为 |
| 巅峰 | 高潮、关键转折 |
| 催化剂 | 推动剧情的关键事件 |
每种角色包含关键词集、权重配置与 RGB 色值。
10. 阅读档案
统计数据
| 指标 | 说明 |
|---|
| 累计字数 | 阅读过的总字数 |
| 累计时长 | 阅读总时间 |
| 连续阅读天数 | 连续达成阅读目标的日期数 |
| 近 7 日分布 | 最近一周每日阅读字数柱状图 |
| 完本数量 | 已完全阅读的书籍数 |
| 接触书籍数 | 至少打开过的书籍数 |
统计长图导出 Pro/试用
- 权限：正式付费 Pro 可离线；试用/测试需联网并在首 7 天可用
- 功能：将阅读统计生成为可分享的长图
- 操作：阅读档案页点击导出按钮
云端同步 Pro/试用
- 功能：上传阅读统计数据到何扰服务器，换机后恢复
- 合并策略：云端与本地取大值，不丢失数据
- 操作：阅读档案 → 同步按钮
数据备份与恢复 Pro/试用
- 权限：正式付费可离线；试用/测试须登录
- 备份：将阅读档案导出为加密备份文件
- 恢复：从备份文件恢复阅读统计数据
- 存储位置：本地 SAF 目录或 WebDAV
11. 账户系统
注册与登录
何扰提供可选账户系统，用于云端同步和多设备管理。
- 注册：设置或权益中心 →「登录/注册」页面
- 输入用户名（全局唯一）
- 设置密码（≥ 6 位，不支持纯重复数字和连续序列）
- 可选设置密保问题
- 登录：输入用户名和密码
- 退出：登录态释放当前设备绑定
多设备管理
- 设备限制：单账号最多绑定 3 台设备
- 远程解绑：登录后可在设备管理列表踢出其他设备
- 紧急自救：当所有设备都被占用时，通过密保答案在登录页清空所有绑定
密码使用加盐哈希，不同用户即使相同密码在数据库中密文也不同。弱密码会被 C++ NDK 层拦截。设备 ID 通过 Android ID 脱敏后生成。
12. 授权与会员
档位说明
| 版本 | 说明 |
|---|
| 免费版 | 基础阅读与书架管理 |
| Pro 版 | 完整目录解析、阅读档案、云端同步与迁移等（不含内测版实验模块） |
获取 Pro
国内版（支付宝 / 微信）
- 设置 → 权益中心 → 选择套餐
- 选择支付方式（支付宝 App 支付 / 微信 App 支付）
- 完成支付后自动激活
| 套餐 | 价格 | 有效期 |
|---|
| 月卡 | ¥5 | 1 个月 |
| 季卡 | ¥15 | 3 个月 |
| 年卡 | ¥50 | 1 年 |
| 永久 | ¥150 | 长期有效 |
国际版（Google Play）
- 设置 → 权益中心 → 选择套餐
- 通过 Google Play 结算
- 自动激活
安装试用
新安装用户自动获得 7 天安装试用 Pro（算力离线可用）。试用/测试档导出与迁移需联网，且限新设备或新账户首 7 天；迁移与档案备份还须登录。
- 本地试用天数取安装与账号注册 min 封顶
- 设备首次联网后，算力试用与服务器记录的设备首见时间对齐；清数据重装不能刷满 7 天算力试用
- 试用导出限新设备或新账户首 7 天；清数据重装不能重复获得
- 登录老账号且非 Pro 时，试用天数不会超过该账号首次注册后的 7 天
SN 码激活
设置 → 权益中心 → 输入 SN 码，用于测试或赠送 Pro 授权激活。
测试 / 赠送 Pro 能力边界
- 与正式付费 Pro 算力一致（解析、阅读、档案视图等），可离线
- 导出与迁移：与安装试用相同，需联网并在首 7 天可用；迁移与备份须登录
- 正式付费 Pro 可离线导出与迁移
云端 Pro 权益同步
- 登录后自动拉取云端 Pro 到期时间
- 云端 Pro 有效时，本机即使过期也可继续使用 Pro 能力
13. 设置详解
阅读设置
| 设置项 | 说明 |
|---|
| 字号 | 阅读正文大小 |
| 行距 | 行与行之间的间距 |
| 字间距 | 字符间距 |
| 段间距 | 段落间的空白 |
| 字体 | 选择正文字体（支持导入自定义字体） |
| 翻页模式 | 滑动翻页动画 / 无动画直切 |
| 主题 | 日间 / 夜间 / 纯黑背景 |
| 护眼提示 | 定时提醒休息（间隔可选 40/60/80/120 分钟） |
解析设置
| 设置项 | 权限 | 说明 |
|---|
| 断行合并 | 免费 | 自动检测并合并硬换行 |
| 全局回响模式 | Pro/试用 | 对所有书默认启用回响分析 |
| 全局超时空模式 | Pro/试用 | 对所有书默认启用超时空分析 |
| 自动选择目录解析模式 | Pro/试用 | 目录异常时自动升级分析模式 |
| 仅目录异常时竞优 | Pro/试用 | 仅在必要时自动升级 |
搜索设置
| 设置项 | 权限 | 说明 |
|---|
| 搜索模式 | Pro/试用 | 普通 / 模糊 / 正则（免费仅普通） |
实验性功能
| 设置项 | 权限 | 说明 |
|---|
| 语义可视化反馈 | 内测版 | 开启热力可视化主开关（正式版无此项） |
| 网络热力调试服务 | 内测版 | 允许 PC 建模工作站推送模型 |
| 语义热力寻迹手势 | 内测版 | 右侧边缘手势跳转热力段落 |
阅读档案设置
| 设置项 | 权限 | 说明 |
|---|
| 档案本地备份 | Pro/试用 | 正式可离线；试用/测试须登录 |
| 档案恢复 | Pro/试用 | 正式可离线；试用/测试须登录 |
| WebDAV 备份 | Pro/试用 | 正式可离线；试用/测试须登录 |
| 自动备份 | Pro/试用 | 正式可离线；试用/测试须登录 |
数据管理
| 功能 | 权限 | 说明 |
|---|
| 完整迁移导出 | Pro/试用 | 正式可离线；试用/测试须登录 |
| 完整迁移恢复 | Pro/试用 | 正式可离线；试用/测试须登录 |
14. 数据迁移与备份
阅读档案备份 Pro/试用
- 导出：设置 → 阅读档案 → 备份 → 选择存储位置
- 恢复：设置 → 阅读档案 → 恢复 → 选择备份文件
- 格式：加密的何扰专用备份格式
完整迁移 Pro/试用
- 导出：设置 → 数据管理 → 完整迁移导出。包含：书架列表、阅读进度、阅读档案、设置偏好等；内测版另可含语义热力模型配置。存储位置：本地或 WebDAV。
- 恢复：设置 → 数据管理 → 完整迁移恢复。选择迁移包文件，恢复所有数据。
15. 语义建模工作站
内测版配套 需安装包名 com.uutxtreader.internal（应用名「内测版」）；正式版 App 无法接收推送。
简介
Windows 桌面工具，用于可视化编辑 JSON 热力模型，经 Wi‑Fi 推送到手机。
获取与安装
从 GitHub Releases 下载 herao-lab-workstation-v*.exe，核对 SHA-256 后运行。
连接流程
- 手机端准备：安装内测版 → 设置 → 实验性功能，开启「语义可视化反馈」和「网络热力调试服务」
- 电脑端：运行建模工作站，确保手机与电脑连接同一 Wi‑Fi，工作站自动发现手机 IP
- 编辑与推送：在工作站中编辑四种角色类型的规则和颜色，点击「推送到真机测试」实时生效
故障排查
| 现象 | 解决方案 |
|---|
| 搜寻超时 | 检查防火墙是否拦截 UDP 28257 |
| 无法推送 | 确认手机端网络调试服务已开启 |
| 颜色过深 | 默认约 30% 透明度，在调色盘选更淡颜色 |
| 找不到手机 | 确认同一 Wi‑Fi，尝试关闭 VPN |
16. 常见问题
目录解析
Q: 为什么某本书的目录不对？
尝试在目录页手动切换到「探索模式」重新解析。如果仍不理想，Pro 用户可尝试「回响」「超时空」或「秩感」模式。不同模式适用性因文本而异。
Q: 怎么知道当前用的是哪个解析模式？
目录页顶部显示当前模式名称，也可手动切换。
Q: 能保存某本书的解析结果吗？
探索模式会自动记忆当前书的解析结果，下次打开直接使用。
手势与阅读
Q: 自动阅读速度如何调整？
三种方式：① 右侧边缘上下滑动调速；② 左边缘下滑跟读校准；③ 底部的自动阅读控制面板调整倍速。
Q: 如何快速退出自动阅读？
点击屏幕中间区域或按音量键，可暂停自动阅读并显示工具栏，再次点击工具栏的自动阅读按钮关闭。
Q: 为什么有些 EPUB 显示不正常？
何扰对 EPUB 是有限支持（提取文字与目录）。复杂版式可能无法完美还原。TXT 是主要使用场景。
Q: 支持哪些编码的 TXT？
支持 UTF-8、GBK、GB2312、Big5 等常见中文编码，自动检测。
账户与授权
Q: 试用到期后会怎样？
到期后恢复为免费版，Pro 独占功能（回响/超时空全局模式、模糊/正则搜索等）将不可用。书架和阅读进度不受影响。语义热力等内测版能力不在公开发布包中。
Q: 换了手机怎么恢复 Pro？
登录同一账号，在权益中心点击「同步云端权益」。
Q: 为什么我的设备无法登录？
检查账号是否超过 3 台设备绑定上限。如所有设备均不可用，在登录页使用密保答案执行「紧急解绑」清空所有绑定。
Q: 测试 SN 和正式 Pro 有什么区别？
算力一致且可离线。导出与迁移与安装试用相同：需联网并在首 7 天可用；迁移与备份须登录。正式付费可离线导出与迁移。
数据
Q: 删除应用会丢失数据吗？
会。书架、阅读进度、档案统计等数据存储在应用内，卸载后不可恢复。建议在权限允许时定期导出完整迁移包。
Q: 如何备份数据？
设置 → 数据管理 → 完整迁移导出（正式付费可离线；试用/测试须登录）。
17. 联系与支持