ReadViewSDK/.planning/STATE.md

STATE

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

Project Reference

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

核心价值： 稳定可用的 EPUB/TXT 阅读体验
当前关注： Phase 1（对齐现状、边界与重构切入点）

当前结论（摘要）

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

当前风险焦点

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

现有代码库地图

• 代码库地图：.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 1（为“旧引擎直接重构”版本的 Phase 1 生成可执行计划）