chore: checkpoint current milestone work
This commit is contained in:
+23
-21
@@ -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
|
||||
**项目:** ReadViewSDK(brownfield)
|
||||
|
||||
## 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/`
|
||||
|
||||
Reference in New Issue
Block a user