@@ -2,7 +2,7 @@
 
 > **状态**: 前瞻分析（未立项，待裁决）
 > 日期：2026-08-21
-> 依据：[pain-points-v3.md](../product/pain-points-v3.md) 第七部分实施路线图 + 代码库实态盘点（dev 分支，v0.10.2 交付后）
+> 依据：[pain-points-v3.md（[ ] 已归档）](../archive/2026-08-22/pain-points-v3.md) 第七部分实施路线图（已并入 [pain-points-v4.md](../product/pain-points-v4.md) §11）+ 代码库实态盘点（dev 分支，v0.10.2 交付后）
 > 立项后本文档迁移至 `versions/` 跟踪并按归档机制处置。
 
 ## 一、现状盘点：v3 三层架构中"已建成"与"零代码"的边界
 
@@ -0,0 +1,31 @@
+# 归档索引：2026-08-22（pain-points v2/v3 被 v4 统一卷取代归档）
+
+> 归档判定见 [archive README](../README.md)。本日归档夹为技术债滚动快照（唯一权威清单）。
+
+## 归档清单
+
+**本日归档 2 份**：
+
+| 源路径 → 归档路径 | 归档原因/状态 |
+|------|-----------|
+| `docs/product/pain-points-v2.md` → `docs/archive/2026-08-22/pain-points-v2.md` | **[ ] 已归档**——v2.0 双卷认知地图（上卷容器飞轮 + 下卷 feed 同步器），已被 v4.0 统一卷整合取代；保留作理论细节与三轮头脑风暴演进史追溯 |
+| `docs/product/pain-points-v3.md` → `docs/archive/2026-08-22/pain-points-v3.md` | **[ ] 已归档**——v3.0 融合裁决卷（三裁决 + Phase 1-4），裁决内容已内化为 v4 正文，不再以补丁形式外挂；保留作裁决过程追溯 |
+
+**取代文档**：`docs/product/pain-points-v4.md`（统一卷：两地形、一产物、一循环）成为唯一主导规划文档。
+
+## 工作摘要（v2+v3 → v4 整合）
+
+- **整合动因**：用户指出 v2（双卷理论）与 v3（外挂裁决卷）并行生效造成阅读分裂——读者需在两份文档间手动合并理论
+- **整合原则**：按主题组织而非按文档史组织；v2 上下卷的平行结构（指标/护城河/Pre-mortem/路线图各两份）合并为统一框架下的地形分叉表述；v3 三裁决内化为正文
+- **v4 结构**（12 部分 + 4 附录）：底层哲学（成为隐喻/叙事熵/稳态瞬态）→ 地形定义（结构承载性判据）→ 统一理论（同步器广义模型 = 飞轮+离合器的两地形特例）→ N1–N25 统一清单 → 两地形状态对照表 → 公共底座/分叉管线/统一产物层（笔记组三契约）→ 统一指标（北极星：组学习循环完成）→ 统一护城河（指标异端）→ 统一 Pre-mortem（14 死法合并排序）→ 路线图（Phase 1-4 执行轴 + 理论节点远期映射）→ 版本线与功能开关 → 元理论
+- **零信息丢失原则**：v2/v3 全部实质内容入 v4；头脑风暴过程细节（S/F 内部编号未收敛项、67→17 对账明细）以摘要形式入附录 D，全文保留于归档副本
+
+## 技术债摘要
+
+- **已偿 0 笔**：纯文档变更，无 Rust/前端代码改动
+- **新登记 open 0 笔**
+- **未偿 5 笔继承**（TD-040 / TD-2026-08-19-D/F/G / TD-2026-08-21-B）+ TD-2026-08-21-C 随七轮代码批待提交；详见本目录 tech-debt.md
+
+## 备注
+
+- 本日归档完成后即最新归档，下个归档日需先整理本日清单
@@ -0,0 +1,34 @@
+# 技术债清单（权威：2026-08-22 归档滚动——pain-points v4 统一卷整合批）
+
+> 本清单为当前唯一权威债务清单，归档日滚动更新；旧归档清单仅历史追溯。
+> 来源：2026-08-21 十轮清单继承 + 本批（v2/v3 → v4 整合，纯文档变更，无代码改动）。
+
+## 未偿债务（逐笔核验，carried 仅留 ID + 一行摘要）
+
+| ID | 摘要 |
+|----|------|
+| TD-040 | bundle.resources 未含 ffmpeg（deliberate 有意不修：体积权衡，开发期脚本+PATH 覆盖）；本批未涉及，保持 |
+| TD-2026-08-19-D | image_stream_store 已交付未接线（REQ-110/123/088）；本批未涉及，保持 |
+| TD-2026-08-19-F | detect_pause_icon 暗底+中央亮内容可能误报暂停；本批未涉及，保持 |
+| TD-2026-08-19-G | db_ocr_search 500 会话静默截断 + 图路径不校验存在性；本批未涉及，保持 |
+| TD-2026-08-21-B | v0.10.0 时间戳锚点断言过时（全量 16 项）；本批未涉及，保持 open |
+| TD-2026-08-21-C | db_sessions.rs / db_ai_tasks.rs 等文件的 `lock().expect` 锁点尚未迁移至 db.rs::with_conn（毒锁恢复 + ROLLBACK 孤儿事务兜底口径）；随七轮安全加固代码批待提交，保持 |
+
+## 今日已偿 / 新登记（open）
+
+- 已偿 0 笔（纯文档变更，无 Rust/前端代码改动）
+- 新登记 open 0 笔
+
+## 观察项（继承 2026-08-21 十轮，保持跟踪）
+
+| ID | 摘要 | 处置 |
+|----|------|------|
+| （观察 A1~A3 继承） | B6 宽松匹配 / 事件 deps / apply 两步落库 | 保持跟踪 |
+| （观察 0.10.1-1 继承） | 卸载自动保存与在飞保存乱序（低概率） | 保持跟踪 |
+| （观察 v0.10.2-1~3 继承） | O(n²) 窗口扫描 / budgetExhausted 无提示 / _frame_w 冗余参数 | 保持跟踪 |
+
+## 关联
+
+- 取代文档：[pain-points-v4.md](../../product/pain-points-v4.md)（统一卷，唯一主导规划文档）
+- 归档文档：[pain-points-v2.md](./pain-points-v2.md) · [pain-points-v3.md](./pain-points-v3.md)（[ ] 已归档）
+- 前瞻分析：[v3-roadmap-build-order-analysis.md](../../Foresight/v3-roadmap-build-order-analysis.md)（建设顺序分析，依据的 Phase 1-4 已并入 v4 §11，待裁决立项）
@@ -87,3 +87,4 @@ docs/archive/
 | 2026-08-21（八轮） | pain-points-v2 feed 地形下卷沉淀（双卷结构 + 同步器模型）+ 实验序列内容整章移除；纯文档变更；累计已偿 112 笔 | 同七轮，共 5 笔 |
 | 2026-08-21（九轮） | pain-points-v3 融合裁决卷沉淀（地形定义/产品形态/融合点三裁决 + Phase 1-4 路线图 + Pre-mortem）；纯文档变更；累计已偿 112 笔 | 同七轮，共 5 笔 |
 | 2026-08-21（十轮） | 日收工归档：v3 建设顺序分析沉淀至 Foresight（待裁决）+ docs-check 治理（四/七轮归档遗留失效链接 10 处修复 + extractLinks 补剔除代码块根治 v0.10.1 假阳性 5 处 + 索引缺漏 4 处补登记）；无文档移入归档夹（screen-ocr spec 未实施保持活跃）；纯文档变更 | TD-040 + TD-D~G（carried 4 笔）+ TD-B（open）+ TD-C（随七轮代码批待提交），共 6 笔 |
