ReadViewSDK/.planning/STATE.md

gsd_state_version	milestone	milestone_name	status	last_updated	progress	stopped_at
1.0	v1.0	milestone	ready_to_plan	2026-05-21T13:59:55.225Z	total_phases completed_phases total_plans completed_plans percent 5 0 2 2 0	Phase 01 complete (2/2) — ready to discuss Phase 2

STATE

状态日期： 2026-05-21
项目： ReadViewSDK（brownfield）

Project Reference

参见：.planning/PROJECT.md（更新于 2026-05-21）

核心价值： 稳定可用的 EPUB/TXT 阅读体验
当前关注： Phase 2（重构 typesetter 与 CSS 分层）待 planning / execute

当前结论（摘要）

• 项目范围已从“增强现有 reflowable renderer”升级为“直接重构现有 reflowable EPUB 旧引擎”。
• textReflowable 将在旧引擎基础上演进为参考 WXRead 的原生渲染方案，不保留并行的第二套原生引擎。
• webFixedLayout 与 webInteractive 继续使用 WKWebView，不在本次范围内替换。
• 当前翻页代码（RDReaderView 及现有翻页模式/交互逻辑）明确不修改，新内核必须适配现有翻页容器。
• 本次重构必须继续兼容：阅读位置映射、高亮/选区、搜索结果定位、字号/行高/主题切换后的重新分页。

当前风险焦点

• 分页正确性
• 位置映射稳定性
• 图片/块元素分页
• 高亮与搜索链路回归
• 主题和字号切换后的重排一致性

现有代码库地图

• 代码库地图：.planning/codebase/
• 关键文档：
  • .planning/codebase/ARCHITECTURE.md
  • .planning/codebase/STACK.md
  • .planning/codebase/STRUCTURE.md
  • .planning/codebase/CONCERNS.md
• 方案文档：
  • Doc/FeatureSolution/ReflowableEPUB_WXReadRenderer_Design.md

下一步

• 运行：$gsd-plan-phase 2（为旧引擎的 WXRead 风格 typesetter / CSS 分层重构生成可执行计划）
• 已完成的 Phase 1 产物目录：.planning/phases/01-current-engine-boundaries/