ReadViewSDK/.planning/ROADMAP.md

路线图：ReadViewSDK

概述

本次路线图以“在不扩大范围的前提下，将 reflowable EPUB 渲染路径替换为参考 Doc/WXRead/ 的微信读书（WXRead）原生渲染方式”为主线。Fixed Layout 与交互式 EPUB 保持 WKWebView 路径不变；除渲染替换所必需的最小改动外，其它能力暂不主动调整。每个 Phase 都以“可验证的稳定性”为完成标准。

Phases

• Phase 1：对齐现状与改造边界 - 明确 reflowable/Fixed/交互式 的判定与现有路径，锁定不做范围
• Phase 2：WXRead 渲染管线方案落地（reflowable） - 依据 Doc/WXRead/ 设计并落地原生渲染入口与最小可用链路
• Phase 3：集成与稳定性回归 - 集成到现有 reader 入口，确保主流程与常见内容稳定可用

Phase Details

Phase 1：对齐现状与改造边界

Goal：明确 reflowable EPUB 当前渲染/分页路径与切换点，制定替换策略与不做边界，确保 WKWebView 场景不被误伤。
Depends on：Nothing (first phase)
Requirements：REND-02
Success Criteria（必须为 TRUE）：

1. 能明确判定一本 EPUB 属于 reflowable / Fixed Layout / 交互式（以工程实现为准）
2. 固定版式与交互式 EPUB 仍走 WKWebView，并形成清晰的“保持不改”约束
3. 输出一份可执行的实现策略：将 reflowable EPUB 切换到 WXRead 风格原生渲染 Plans：2 plans

Plans:

• 01-01：阅读 Doc/WXRead/analysis/* 与关键 decompiled 符号，提炼“原生渲染”最小管线与可替换点
• 01-02：审计现有 Sources/RDReaderView/EPUBCore reflowable 渲染/分页路径，确定切入点与迁移策略

Phase 2：WXRead 渲染管线方案落地（reflowable）

Goal：在 SDK 内为 reflowable EPUB 引入 WXRead 风格的原生渲染入口，跑通最小可用链路（可在 Demo 中验证）。
Depends on：Phase 1
Requirements：REND-01, REND-03
Success Criteria（必须为 TRUE）：

1. reflowable EPUB 可不依赖现有 WKWebView 渲染路径完成排版/分页/展示
2. 渲染结果在 Demo 中可稳定展示（最小支持：段落/标题/基础样式/图片）
3. 切换判定逻辑清晰、可测，且 Fixed/交互式路径未被影响 Plans：3 plans

Plans:

• 02-01：定义并实现 reflowable EPUB 的“原生渲染”模块边界（typesetter/layouter/page model 等）
• 02-02：对接现有解析与资源加载（manifest/spine/资源寻址），保证图片/CSS/字体等基础资源可用
• 02-03：在现有 reader 入口处接入新渲染路径（保持对外 API 尽量不变）

Phase 3：集成与稳定性回归

Goal：把新 reflowable 渲染路径完整集成到阅读器体验中，保证主流程稳定可用，并建立最小回归保障。
Depends on：Phase 2
Requirements：STAB-01, STAB-02
Success Criteria（必须为 TRUE）：

1. RDURLReaderController 打开 .epub/.txt 的主流程不回归
2. reflowable EPUB 在常见内容下不出现崩溃/白屏/卡死等关键稳定性问题
3. Demo 可用于复现与回归验证（至少包含 2-3 本典型 reflowable EPUB 用例） Plans：2 plans

Plans:

• 03-01：补齐关键回归用例与诊断手段（日志/开关/快速回退策略）
• 03-02：对 reflowable 渲染在真实内容上的问题做收敛与修复，形成可持续迭代基线

Progress

Phase	Plans Complete	Status	Completed
1. 对齐现状与改造边界	0/2	Not started	-
2. WXRead 渲染管线方案落地（reflowable）	0/3	Not started	-
3. 集成与稳定性回归	0/2	Not started	-