chore: checkpoint current milestone work

This commit is contained in:
shen
2026-05-22 13:28:53 +08:00
parent 6d196d64e5
commit 5698aeaead
68 changed files with 5694 additions and 3291 deletions
+23 -21
View File
@@ -2,20 +2,20 @@
gsd_state_version: 1.0
milestone: v1.0
milestone_name: milestone
status: ready_to_plan
last_updated: 2026-05-21T13:59:55.225Z
status: ready_to_complete_milestone
last_updated: 2026-05-22T05:22:00.000Z
progress:
total_phases: 5
completed_phases: 0
total_plans: 2
completed_plans: 2
percent: 0
stopped_at: Phase 01 complete (2/2) — ready to discuss Phase 2
completed_phases: 5
total_plans: 13
completed_plans: 13
percent: 100
stopped_at: Phase 05 executed and verified — ready for milestone completion
---
# STATE
**状态日期:** 2026-05-21
**状态日期:** 2026-05-22
**项目:** ReadViewSDKbrownfield
## Project Reference
@@ -23,23 +23,20 @@ stopped_at: Phase 01 complete (2/2) — ready to discuss Phase 2
参见:`.planning/PROJECT.md`(更新于 2026-05-21
**核心价值:** 稳定可用的 EPUB/TXT 阅读体验
**当前关注:** Phase 2(重构 typesetter 与 CSS 分层)待 planning / execute
**当前关注:** Phase 5(回归验证与稳定性收敛)已执行完成,下一步可进入 milestone 收尾
## 当前结论(摘要)
- 项目范围已从“增强现有 reflowable renderer”升级为“**直接重构现有 reflowable EPUB 旧引擎**”
- `textReflowable` 将在旧引擎基础上演进为参考 WXRead 的原生渲染方案,不保留并行的第二套原生引擎
- `webFixedLayout``webInteractive` 继续使用 `WKWebView`,不在本次范围内替换
- 当前翻页代码(`RDReaderView` 及现有翻页模式/交互逻辑)明确不修改,新内核必须适配现有翻页容器
- 本次重构必须继续兼容:阅读位置映射、高亮/选区、搜索结果定位、字号/行高/主题切换后的重新分页。
- 全部 5 个 phase 已完成,native reflowable、fixed/interactive WebKit、TXT 三条主路径均有 Phase 5 运行时证据
- Demo 启动摘要现在输出 5/5 样本矩阵结果,并保留 Phase 3-4 的 pagination / restore diagnostics
- TXT 样本已内置到 `ReadViewDemo/ReadViewDemo/book/回归验证样本.txt`,不再依赖执行期临时文件
- `RDReaderView` 仍保持不修改;本轮里程碑以验证收敛结束,没有重新打开更大架构改造
## 当前风险焦点
- 分页正确性
- 位置映射稳定性
- 图片/块元素分页
- 高亮与搜索链路回归
- 主题和字号切换后的重排一致性
- 仍缺少“每本样本都全自动点读一遍”的 UI 自动化;当前证据以启动矩阵、日志和一次 reader UI 快照为主
- simulator 仍会输出既有 `.SFUI-Semibold` CoreText 替代提示,但未造成功能性失败
- 若后续进入发布前验收,建议补一轮更细的交互式手动清单或 UI 自动化
## 现有代码库地图
@@ -54,5 +51,10 @@ stopped_at: Phase 01 complete (2/2) — ready to discuss Phase 2
## 下一步
- 运行`$gsd-plan-phase 2`(为旧引擎的 WXRead 风格 typesetter / CSS 分层重构生成可执行计划)
- 已完成的 Phase 1 产物目录:`.planning/phases/01-current-engine-boundaries/`
- 建议下一步`$gsd-complete-milestone`
- 已完成的产物目录:
- `.planning/phases/01-current-engine-boundaries/`
- `.planning/phases/02-typesetter-css/`
- `.planning/phases/03-page-metadata-pagination/`
- `.planning/phases/04-reader-capabilities/`
- `.planning/phases/05-regression-stability/`