+| 2026-08-22 | pain-points v2/v3 归档（被 v4.0 统一卷取代：按主题重组而非按文档史；v2 双卷平行结构合并为统一框架的地形分叉表述；v3 三裁决内化为正文；零信息丢失）；纯文档变更 | 继承十轮 6 笔，无增减 |
@@ -7,8 +7,9 @@
 
 | 文档 | 回答的问题 | 状态 |
 |------|-----------|------|
-| [pain-points-v3.md](./pain-points-v3.md) | 怎么融合？融合裁决卷：地形定义（结构承载性）+ 统一产物模型（笔记组）+ 学习循环统一 | v3.0 终稿 |
-| [pain-points-v2.md](./pain-points-v2.md) | 为什么做？学习全链路认知地图与产品蓝图（上卷飞轮模型 + 下卷同步器模型；两地形理论，融合裁决见 v3） | v2.0 终稿 |
+| [pain-points-v4.md](./pain-points-v4.md) | 怎么融合？统一卷：两地形、一产物、一循环——地形定义（结构承载性）+ 统一理论（同步器/飞轮）+ 笔记组产物层 + 统一指标/护城河/路线图 | v4.0 统一终稿（唯一主导） |
+| pain-points-v3.md（[→ 已归档](../archive/2026-08-22/pain-points-v3.md)） | 融合裁决卷（三裁决 + Phase 1-4，已内化为 v4 正文） | [ ] 已归档 |
+| pain-points-v2.md（[→ 已归档](../archive/2026-08-22/pain-points-v2.md)） | 双卷认知地图（上卷飞轮 + 下卷同步器，已整合入 v4） | [ ] 已归档 |
 | pain-points-v1.md（[→ 已归档](../archive/2026-08-21/pain-points-v1.md)） | 学习全链路痛点图谱 v1.0（历史参考，被 v2.0 取代） | [ ] 已归档 |
 | [mvp-canvas.md](./mvp-canvas.md) | 做什么？MVP 验证画布：视频知识提取 + 持久化闭环 | 草案 |
 | [prd.md](./prd.md) | 怎么细化？产品需求文档（课堂助手为核心，MoSCoW + 场景 + 验收） | 草稿 |
@@ -28,7 +29,7 @@
 
 ## 文档演进顺序（Lean Product）
 
-1. 痛点图谱立论（pain-points.md）
+1. 痛点图谱立论（pain-points v1 → v2/v3 → [v4 统一卷](./pain-points-v4.md)）
 2. MVP 画布定范围（mvp-canvas.md）
 3. PRD 细化功能（prd.md）
 4. 需求池跟踪排期（requirements-pool.md）