docs: update planning for direct reflowable engine rewrite

This commit is contained in:
shen
2026-05-21 21:08:21 +08:00
parent c95d80e257
commit 43c3381e9b
4 changed files with 125 additions and 64 deletions
+16 -5
View File
@@ -8,13 +8,22 @@
参见:`.planning/PROJECT.md`(更新于 2026-05-21
**核心价值:** 稳定可用的 EPUB/TXT 阅读体验
**当前关注:** Phase 1(对齐现状与改造边界
**当前关注:** Phase 1(对齐现状、边界与重构切入点
## 当前结论(摘要)
- 本次“大改”的唯一核心目标:将 reflowable EPUB 渲染/排版/分页改为参考 `Doc/WXRead/` 的微信读书(WXRead)原生渲染方式
- Fixed Layout EPUB 与交互式 EPUB 继续使用 `WKWebView`,不在本次范围内替换
- 除渲染替换所必需的最小改动外,其它能力暂不主动调整
- 项目范围已从“增强现有 reflowable renderer”升级为“**直接重构现有 reflowable EPUB 旧引擎**”
- `textReflowable` 将在旧引擎基础上演进为参考 WXRead 的原生渲染方案,不保留并行的第二套原生引擎
- `webFixedLayout``webInteractive` 继续使用 `WKWebView`,不在本次范围内替换
- 本次重构必须继续兼容:阅读位置映射、高亮/选区、搜索结果定位、字号/行高/主题切换后的重新分页。
## 当前风险焦点
- 分页正确性
- 位置映射稳定性
- 图片/块元素分页
- 高亮与搜索链路回归
- 主题和字号切换后的重排一致性
## 现有代码库地图
@@ -24,7 +33,9 @@
- `.planning/codebase/STACK.md`
- `.planning/codebase/STRUCTURE.md`
- `.planning/codebase/CONCERNS.md`
- 方案文档:
- `Doc/FeatureSolution/ReflowableEPUB_WXReadRenderer_Design.md`
## 下一步
- 运行:`$gsd-plan-phase 1`(为 Phase 1 生成可执行计划)
- 运行:`$gsd-plan-phase 1`(为“旧引擎直接重构”版本的 Phase 1 生成可执行计划)