fqapp 番茄内容聚合 Android 客户端：小说/短剧/漫剧/听书/漫画，Flutter U @codeKK dartOpen Source Website

fqapp

Introduction: 番茄内容聚合 Android 客户端：小说/短剧/漫剧/听书/漫画，Flutter UI + 进程内 Rust 核心，无自建服务器、无需 root

Tags:

fqapp 是一个运行在 Android 手机本地 的番茄内容聚合客户端：小说阅读、短剧与漫剧播放、听书、漫画、搜索、历史和离线缓存在同一个 App 里完成。核心（签名、解密、缓存）都在手机上运行，不需要自建服务器，也不需要 root。

⚠️ 免责声明：本项目仅供学习与研究交流，不内置、不分发任何内容资源；在线内容均来自番茄公开接口，版权归字节跳动及原权利方所有。本项目与番茄/字节跳动无关联，未获其授权；使用产生的一切后果由使用者自行承担，如有侵权请联系删除。

功能一览

功能	说明
📖 小说阅读	图文正文与插图、左右分页或上下滚动、排版与字体导入、亮度调节、段评、离线缓存
🎬 短剧 / 漫剧	自动连播、倍速、上下集与快进快退、全屏方向自适应、进度续看
🖼 漫画	竖向连续阅读、章节目录、单图重试、点击放大、阅读位置恢复
🎧 听书	智能朗读与真人讲书、边听边读字幕、关联作品、定时关闭、倍速、自动下一章、进度续听
🗣 系统朗读	小说与本地 TXT/EPUB 正文朗读、已安装 TTS 引擎选择（如 MultiTTS）、语速设置、从本段听、自动下一章
🔍 搜索与发现	关键词 / 作品 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 显式查询；结果按综合、小说、短剧、漫剧、漫画、听书分栏展示，可先选分类再搜，同页更换关键词保留分类。关键词结果支持 8 分/9 分及以上筛选（仅筛选已加载结果，未知评分不计入），可切换并记住封面宫格或无封面列表。输入时有联想词，空查询显示热搜词。

读小说

左右分页与上下滚动两种翻页方式；正文两端对齐、首行缩进。阅读信息默认简洁（底部时间与全书进度），排版设置中可切换详细信息或关闭。
分页翻过本章最后一页直接进入下一章正文，反向翻页进入上一章末页；有评论数据时，可从阅读菜单查看本章评论。
排版面板实时调整字号、字重、字距、行距、段距、边距与阅读背景（四种主题），设置自动保存。
支持导入自定义字体（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：换手机怎样迁移收藏和进度？ 先退出阅读或暂停播放，在「设置 → 数据 → 备份与恢复」导出 JSON 文件，传到新手机后在同一页面选择文件，核对预览并确认合并。支持在线作品的收藏、阅读/播放进度和已看剧集；已有收藏和进度保留本机记录，已看剧集取并集，可重复导入。文件不包含本地 TXT/EPUB 书籍及其进度、下载缓存、阅读时长、划线和应用设置；本地书籍请另行保留原文件。暂不提供 WebDAV 同步。

请保留原备份文件。导入过程不清理历史，但应用后续日常保存仍沿用原规则：历史超过 100 条时，保留最近约 50 条；收藏不受此历史清理影响。

Q：需要登录或付费吗？ 不需要。App 没有登录、支付等任何账号功能。

Q：有 iOS 版吗？ 没有。当前仅支持 Android（arm64）。