极简界面，硬核解析 —— 把难读的 TXT 目录，读清楚
1. 产品概述
何扰是一款以本地 TXT 纯文本为主力场景的阅读工具，由何扰软件工作室（HeRao Software Studio）开发。核心解决网文 TXT 目录解析困难的问题——面对目录难认、章节乱跳、标题样式不统一的 TXT 文件，何扰在您的设备上本地分析章节结构，让阅读重新变得顺畅。
核心能力
| 能力 | 说明 |
|---|
| 多模式目录解析 | 常规、探索、回响、超时空等多种模式；可自动选优或目录页手动切换 |
| 阅读档案 | 累计字数/时长/连续天数统计，支持云端同步 |
| 书架管理 | 本地导入、算法艺术封面 |
| 阅读增强 | 自动阅读、断行合并、正文搜索、笔记、可选字体 |
| 账户与云同步 | 注册登录、多设备绑定（最多 3 台）、云端 Pro 权益同步 |
支持格式
- TXT（主力）：纯文本，本地解析章节结构
- EPUB（有限支持）：可提取文字与目录，版式因书而异
版本说明
| 版本 | 获取方式 | 包名 |
|---|
| 国内正式版 | GitHub Releases 下载 APK | com.uutxtreader |
| 国际版 | Google Play | com.uutxtreader.intl |
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/试用
回响模式
- 适用场景：常规与探索仍不满意时，用更强的分析梳理整本书的章节脉络
- 特点：适合结构特别难缠的文本
超时空模式
- 适用场景：排版个性明显的文本——古文、习惯使用非常规符号的书
- 特点：有概率识别出可用章节，效果因书而异
5.3 目录自动竞优 Pro/试用
在设置中开启「自动选择目录解析模式」（Pro/试用）后，何扰会对多种解析结果按目录结构评分并自动选出较合适的一种，一般无需您先手动挑选。还可开启「仅目录异常时竞优」：多数书只跑一轮解析，仅在目录结构异常或章节体量过大等情形才启用多模式竞优，以兼顾速度与效果。
5.4 目录界面操作
- 模式切换：对自动选优结果不满意时，在目录页手动选择解析模式
- 重新解析：切换模式后重新生成目录
- 章节跳转：点击章节标题快速跳转阅读
- 当前章节定位：阅读时点击目录自动定位到当前章节
6. 手势系统详解
何扰的阅读界面采用完整的手势交互体系。阅读页菜单中的「操作指南」按三步引导；以下文档结构与之一致，便于对照。
6.1 翻页与状态呼出
屏幕划分为三个纵向区域（左 30% / 中 40% / 右 30%）。
点击翻页与工具栏
| 区域 | 操作 | 效果 |
|---|
| 左侧 30% | 点击 | 上一页 |
| 右侧 30% | 点击 | 下一页 |
| 中间 40% | 点击 | 显示 / 隐藏顶部工具栏和底部进度条 |
滑动翻页（带动画）
| 手势 | 效果 |
|---|
| 从右向左横向滑动 | 翻到下一页 |
| 从左向右横向滑动 | 翻到上一页 |
滑动超过一定阈值后松手，页面以动画完成翻页；未超过阈值则回弹。
底部进度条拖拽
| 手势 | 效果 |
|---|
| 拖动底部 SeekBar | 在当前章节内快速定位阅读位置 |
松手后自动跳转到对应页面。进度条同时显示章节进度百分比。
6.2 调速与右缘手势
右侧边缘约 10% 宽度为感应区；进入自动阅读后，同一区域用于调速，并可配合全屏纵拖与左缘跟读校准。
普通模式 · 右侧边缘
| 区域 | 手势 | 效果 |
|---|
| 上半区 | 下滑 | 手势启动自动阅读 |
| 上半区 | 上滑 | 手势启动语音听书（需在设置中启用） |
自动阅读 · 调速与进度
| 手势 | 效果 |
|---|
| 右侧约 10% 区域上下滑动 | 实时调整自动阅读滚动速度（上滑加快，下滑减慢） |
| 屏幕任意位置上下拖动 | 临时暂停自动阅读，手动拖动当前章节进度；松手后恢复 |
调速时屏幕中央会短暂显示当前倍速指示器。
左侧边缘跟读校准
| 手势 | 效果 |
|---|
| 左边缘按下后向下滑动 | 进入「跟读校准」模式，按实际阅读速度计算 CPM 并校准滚动速度 |
提示：首次启用自动阅读时尤为有用——先用跟读手势读 3~5 行，系统即可根据您的实际阅读节奏自动匹配合适的滚动速度。
自动阅读 · 点击翻页（补充）
| 区域 | 操作 | 效果 |
|---|
| 左侧 30% | 点击 | 上一页 |
| 右侧 30% | 点击 | 下一页 |
| 中间 40% | 点击 | 暂停/恢复 + 显示/隐藏工具栏 |
6.3 阅读舱与时空回溯
阅读舱统计
| 入口 | 操作 | 效果 |
|---|
| 底部状态栏区域 | 长按 | 打开阅读舱数据统计面板（进度、CPM、剩余时间等） |
| 阅读菜单 | 「阅读舱状态」 | 同上 |
时空回溯
在目录跳转、搜索跳转等产生阅读位置变化后，会记录回溯节点。有记录时左下角出现回溯图标（带数量角标）。
| 入口 | 操作 | 效果 |
|---|
| 左下回溯图标 | 点击 | 打开「时光胶囊」列表，点选节点回到当时位置 |
| 左下 / 右下感应区 | 上滑 | 同上 |
免费版列表显示 3 个节点；Pro 可保留更多回溯节点（以应用内说明为准）。
6.4 长按选词
| 操作 | 效果 |
|---|
| 长按正文任意位置 | 进入文字选择模式 |
| 拖动选区两端圆形拨杆 | 调整选区范围 |
| 拨杆拖到屏幕顶部/底部边缘 | 连续跨页翻动继续选择 |
| 选区内点击 | 弹出操作菜单（复制、搜索、添加笔记、反推正则） |
| 选区外点击 | 取消选择 |
自动阅读模式下长按选词行为与普通模式相同。
6.5 物理按键
7. 阅读体验
阅读器界面
何扰采用自研 Canvas 渲染引擎：
| 功能 | 说明 |
|---|
| 翻页动画 | 滑动翻页带弹性动画，支持横向滑动跟随 |
| 字体调整 | 字号、行距、字间距、段间距均可独立调节 |
| 夜间模式 | 纯黑或深灰背景 + 浅色文字，OLED 友好 |
| 阅读进度 | 底部 SeekBar 显示章节进度，顶部工具栏显示全书进度 |
| 断行合并 | 自动检测并合并硬换行，呈现流畅段落 |
| 自动阅读 | 全屏自动匀速滚动，支持手势调速和跟读校准 |
字体
支持系统内置字体和用户导入的自定义字体（通过字体选择器导入 .ttf 或 .otf 文件：设置 → 字体 → 从文件导入）。
自动阅读
自动阅读可通过以下方式启动：
可在设置中启用「智能初始化速度」：根据您在该书的历史阅读速度（CPM），自动计算匹配的初始滚动速度；关闭后使用基线 800 字/分。
护眼提示
可在设置中开启「护眼提醒」：每隔 40/60/80/120 分钟，屏幕顶部弹出半透明提示条。点击自动消失。
阅读进度同步
应用自动记录每本书的最后阅读位置和章节，退出后重新打开自动恢复。同时记录阅读统计数据（字数、时长），用于阅读档案。
8. 搜索与笔记
全文搜索
| 模式 | 权限 | 说明 |
|---|
| 普通匹配 | 免费 | 精确匹配关键词 |
| 模糊匹配 | Pro/试用 | 容忍字符差异，扩大匹配范围 |
| 正则表达式 | Pro/试用 | 高级正则搜索 |
搜索结果以列表展示，点击跳转到匹配位置，匹配词高亮显示。
笔记
- 添加笔记：工具栏笔记按钮或长按选词菜单中选择
- 管理笔记：笔记列表查看、跳转、删除，支持附言
- 划线自动添加笔记：阅读设置中开启后，选中文本时自动添加笔记
9. 阅读档案
统计数据
| 指标 | 说明 |
|---|
| 累计字数 | 阅读过的总字数 |
| 累计时长 | 阅读总时间 |
| 连续阅读天数 | 连续达成阅读目标的日期数 |
| 近 7 日分布 | 最近一周每日阅读字数柱状图 |
| 完本数量 | 已完全阅读的书籍数 |
| 接触书籍数 | 至少打开过的书籍数 |
统计长图导出 Pro/试用
- 权限：正式付费 Pro 可离线；试用/测试需联网并在首 7 天可用
- 功能：将阅读统计生成为可分享的长图
- 操作：阅读档案页点击导出按钮
云端同步 Pro/试用
- 功能：上传阅读统计数据到何扰服务器，换机后恢复
- 合并策略：云端与本地取大值，不丢失数据
- 操作：阅读档案 → 同步按钮
数据备份与恢复 Pro/试用
- 权限：正式付费可离线；试用/测试须登录
- 备份：将阅读档案导出为加密备份文件
- 恢复：从备份文件恢复阅读统计数据
- 存储位置：本地 SAF 目录或 WebDAV
10. 账户系统
注册与登录
何扰提供可选账户系统，用于云端同步和多设备管理。
- 注册：设置或权益中心 →「登录/注册」页面
- 输入用户名（全局唯一）
- 设置密码（≥ 6 位，不支持纯重复数字和连续序列）
- 可选设置密保问题
- 登录：输入用户名和密码
- 退出：登录态释放当前设备绑定
多设备管理
- 设备限制：单账号最多绑定 3 台设备
- 远程解绑：登录后可在设备管理列表踢出其他设备
- 紧急自救：当所有设备都被占用时，通过密保答案在登录页清空所有绑定
密码使用加盐哈希，不同用户即使相同密码在数据库中密文也不同。弱密码会被 C++ NDK 层拦截。设备 ID 通过 Android ID 脱敏后生成。
11. 授权与会员
档位说明
| 版本 | 说明 |
|---|
| 免费版 | 基础阅读与书架管理 |
| Pro 版 | 完整目录解析、阅读档案、云端同步与迁移等 |
获取 Pro
在应用内查看当前档位、购买或激活 Pro：
- 设置 → 订阅与激活
- 阅读档案 → 当前状态（顶部档位卡片）
国内版支持支付宝 / 微信；国际版通过 Google Play 结算。套餐种类、价格与有效期以应用内页面展示为准，可能随时调整。
安装试用
新安装用户自动获得 7 天安装试用 Pro（算力离线可用）。试用/测试档导出与迁移需联网，且限新设备或新账户首 7 天；迁移与档案备份还须登录。
- 本地试用天数取安装与账号注册 min 封顶
- 设备首次联网后，算力试用与服务器记录的设备首见时间对齐；清数据重装不能刷满 7 天算力试用
- 试用导出限新设备或新账户首 7 天；清数据重装不能重复获得
- 登录老账号且非 Pro 时，试用天数不会超过该账号首次注册后的 7 天
SN 码激活
设置 → 订阅与激活 → 输入 SN 码，用于测试或赠送 Pro 授权激活。
测试 / 赠送 Pro 能力边界
- 与正式付费 Pro 算力一致（解析、阅读、档案视图等），可离线
- 导出与迁移：与安装试用相同，需联网并在首 7 天可用；迁移与备份须登录
- 正式付费 Pro 可离线导出与迁移
云端 Pro 权益同步
- 登录后自动拉取云端 Pro 到期时间
- 云端 Pro 有效时，本机即使过期也可继续使用 Pro 能力
12. 设置详解
阅读设置
| 设置项 | 说明 |
|---|
| 字号 | 阅读正文大小 |
| 行距 | 行与行之间的间距 |
| 字间距 | 字符间距 |
| 段间距 | 段落间的空白 |
| 字体 | 选择正文字体（支持导入自定义字体） |
| 翻页模式 | 滑动翻页动画 / 无动画直切 |
| 主题 | 日间 / 夜间 / 纯黑背景 |
| 护眼提示 | 定时提醒休息（间隔可选 40/60/80/120 分钟） |
解析设置
| 设置项 | 权限 | 说明 |
|---|
| 断行合并 | 免费 | 自动检测并合并硬换行 |
| 全局回响模式 | Pro/试用 | 对所有书默认启用回响分析 |
| 全局超时空模式 | Pro/试用 | 对所有书默认启用超时空分析 |
| 自动选择目录解析模式 | Pro/试用 | 在多种解析结果中按目录结构评分自动选优 |
| 仅目录异常时竞优 | Pro/试用 | 仅结构异常等情形才启用多模式竞优 |
搜索设置
| 设置项 | 权限 | 说明 |
|---|
| 搜索模式 | Pro/试用 | 普通 / 模糊 / 正则（免费仅普通） |
实验性功能
部分实验向开关以应用内实际显示为准；公开发布包可能不含全部实验项。
阅读档案设置
| 设置项 | 权限 | 说明 |
|---|
| 档案本地备份 | Pro/试用 | 正式可离线；试用/测试须登录 |
| 档案恢复 | Pro/试用 | 正式可离线；试用/测试须登录 |
| WebDAV 备份 | Pro/试用 | 正式可离线；试用/测试须登录 |
| 自动备份 | Pro/试用 | 正式可离线；试用/测试须登录 |
数据管理
| 功能 | 权限 | 说明 |
|---|
| 完整迁移导出 | Pro/试用 | 正式可离线；试用/测试须登录 |
| 完整迁移恢复 | Pro/试用 | 正式可离线；试用/测试须登录 |
13. 数据迁移与备份
阅读档案备份 Pro/试用
- 导出：设置 → 阅读档案 → 备份 → 选择存储位置
- 恢复：设置 → 阅读档案 → 恢复 → 选择备份文件
- 格式：加密的何扰专用备份格式
完整迁移 Pro/试用
- 导出：设置 → 数据管理 → 完整迁移导出。包含：书架列表、阅读进度、阅读档案、设置偏好等。存储位置：本地或 WebDAV。
- 恢复：设置 → 数据管理 → 完整迁移恢复。选择迁移包文件，恢复所有数据。
14. 常见问题
目录解析
Q: 为什么某本书的目录不对？
若已开启「自动选择目录解析模式」，可先等待自动选优完成；仍不理想时，在目录页手动切换模式（如「探索」「回响」「超时空」）并重新解析。不同模式适用性因文本而异。
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: 如何备份数据？
设置 → 数据管理 → 完整迁移导出（正式付费可离线；试用/测试须登录）。
15. 联系与支持