Files
LFReader/docs/LFReader-构想与调研.md
T
2026-10-28 17:58:30 +08:00

383 lines
25 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# LFReader · 构想与调研记录
> 状态:草案 v0.3 | 更新:2026-10-28 | 范围:个人自用,不对外分发
> 命名:项目名 **LFReader**。首期唯一上游是番茄小说,但产品、接口与数据模型都不绑定单一来源(见 4.3)。
---
## 1. 目标
### 1.1 硬约束
| 约束 | 说明 |
|---|---|
| 墨水屏优先 | 手机、平板、墨水屏三端都要能用;墨水屏不是“顺便支持”,而是主要使用场景 |
| 目标机型 | 主用掌阅 Tango2(6.13" / 1648×842 / 300ppi / SmartOS);手机、平板为辅助端 |
| 段评只读 | 书评、章评、段评都要能看,但不点赞、不发评论、不写任何内容 |
| 自己的账号 | 使用本人番茄账号登录,可开通 VIP;不为“免付费”做任何绕过 |
| 自建服务 | NAS 上跑一个 Docker 个人书库服务,作为唯一上游出口与缓存中心 |
| 官方书架同步 | 只读拉取番茄官方书架/进度,本地书架为准,不回写 |
### 1.2 产品形态
```
Android 阅读客户端(手机 / 平板 / 墨水屏)
↕ 内网 / Tailscale(外出时经 Cloudflare Tunnel 或 frp,TLS + 固定 Token)
NAS 上的 LFReader 服务端(Docker:账号会话 + 取数 + 缓存 + 书库 + 导出)
↕
番茄官方账号与内容接口
```
### 1.3 使用环境
- **客户端**:主用掌阅 Tango2(墨水屏,掌阅 SmartOS,支持安装第三方应用);手机/平板用于碎片阅读与调试。
- **服务端**:NAS 上的 Docker 容器,日常只走内网;外出阅读经 Cloudflare Tunnel 或 frp 访问,入口用**启动时注入的固定 Token** 鉴权。
- **预期而非需求**:翻页水波纹等动效。这类效果由设备刷新策略或阅读器自身实现决定,第三方应用未必可控,不作为验收项。
### 1.4 明确不做
- 不做付费章节破解、设备权益伪造、代理池、批量注册。
- 不做公开下载站、共享书库、资源分发。
- 不做评论/点赞/刷时长等任何写操作。
- 首期不接番茄以外的**实际书源**;但接口与数据模型必须为多源预留(见 4.3)。
---
## 2. 结论先行
1. **客户端用 Flutter**,一套代码覆盖手机/平板/墨水屏;墨水屏刷新优先接厂商插件,掌阅若不开放则退化为“零动画 + 系统快刷档”(见 §7)。Tauri 2 因为依赖系统 WebView,残影与老设备兼容性不可控,不作为主选。若只锁定少数机型,Kotlin + Compose 是更稳的备选。
2. **服务端用 Rust(axum + SQLite)**,单容器、单二进制、镜像小,签名与协议实现方便做黄金向量测试;Go 是最省心的备选。
3. **取数依靠“自己的账号 + VIP”解决授权问题,签名与设备身份解决传输问题**,两者独立。段评只有 App 通道有完整数据,是必须保留的一环。
4. **同步只做单向拉取**:官方书架 → 本地书库;本地进度不回写,避免以账号身份产生写行为。
5. **真正的可靠性来自“多源回退 + 整本缓存 + 服务端集中限速”**,而不是某一个接口的稳定性。
6. **找书四件事(搜索 / 推荐 / 榜单 / 分类)都能取到**,但除头条搜索外几乎都落在 App 通道 → 设备身份是**长期维护成本**,不是一次性搭建成本。
7. **多源是架构要求,不是首期功能**:源适配器与内部 ID 映射现在就留好,将来加第二源不用改客户端。
8. **部署以“内网为常态、外网为附加”**:Cloudflare Tunnel / frp 只做通道,鉴权靠固定 Token,公网只开放只读面。
---
## 3. 现状调研(首期源:番茄小说)
### 3.1 fqapp(什锦铺)
- 形态:Flutter UI + 进程内 Rust 核心(`libfqapi_core.so`),无自建服务器,GPL-3.0。
- 取数:番茄 App 端接口(`aid=1967`)+ 虚拟设备池 + Argus551/Ladon 签名 + 设备 `secret_key` 解密;另开 `127.0.0.1:18921` 的 loopback 供 Legado 等外部阅读器调用。
- 覆盖:搜书、目录、正文、书评、段评、插图、听书、短剧、漫画,最全。
- 可借鉴:段评接口与解密链路的协议参考;`/api/v1/*` 的归一化设计;Rust 核心的签名/设备分层。
- 不建议照搬:设备池轮换、给虚拟设备发 30 天权益那一套(滥用风险最高、最易被封),以及它整体偏重的实现。
### 3.2 POf-L/Fanqie-novel-Downloader
- 形态:Tauri 系跨平台打包(发布脚本含 `cargo-tauri`),Windows/macOS/Linux/Android/iOS;**应用源码未公开**,仓库只放 Issue 表单、发布脚本与文档。
- 功能:搜书、TXT/EPUB 下载、阅读器、**段评浏览**、**番茄官方书架登录后同步**、漫画/短剧、本地书导入、`fanqie serve`(本机/局域网服务)。
- 产品边界(写在 CONTRIBUTING 里,值得直接照抄):
- 不解锁付费、会员或未上架内容,只读“接口本来就返回给当前账号或游客”的内容;
- 不对抗风控:限速、熔断、冷却;设备轮换默认关闭;
- 不做公开下载服务、共享书库;`serve` 只用于本机或自己的局域网;
- 不自建账号体系、不运营云同步;书架只走番茄官方;
- 不写评论、不点赞、不刷时长;只读段评保留;
- 只做番茄系,不做通用书源。
- 对本案的价值:**它已经验证了“自有账号 + 只读段评 + 官方书架 + 本地服务”这条产品路线是可行的**;同时说明 Tauri 能跑 Android,但解决不了墨水屏(残影、老 WebView、无 EPD 控制)。
### 3.3 其他参考项目
| 项目 | 技术 | 取数方式 | 可参考点 | 局限 |
|---|---|---|---|---|
| `h13637404183-hub/fanqie-api` | Python/Flask,Docker | 番茄 PC 网页 API + HTML 解析 | REST 设计、Docker 部署、详情/目录/正文的网页通道 | 无评论;搜索需移动端签名,直接用网页通道做不了 |
| `denniemok/fanqie-novel-reader` | React PWA | 自建代理 + 多个第三方 API 镜像 | 阅读器 UI、PWA 离线、繁简转换、API 健康监控 | 后端代理不公开,依赖镜像,随时失效 |
| `shing-yu/fanqie-novel-download` | Python | 早期网页抓取 | 正文 DOM 与字符映射处理 | 维护停滞,接口已变 |
| `youshen2/Sine-NovelDownloader` | - | 第三方“鲸落 API” | 多源切换思路 | 依赖第三方服务 |
| `legado`(阅读)书源生态 | Kotlin | 规则化书源 | 书源规则与章节缓存模型 | 番茄源质量参差,评论基本没有 |
### 3.4 三条取数通道对比
| 通道 | 覆盖 | 稳定性 | 账号依赖 | 结论 |
|---|---|---|---|---|
| A. 头条小说通道(`aid=13`):`api.fanqiesdk.com` 搜索、`novel.snssdk.com` 目录/正文 | 搜书/目录/正文 | 中 | 弱(device/openudid;正文需 DH 解密) | **正文主力**,实现成本最低 |
| B. 网页端 `fanqienovel.com` | 搜书/目录/正文/书评 | 中 | 中(`a_bogus`、`msToken`、字体映射、风控) | 兜底与详情补充;搜索覆盖有限 |
| C. App 端(`aid=1967`) | 全,含**段评**、插图 | 低-中 | 强(设备 + 签名 + `secret_key`) | **只为段评和缺失章节保留** |
关键判断:**A 和 B 都拿不到完整的段评**。段评是硬需求,所以 C 无法完全去掉;但可以把 C 的使用范围压到“只读评论 + 兜底正文”,账号用本人 VIP,不做设备池。
### 3.5 账号与 VIP 能解决什么
| 能解决 | 不能解决 |
|---|---|
| 付费/VIP 章节的访问授权(自己付费) | 反爬签名(`a_bogus` / Argus / Ladon) |
| 官方书架、阅读进度、分组 | 设备绑定与会话风控 |
| 降低“虚拟设备领权益”这类高风险做法 | 段评数据仍只在 App 通道 |
| 让整条链路在道义与版权上更站得住 | 上游接口变更后的维护成本 |
一句话:**账号是授权层,签名是传输层,两者不能互相替代。**
### 3.6 找书能力盘点(搜索 / 推荐 / 榜单 / 分类)
| 能力 | 上游端点 | 通道 | 可得性 | 备注 |
|---|---|---|---|---|
| 搜书(主) | `/reading/bookapi/search/tab/v` | C | 高 | 支持 `tab_type` 与翻页;登录态下结果更全 |
| 搜书(轻签名) | `api.fanqiesdk.com/.../search/v1` | A | 高 | `aid=13`,签名要求最低,适合作主力或回退 |
| 搜索联想 | `search_predict` | A/C | 高 | 输入补全,非必需 |
| 热搜 / 搜索落地页 | `/reading/bookapi/plan/v`(`scene=10`) | C | 高 | 返回 `search_tag_data` 聚合,可当“热门搜索” |
| 推荐流(书城首页) | `/reading/bookapi/bookmall/tab/v` | C | 中 | 按 `tab_index` 返回 `cell_data[]`,`offset` 翻页;是运营位而非个性流 |
| 频道表 | 同端点,带 `tab_type` / `last_tab_type` | C | 中 | `tab_item[]` 的 `title` / `tab_type` 即频道条,服务端配置驱动 |
| 榜单 | `rank_data`(`cell_id = rank_id`) | C | 中 | 参数含 `genre_tab`、`rank_sub_info_id`、`offset`;榜单名集合见 `main_algo_name`(推荐/完本/新书/书友/追更/黑马/巅峰/书荒/礼物/阅读/作者榜) |
| 分类页 | `/reading/bookapi/new_category/front/v` | C | 高 | 男频/女频 + 分类瓦片,一次返回整页 |
| 书籍详情 | 详情/分享类端点 | A/B/C | 高 | 三通道都有,按可用性挑 |
| 书评 | `book_reviews` / `idea_list` | C | 高 | 与段评同族接口 |
结论:
1. **四件事全部可得**,形态统一为“服务端聚合 → 客户端只读列表”,不需要客户端自己拼接口。
2. 除头条搜索外几乎全在 App 通道(`aid=1967` + 设备签名)。所以“去掉设备身份、只留网页通道”会在**找书上**明显退化:网页端搜索覆盖窄,推荐/榜单/分类基本没有。
3. 榜单的 `rank_id` 不是稳定常量表,通常要从推荐流的 `cell_data` 里取 → 服务端必须缓存一份“榜单目录”,否则客户端无法自己拼(列入 §11 待验证)。
4. 推荐流是**运营位**,字段随版本变动概率高,客户端要把“区块解析失败”做成静默降级,而不是报错。
---
## 4. 目标架构
```mermaid
flowchart LR
subgraph Clients["LFReader 客户端"]
E[墨水屏设备]
P[手机 / 平板]
end
subgraph NAS["LFReader 服务端(NAS)"]
API[REST / OPDS]
CORE[源适配层<br/>限速 · 重试 · 熔断]
ACC[账号会话<br/>Cookie / 设备身份]
DB[(SQLite + 书库文件)]
EXP[EPUB / TXT 导出]
end
F[番茄官方接口<br/>书架 / 目录 / 正文 / 段评]
E -->|内网 / Tailscale| API
P -->|内网 / Tailscale| API
E -.->|外出| T["Cloudflare Tunnel / frp<br/>TLS + 固定 Token"]
T -.-> API
API --> CORE
CORE --> ACC
CORE --> DB
CORE --> F
F --> CORE
ACC -->|只读拉取| F
DB --> EXP
EXP --> API
```
### 4.1 NAS 服务职责
1. 保存账号 Cookie 与设备身份(加密存储),维持会话,过期时提示重新登录。
2. 集中做签名、限速、重试、熔断——客户端永远不直接访问上游。
3. 搜书、详情、目录、正文、书评/段评的归一化与缓存。
4. 书库存储:整本正文、评论快照、封面、EPUB/TXT 导出。
5. 书架同步:只读拉取官方书架与进度,合并到本地书库。
6. 对外只暴露 REST + OPDS;内网直连,外网经 Cloudflare Tunnel / frp 转发,入口固定 Token 鉴权(见 6.4),不做路由器端口映射。
### 4.2 客户端职责
1. 只做 UI 与本地阅读:分页、主题、字体、离线包管理。
2. 从 NAS 下载“整本包”(元数据 + 目录 + 已缓存章节 + 评论快照),断网可读。
3. 阅读进度本地保存,可选上报给 NAS;不回写官方。
4. 墨水屏专项:全刷策略、无动画、按键翻页、低内存。
### 4.3 多源预留(当前只做番茄,但不做死)
原则:**能力接口化、源实现可插拔、内部 ID 与外部 ID 解耦。**
1. 统一领域模型:Book / Chapter / Comment 只存在于内部;源特有字段一律进 `raw_json`,不污染主表。
2. 源适配器契约(每个源实现同一组方法,缺的能力显式返回 `Unsupported`):
`search(q, page)`、`detail(ext_id)`、`catalog(ext_id)`、`chapter(ext_id)`、`book_comments(ext_id)`、`paragraph_comments(chapter_ext_id)`、`shelf()`、`progress()`。
3. 能力矩阵:每个源声明 `capabilities {search, recommend, rank, category, comments, paragraph_comments, shelf}`;客户端据此隐藏 UI,而不是“调用后才发现没有”。
4. ID 解耦:内部 `books.id` 用 ULID;`book_sources(book_id, source, ext_id, is_primary)` 承担映射,一本书可挂多个源。
5. 结构归一:卷/章统一映射为 `(volume, idx)`;正文用内容 hash 做跨源去重,为将来“换源续读”留位。
6. 选源策略:未指定源时按 `sources.priority` + `health` 选择;`?source=` 可强制指定,仅用于调试。
7. 客户端完全不感知源:只调 `/api/v1/*`,换源发生在服务端。
### 4.4 客户端信息架构
| 入口 | 内容 | 数据来源 | 首期 |
|---|---|---|---|
| 书架 | 本地书架为主,可叠加官方书架只读副本;分组、最近阅读、更新提示 | `shelf` + `/sync/shelf` | 必需 |
| 发现 | 推荐区块、榜单入口、分类入口 | `/discover`、`/rank/{id}`、`/categories` | 必需(可先只做榜单 + 分类) |
| 搜索 | 输入联想 + 热搜 + 结果列表(多通道合并去重) | `/search`、`/search/suggest`、`/search/hot` | 必需 |
| 阅读 | 目录、正文、段评/章评/书评、进度、离线包 | `/catalog`、`/chapters`、`/comments` | 必需 |
| 设置 | 服务地址 + Token、字体与翻页刷新策略、缓存管理、账号状态 | 本地 + `/healthz` | 必需 |
设计原则:
- 不照搬官方书城的“无限运营位 + 视频/短剧混排”,只保留书籍形态,非书籍区块整块跳过。
- 发现页做成**可配置区块列表**:区块类型(榜单 / 分类格 / 横滑书单)由服务端下发,客户端只实现 5-6 种基础类型。
- 书架是首页,找书是第二入口;不为“像官方 App”牺牲墨水屏的信息密度与翻页速度。
- 推荐流字段易变,解析失败时静默降级为“榜单 + 分类”,不向用户报错。
---
## 5. 技术选型
### 5.1 客户端(墨水屏权重最高)
| 方案 | 墨水屏适配 | 三端一致性 | 生态/成本 | 主要风险 | 结论 |
|---|---|---|---|---|---|
| **Flutter** | 好:自绘渲染 + 原生插件调 EPD SDK | 高 | 成熟,招人/查资料容易 | 需按厂商写刷新插件 | **推荐** |
| Kotlin + Compose | 最好:直接调厂商 SDK | 中:一套 UI 自适应 | 成熟 | Compose 动画/内存需专门处理;老设备性能吃紧 | 备选(只锁定少数机型) |
| Kotlin + 自定义 View | 最好 | 低 | 工作量大 | 无现成组件 | 不考虑 |
| Tauri 2 | 差:系统 WebView 残影、老版本 WebView | 高 | Web 前端复用 | 墨水屏体验不可控 | 不推荐 |
| Rust + Slint / egui | 中:软件渲染省电 | 低 | 早期 | 中文排版、分页、输入法成本高 | 观察 |
选 Flutter 的核心理由:墨水屏需要“完全可控的文字排版 + 可插拔的刷新策略”,Flutter 两端都能满足,且 fqapp 已经证明这条路在 Android 上走得通。
### 5.2 服务端
| 方案 | 镜像/部署 | 开发效率 | 协议实现 | 结论 |
|---|---|---|---|---|
| **Rust(axum + sqlx + SQLite)** | 单二进制,镜像小 | 中 | 签名/解密移植最合适,可做黄金向量测试 | **推荐** |
| Go | 单二进制,最省心 | 高 | 足够 | 备选 |
| Python(FastAPI) | 镜像较大 | 高(参考实现多) | 快速验证协议 | 适合 M0 验证 |
| Node/TS | 镜像大、常驻内存高 | 高 | 一般 | 不优先 |
---
## 6. 数据与接口草案
### 6.1 数据表(SQLite)
| 表 | 关键字段 | 说明 |
|---|---|---|
| `books` | id, title, author, cover, status, word_count, score, updated_at, raw_json | 详情快照 |
| `chapters` | id, book_id, idx, volume, title, word_count, is_vip, fetched_at | 目录 |
| `contents` | chapter_id, text, format, source, hash, fetched_at | 正文,按章缓存 |
| `comments` | id, book_id, chapter_id, para_index, user, content, like_count, created_at, scope | 书评/章评/段评 |
| `shelf` | book_id, added_at, last_chapter, progress, source | 本地书架 |
| `accounts` | id, cookie_enc, device_id, install_id, secret_key_enc, expires_at | 账号与会话(加密) |
| `sources` | name, enabled, priority, health, last_error | 源健康状态 |
| `book_sources` | book_id, source, ext_id, is_primary | 内部 ID ↔ 源 ID 映射(多源预留) |
| `discover_cache` | source, kind, payload, fetched_at | 推荐/榜单/分类的区块快照 |
### 6.2 REST 草案
```
GET /api/v1/discover?source= # 发现页聚合:榜单入口 + 分类入口 + 推荐区块(可降级)
GET /api/v1/rank/{rankId}?page=
GET /api/v1/categories?tab=
GET /api/v1/search?q=&type=&source=
GET /api/v1/search/suggest?q=
GET /api/v1/search/hot
GET /api/v1/books/{id}
GET /api/v1/books/{id}/catalog
GET /api/v1/books/{id}/comments?scope=book|chapter|paragraph
GET /api/v1/chapters/{id}?include=comments
GET /api/v1/shelf
POST /api/v1/sync/shelf # 触发只读拉取
GET /api/v1/offline/{bookId} # 整本离线包
GET /api/v1/export/{bookId}.epub
GET /opds
GET /healthz
```
鉴权:固定 Bearer Token(容器启动时注入),详见 6.4。
### 6.3 同步语义
- 官方书架 → 本地:只新增/更新元数据,不删除本地书。
- 官方进度 → 本地:只读取展示,不覆盖本地更靠后的进度。
- 本地 → 官方:**不回写**。若确实需要“加入官方书架”,做成显式手动动作并二次确认。
### 6.4 公网访问与鉴权
- **通道**:容器只监听内网;外出统一走 Cloudflare Tunnel 或 frp,不在路由器上做端口映射。
- **Token**:首次启动生成固定 token(或从环境变量 `LFREADER_TOKEN` 注入),写入 `.env`,不落日志、不回显。
- 客户端用 `Authorization: Bearer <token>`;不支持自定义头的 OPDS 客户端允许 `?token=`(仅 TLS 下)。
- 比较用常量时间;失败计数 + 短时封禁,避免被扫描。
- **传输**:Tunnel / frp 侧必须 TLS,容器内不做明文公网监听。
- **暴露面分级**:
- 公网可访问:搜索、发现、详情、目录、正文、评论、离线包、OPDS(全部只读)。
- 仅内网 / VPN:账号登录与会话管理、同步触发、导出、配置与健康详情。
- **反代细节**:Tunnel 取 `CF-Connecting-IP` 做限速维度;frp 需 `X-Forwarded-For`。`/healthz` 公网只返回状态码,不泄露版本与配置。
- **客户端配置项**:一个「服务地址」+「Token」两个字段即可完成接入,避免多套配置分散。
---
## 7. 墨水屏专项清单
- [ ] 翻页后全刷,菜单/光标用局部刷新,避免残影累积。
- [ ] 分页结果按“字体 + 字号 + 屏宽”预计算并持久化,重开秒进。
- [ ] 内置可读性好的中文字体,避免不同设备系统字体差异。
- [ ] 关闭所有动画、阴影、半透明、滚动惯性。
- [ ] 支持音量键/蓝牙翻页器;点击区域大且可配置。
- [ ] 纯离线包阅读,禁止后台轮询,降低耗电。
- [ ] 主用机型 **掌阅 Tango2**(6.13" / 1648×842 / 300ppi,掌阅 SmartOS):实机确认第三方 APK 安装路径、后台保活、系统“快刷”档位能否被应用影响。
- [ ] 确认掌阅是否向第三方应用开放 EPD / 刷新接口;若不开放,退化为“零动画 + 系统快刷档 + 整页刷新”,并把该限制写进 M4 验收说明。
- [ ] 在 Tango2 上对比 Flutter 自绘与 WebView 的残影/闪烁差异(这是拒绝 Tauri 的实证依据)。
- [ ] 动效定位:**不做水波纹 / 仿真翻页**,只提供“无动画切换 + 可选整页刷新”;系统或官方阅读器的动效不在控制范围内(见 1.3)。
- [ ] 分页按 1648×842 / 300ppi 校准,手机与平板沿用同一算法换参数。
- [ ] 性能门槛:冷启动 < 3s、翻页 < 300ms、内存峰值 < 200MB、连续翻页 50 次无明显残影。
---
## 8. 可靠性工程
1. **源适配层**:每个通道实现同一组能力(搜索/详情/目录/正文/评论),带 health 标记,按优先级回退。
2. **缓存优先**:正文按章不可变;目录 TTL;评论快照 TTL;失败时返回旧缓存并标注时间。
3. **限速**:全局令牌桶 + 随机抖动 + 指数退避;服务端统一控制,客户端不直连。
4. **签名隔离**:签名/设备身份独立成模块,配黄金向量测试;上游变更只改一处。
5. **契约测试**:录制真实响应做 fixture,字段变更时先失败再修。
6. **配置化**:端点版本、超时、限速参数放配置文件,容器更新即可调整,无需发 APK。
7. **备份**:SQLite 定时快照 + EPUB 导出,防止账号或上游异常导致内容不可用。
---
## 9. 风险与边界
| 风险 | 应对 |
|---|---|
| 账号被风控/封禁 | 只用本人账号、低频、只读;保留 EPUB 导出作为兜底 |
| 上游接口变更 | 多源回退 + 服务端集中升级;不把逻辑写死在客户端 |
| 版权与平台条款 | 个人自用、局域网、不传播、不公开服务 |
| 代码许可 | fqapp 为 GPL-3.0,直接移植会继承许可;POf-L 未标注许可证且源码未公开,只能参考产品行为 |
| NAS 单点故障 | 定期备份;客户端保留完整离线包,短时断服可读 |
---
## 10. 里程碑
| 阶段 | 内容 | 验收标准 |
|---|---|---|
| M0 协议验证 | 验证 6 个能力:搜索、榜单、分类、目录、正文、段评;确认本人账号下 VIP 章可读、书架可拉 | 每个能力有可复现的请求与响应;确认段评分页方式、榜单 `rank_id` 来源、推荐流字段结构 |
| M1 服务端闭环 | Rust/Go 服务 + SQLite + 限速 + 缓存 + Docker Compose | 核心接口可用(搜索、发现、目录、正文、段评),重启不丢缓存,限速与 Token 鉴权生效 |
| M2 客户端 MVP | Flutter 阅读器:书架、找书(搜索 / 榜单 / 分类,推荐可后置)、详情、目录、正文、离线包 | 手机/平板上完整读一本书,断网可继续;找书入口可用 |
| M3 段评与同步 | 段评气泡/侧栏;官方书架只读同步 | 段评按段落定位准确;同步不产生任何写请求 |
| M4 墨水屏适配 | EPD 刷新插件、字体、按键、机型验证 | 通过第 7 节性能与残影门槛 |
| M5 稳定性 | 多源回退、监控、自动更新、备份 | 单源故障时阅读不中断;容器可一键升级 |
---
## 11. 待验证问题
1. 本人账号的 Cookie 能否直接调用 App 端段评接口,还是必须绑定设备身份?
2. VIP 章节在自有账号下取回的正文是否仍为设备密钥加密?密钥与账号还是与设备绑定?
3. 官方书架/进度的拉取频率上限,以及字段是否包含分组与排序?
4. 段评是否支持按章节批量拉取,还是必须逐段/逐章请求?
5. Tango2 实机的中文渲染表现(字形、行距、灰度层次),据此决定是否内置字体。
6. 是否需要听书/短剧(建议先不做,控制范围)。
7. 离线包格式:自定义 JSON 包还是直接 EPUB + 旁挂评论数据库?
8. 掌阅 Tango2 是否向第三方应用开放 EPD / 刷新接口;不开放时,系统的快刷档位能否被应用指定。
9. 榜单 `rank_id` 的稳定来源(推荐流 `cell_data` 还是固定常量表),以及各榜单的分页上限与刷新频率。
10. 推荐流 / 分类页的 schema 波动幅度,是否需要服务端做字段兼容层。
11. Cloudflare Tunnel 下主流 OPDS 客户端(静读天下 / KOReader / Thorium)能否带自定义 Header 或 query token。
12. 同一本书在 App / 头条 / 网页三通道的 ID 是否可直接互转(决定多源 ID 映射与“换源续读”的可行性)。
---
## 12. 参考链接
- [ch6vip/fqapp](https://github.com/ch6vip/fqapp) — Flutter + Rust 的番茄聚合客户端,GPL-3.0
- [POf-L/Fanqie-novel-Downloader](https://github.com/POf-L/Fanqie-novel-Downloader) — 跨平台下载/阅读器,段评与官方书架同步,`fanqie serve`
- [h13637404183-hub/fanqie-api](https://github.com/h13637404183-hub/fanqie-api) — 网页通道的 Flask 封装,Docker 部署
- [denniemok/fanqie-novel-reader](https://github.com/denniemok/fanqie-novel-reader) — React PWA 阅读器,多镜像与健康监控
- [shing-yu/fanqie-novel-download](https://github.com/shing-yu/fanqie-novel-download) — 早期 Python 实现
- [youshen2/Sine-NovelDownloader](https://github.com/youshen2/Sine-NovelDownloader) — 第三方 API 接入示例
- [legado(阅读)](https://github.com/gedoor/legado) — 书源规则与本地阅读模型参考