---
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/`