sakura-read

项目概述

樱读（Sakura Read）是一款二次元风格的 Android 小说阅读器，使用 Flutter 编写。它既能阅读本地 TXT 与 EPUB，也能导入「阅读 3.0」格式的书源在线搜书，还塞进了一只会在屏幕上陪读、撒娇甚至捣乱的看板娘桌宠。适合喜欢日系界面、希望阅读器多一点陪伴感的用户。

在樱花树下，慢慢读完一本书。

主要功能

• 本地阅读：TXT（自动探测 UTF-8、UTF-16、GBK 编码）与 EPUB（EPUB2/EPUB3 双目录解析并提取封面）
• 沉浸阅读器：滑动、覆盖、淡入、滚动四种翻页，字号行距字距页边距可调，六种背景与日夜切换
• 语音朗读：系统 TTS 按段落朗读，语速音调实时可调，朗读自动跟随并整章连播
• 在线搜书：导入书源 JSON 后多源并发搜索，同名同作者自动合并排序，支持一键换源并保留进度
• 书源引擎：支持 CSS、JSONPath、XPath、正则与模板规则，并用隐藏 WebView 穿透令牌墙与 SPA 路由
• 阅读统计：累计时长、近七天柱状图、连续阅读天数与读完书数
• 看板娘桌宠：全局悬浮可拖动，点击摸头互动、亲密度七级、打瞌睡与生气等状态
• 检查更新：启动静默检查，多线路镜像下载后一键调起安装器

适用人群

• 喜欢二次元界面与看板娘陪伴的读者
• 需要在手机上阅读 TXT 与 EPUB 的用户
• 使用阅读 3.0 书源找书的用户
• 习惯用 TTS 听小说的用户

快速上手

1. 从 Releases 下载最新 APK 安装，首启阅读并同意使用条款，授予文件访问权限
2. 点书架右下角「＋」导入本地 TXT 或 EPUB，也可扫描常见目录批量导入
3. 在线看书：点书架右上角放大镜，输入书名后进入结果详情页并「加入书架」
4. 在阅读器中点击屏幕中部调出菜单，调整排版、主题或开启朗读
5. 在设置中可关闭「阅读时显示桌宠」，也可重看新手引导

核心优势

• 格式齐全：本地 TXT 与 EPUB 通吃，封面缺失时按书名稳定分配插画
• 书源兼容：以独立 Dart 实现阅读 3.0 规则，用现成书源也无需复制 GPL 代码
• 阅读顺滑：跨章连页与相邻章节静默预加载，翻页不卡顿
• 有陪伴感：看板娘会随互动变化表情与台词，阅读不再单调

系统要求

项目	要求
操作系统	Android 7.0（API 24）及以上
框架	Flutter 3.x（仅从源码构建时需要）
朗读	需系统安装 TTS 引擎

注意事项

• 应用是阅读工具，不捆绑、不分发、不存储任何受版权保护的书籍内容
• 第三方书源站点经常改版或关闭，搜不到书时可停用失效源或导入自己的书源
• 朗读没有声音通常是系统未安装或未设默认 TTS 引擎，可在系统设置中检查
• 内置书源含公版内容源与第三方聚合源，第三方内容版权归原站与原作者