59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
---
|
||
gsd_state_version: 1.0
|
||
milestone: v1.0
|
||
milestone_name: milestone
|
||
status: ready_to_plan
|
||
last_updated: 2026-05-21T13:59:55.225Z
|
||
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
|
||
---
|
||
|
||
# STATE
|
||
|
||
**状态日期：** 2026-05-21
|
||
**项目：** ReadViewSDK（brownfield）
|
||
|
||
## Project Reference
|
||
|
||
参见：`.planning/PROJECT.md`（更新于 2026-05-21）
|
||
|
||
**核心价值：** 稳定可用的 EPUB/TXT 阅读体验
|
||
**当前关注：** Phase 2（重构 typesetter 与 CSS 分层）待 planning / execute
|
||
|
||
## 当前结论（摘要）
|
||
|
||
- 项目范围已从“增强现有 reflowable renderer”升级为“**直接重构现有 reflowable EPUB 旧引擎**”。
|
||
- `textReflowable` 将在旧引擎基础上演进为参考 WXRead 的原生渲染方案，不保留并行的第二套原生引擎。
|
||
- `webFixedLayout` 与 `webInteractive` 继续使用 `WKWebView`，不在本次范围内替换。
|
||
- 当前翻页代码（`RDReaderView` 及现有翻页模式/交互逻辑）明确不修改，新内核必须适配现有翻页容器。
|
||
- 本次重构必须继续兼容：阅读位置映射、高亮/选区、搜索结果定位、字号/行高/主题切换后的重新分页。
|
||
|
||
## 当前风险焦点
|
||
|
||
- 分页正确性
|
||
- 位置映射稳定性
|
||
- 图片/块元素分页
|
||
- 高亮与搜索链路回归
|
||
- 主题和字号切换后的重排一致性
|
||
|
||
## 现有代码库地图
|
||
|
||
- 代码库地图：`.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 2`（为旧引擎的 WXRead 风格 typesetter / CSS 分层重构生成可执行计划）
|
||
- 已完成的 Phase 1 产物目录：`.planning/phases/01-current-engine-boundaries/`
|