chore: checkpoint current milestone work

Doc/FeatureSolution/ReflowableEPUB_WXReadRenderer_Design.md

@@ -34,6 +34,8 @@ ReadViewSDK 当前对 EPUB 有三类渲染路径：
 
 ## 2. 关键事实核验（当前代码真实路径）
 
+> 纠偏说明：`.planning/PROJECT.md` 在初始化时曾把“reflowable EPUB 当前路径”概括为偏 `WKWebView` 的历史性表述。经本次代码核验，当前真实主路径是 `.textReflowable` → `RDEPUBTextBookBuilder` → `RDEPUBDTCoreTextRenderer` → CoreText 分页 → `RDEPUBTextContentView`。本设计以代码事实为准，并默认后续计划/实现都按此理解推进。
+
 ### 2.1 渲染路径分流（已存在）
 
 - 判定在 `Sources/RDReaderView/EPUBCore/RDEPUBParser+ReadingProfile.swift`：
@@ -69,6 +71,12 @@ ReadViewSDK 当前对 EPUB 有三类渲染路径：
 - B：**资源解析**（图片/CSS 的相对路径 baseURL）与稳定性保障  
 - C：在现有分页基础上逐步迭代（先可用，后对齐“避免断页”等高级策略）
 
+### 3.1 第一阶段实施假设（必须遵守）
+
+- H1：**第一期只对齐“管线形态”和“CSS 分层策略”**，即把现有 `.textReflowable` renderer 增强为更接近 WXRead 的 typesetter 输入与样式组织方式。
+- H2：**第一期不实现 WXRead 对 DTCoreText 的深度魔改**，包括但不限于自定义 CSS 属性体系、复杂附件布局规则、完整的 `WRCoreTextLayouter` / `WRCoreTextLayoutFrame` 等价分页器。
+- H3：当开发过程中遇到图片断页、复杂样式缺失、附件布局异常等问题时，默认先作为“第二阶段问题清单”记录；只有在它阻塞 `REND-01` / `STAB-02` 的最小验收时，才允许做局部补丁，而不是扩展为全面重写分页引擎。
+
 ## 4. 是否能直接使用 Doc/WXRead 中的 JS/CSS？
 
 结论：**不建议、也不应该直接把“来自微信读书 App bundle 的私有 JS/CSS”拷贝进 SDK 作为产品代码**；但可以按以下原则“选择性使用”：
@@ -169,6 +177,8 @@ WXRead 的更高阶策略（参考 `Doc/WXRead/analysis/DTCoreText自定义修
 - Phase 2：先保持现有分页算法，只要渲染输入（CSS 分层 + 后处理）到位，就能显著改善一致性。
 - Phase 3：针对真实书籍出现的问题，逐条补齐分页规则（问题驱动），避免一开始就引入复杂分页器导致风险扩大。
 
+> 范围约束：如果某个分页问题需要引入“新的复杂分页器”或大规模模拟 `WRCoreTextLayouter` / `WRCoreTextLayoutFrame`，应先暂停并回到方案讨论，不默认并入第一期实现。
+
 ### 5.5 与现有高亮/搜索/位置映射的兼容
 
 当前 `.textReflowable` 路径：
@@ -224,7 +234,11 @@ WXRead 的更高阶策略（参考 `Doc/WXRead/analysis/DTCoreText自定义修
 ### 对应 STAB-01 / STAB-02
 
 - `RDURLReaderController` 打开 `.epub` / `.txt` 主流程不回归
-- 2-3 本典型 reflowable EPUB：不崩溃、不白屏、不无限加载；分页/翻页可用
+- 至少使用以下 3 类 reflowable EPUB 样本进行回归：
+  - 样本 A：纯文本/小说类章节为主，验证基础段落、标题、分页与阅读位置恢复
+  - 样本 B：包含内嵌图片与多段样式的章节，验证图片显示、图片前后分页、基础 CSS 生效
+  - 样本 C：包含外链与多个 CSS 文件引用的章节，验证 baseURL、样式解析与链接呈现稳定性
+- 对以上样本的共同要求：不崩溃、不白屏、不无限加载；分页/翻页可用
 
 ## 8. 风险清单与降级策略