docs: update planning for direct reflowable engine rewrite
This commit is contained in:
+16
-5
@@ -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 生成可执行计划)
|
||||
|
||||
Reference in New Issue
Block a user