fqapp — 番茄小说/短剧/漫剧/听书/漫画聚合客户端
fqapp 是一个运行在 Android 手机本地 的番茄内容聚合客户端：小说阅读、短剧与漫剧播放、听书、漫画、搜索、历史和离线缓存在同一个 App 里完成。核心（签名、解密、缓存）都在手机上运行，不需要自建服务器，也不需要 root。
⚠️ 免责声明：本项目仅供学习与研究交流，不内置、不分发任何内容资源；在线内容均来自番茄公开接口，版权归字节跳动及原权利方所有。本项目与番茄/字节跳动无关联，未获其授权；使用产生的一切后果由使用者自行承担，如有侵权请联系删除。
功能一览
| 功能 | 说明 |
|---|---|
| 📖 小说阅读 | 图文正文与插图、左右分页或上下滚动、排版与字体导入、亮度调节、段评、离线缓存 |
| 🎬 短剧 / 漫剧 | 自动连播、倍速、上下集与快进快退、全屏方向自适应、进度续看 |
| 🖼 漫画 | 竖向连续阅读、章节目录、单图重试、点击放大、阅读位置恢复 |
| 🎧 听书 | 智能朗读与真人讲书、边听边读字幕、关联作品、定时关闭、倍速、自动下一章、进度续听 |
| 🔍 搜索与发现 | 关键词 / 作品 ID 搜索、搜索联想词与热搜、排行榜、作者主页、书评 |
| 📋 详情 | 封面、分类、完结状态、字数、评分、标签、简介、目录预览、书评、关联作品 |
| 🕘 历史与书架 | 阅读/播放进度自动记录，续读续看；离线缓存管理 |
| ⬇️ 下载 | 整本缓存、批量缓存后续章节，下载内容不受自动清理影响 |
下载与安装
设备要求
- Android 7.0（API 24）及以上，arm64-v8a 设备（绝大多数近几年的手机）。
- 需要网络：在线内容实时从番茄上游获取，App 本身不内置任何内容。
- 不需要 root。
获取安装包
推荐：GitHub Releases —— 下载最新发布版的
fqapp-<版本>-arm64.apk，同一发布页附 SHA256SUMS 与 verify-report.json（签名、16 KiB 对齐等
8 项校验的原始报告），可自行核对。
其他方式：
- GitHub Actions 云端构建：打开仓库的 Actions → Android APK，点击 Run workflow 运行一次构建；成功后在本次运行的 Artifacts 中下载
fqapp-arm64-运行编号，解压得到app-release.apk（同样附带校验报告；产物仅保留 14 天，需要长期留存请用 Releases）。 - 本地构建：需要 Flutter / Rust / Android NDK 工具链，步骤见 DEVELOPMENT.md。
在 fork 中构建：正式签名的密钥只对上游仓库可用，fork 出来的构建拿不到它。此时工作流 会自动改为产出未签名包并在日志里给出警告，其余校验（16 KiB 对齐、原生库完整性）照常 执行。未签名包只能全新安装，无法覆盖安装到正式签名版本之上，也不能作为正式发布包。
安装与首次启动
- 安装 APK（直接点击安装，或
adb install fqapp-<版本>-arm64.apk）。 - 首次启动时 App 自动完成初始化：部署运行资源 → 启动本地核心并注册设备 → 健康检查通过后进入主界面。首次请保持联网。
- 之后即可随时离线打开 App，阅读已缓存的内容。
⚠️ 签名与升级：正式签名与调试签名的包不能互相覆盖安装。Releases 与 Actions 产出的 release 包使用正式签名；从旧签名版本（v1.0.17 及更早）升级需要先卸载再安装，卸载会同时清除阅读历史与缓存。同签名版本可直接覆盖升级。
快速上手
找内容
- 首页：推荐流混排小说、短剧、漫剧、漫画、听书，可下拉刷新；推荐不可用时自动回退分类搜索。
- 搜索：支持关键词与作品 ID 两种方式——输入 15–20 位纯数字自动按 ID 查找，也可用
id:作品ID显式查询；结果按综合、短剧、漫剧、漫画、听书分栏展示。输入时有联想词，空查询显示热搜词。
读小说
- 左右分页与上下滚动两种翻页方式；正文两端对齐、首行缩进，页眉页脚显示书名、进度、时间和电量。
- 排版面板实时调整字号、字重、字距、行距、段距、边距与阅读背景（四种主题），设置自动保存。
- 支持导入自定义字体（TTF/OTF/TTC，单文件不超过 32 MB）。
- 亮度可手动调节或跟随系统，只影响阅读界面，退出或切后台自动恢复。
- 有段评的段落会在行内显示评论数气泡，点击查看该段评论。
- 点击正文中央呼出菜单：目录（可搜索、倒序、定位当前章）、排版、缓存。
看短剧 / 漫剧
- 自动连播：一集播完自动下一集；支持选集、上下集、快进快退 10 秒和全屏。
- 0.75–2 倍速可保存；长按画面临时 2 倍速。
- 全屏方向按视频比例自适应（横屏剧集横屏、竖屏剧集竖屏），也可锁定方向。
- 播放进度自动记录，随时续看。
听书
- 智能朗读与真人讲书两种模式，多个音色可切换，切换时保留播放位置。
- 边听边读字幕，当前句自动高亮并预览下一句。
- 支持后台继续播放（可在设置中开关）与通知栏播放控制；断开耳机或蓝牙时自动暂停。
- 定时关闭（15/30/60 分钟）、倍速、上下章、进度拖动与 ±15 秒快退快进。
- 播放进度与音色选择自动保存，重新进入续听。
看漫画
- 竖向连续阅读，按章节切换；图片按需加载，单张失败可重试，点图可放大。
- 用「图片序号 + 图片内位置」记录进度，图片加载改变高度后仍保持续读位置。
缓存与离线
- 详情页「下载」一键缓存整本（从续读位置起，进度显示在底栏）；阅读器「缓存」面板可批量下载后续 20/50/100 章。
- 自动缓存有上限（500 章或 80 MB，超出后清理最久未读的章节）；「下载」缓存的内容不受此限制，一直保留到手动删除。
- 书架页右上角「离线缓存」可直接打开已缓存书籍，不依赖网络。
- 设置 → 数据 → 章节缓存：查看占用、删除单本或清空全部。
常见问题
Q：启动时一直停在初始化 / 健康检查失败？ 首次启动需要联网完成设备注册，请检查网络后重试；运行状态可在「我的 → 服务状态」查看。
Q：正文显示乱码 / 视频解密失败？ 多为设备注册过期：清除应用数据后重新打开，App 会自动重新注册设备（注意：清除应用数据会同时清除阅读历史与缓存）。
Q：搜索、详情或播放突然失败？ 内容全部来自上游接口，上游调整或网络波动都会临时影响，可稍后重试。本项目没有自己的服务器，无法绕过上游的临时变更。
Q：下载的内容保存在哪？ 保存在应用私有目录，不进入相册等公共空间；在应用内「设置 → 数据 → 章节缓存」管理。
Q：需要登录或付费吗？ 不需要。App 没有登录、支付等任何账号功能。
Q：有 iOS 版吗？ 没有。当前仅支持 Android（arm64）。
许可与免责声明
本项目代码以 GPL-3.0 协议开源，Copyright (C) 2026 ch6vip。
本项目仅供学习与研究交流，不内置、不分发任何内容资源；在线内容均来自番茄公开接口，版权归字节跳动及原权利方所有。本项目与番茄/字节跳动无关联，未获其授权；使用产生的一切后果由使用者自行承担，如有侵权请联系删除。请遵守相关法律法规，仅限个人学习研究使用。
致谢（Acknowledgments）
Thanks to the LINUX DO community for its support and feedback.
感谢 LINUX DO 社区的支持与反馈。
开发者
架构、构建、API 对接、调试与开发计划等开发向文档见 DEVELOPMENT.md；构建与维护脚本说明见 scripts/README.md。