# STATE

**状态日期：** 2026-05-21  
**项目：** ReadViewSDK（brownfield）

## Project Reference

参见：`.planning/PROJECT.md`（更新于 2026-05-21）

**核心价值：** 稳定可用的 EPUB/TXT 阅读体验  
**当前关注：** Phase 1（对齐现状、边界与重构切入点）

## 当前结论（摘要）

- 项目范围已从“增强现有 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 1`（为“旧引擎直接重构”版本的 Phase 1 生成可执行计划）