@@ -0,0 +1,73 @@
+# ADR-021: 笔记正文源多态——`detect_body_source` 抽象层
+
+## 状态
+
+已接受（v0.12.0 M1，2026-08-23 规划定稿）——已实施并交付。
+
+## 日期
+
+2026-08-23
+
+## 背景
+
+`filter_note`（REQ-082）把 `segments`（转写段）硬编码为唯一正文源，`ocr_blocks`（OCR 块）始终为辅助画面要点不入 markdown。对视频会话这是正确设计（关键帧信息密度低，OCR 文本质量不稳），但对图文会话（`kind=photo`，ADR-020）——用户手动框选、OCR 文本即意图——导致转笔记时 markdown 只有标题，正文为空。这是设计债：`(segments, ocr_blocks)` 二元组缺乏"哪个是正文"的表达层。
+
+## 决策
+
+我们将引入 `BodySource` 枚举（`Transcript` / `OcrDirect` / `Empty`）+ `detect_body_source` 纯函数，`filter_note` 内部按来源分派到不同过滤链：
+
+```
+  segments ──┐
+               ├→ detect_body_source ─→ Transcript ─→ 既有口语过滤链（视频，零改动）
+  ocr_blocks ─┘                       → OcrDirect ─→ 精简 OCR 过滤链（图文，新增）
+                                       → Empty     ─→ 标题仅
+```
+
+- `Transcript` → 既有口语过滤链（逻辑逐字节不变——零回归风险）。
+- `OcrDirect` → `filter_note_from_ocr` 精简链：排序 → 置信过滤（0.5，与 photo_capture 同口径）→ 符号归一（**跳过口语净化**——OCR 文本无结巴/口头禅/碎片）→ 相邻去重 → markdown 组装（"图文提取"标注段）。
+- `Empty` → 标题仅 markdown（无可用正文的诚实降级，不 panic）。
+
+`refresh_screen_points` / `apply_ai_decisions` / `render_note_structure` 按 `body_source` 分流，防覆盖 OCR 正文（图文会话无时间轴叙述结构，章节插入不适用）。
+
+引用 photo_capture 已有规则：用户框选即意图，OCR 文本不过 UI 垃圾黑名单（与视频链路"OCR 辅助画面要点"语义分离——OCR 文本在图文会话中是正文本身）。
+
+## 备选方案
+
+### 方案 A：打补丁——过滤链内特判 `kind=photo`
+- 优点：改动最小。
+- 缺点：把"正文来源"拍进过滤链，语义仍被 `kind` 绑定；未来导入 PDF/网页截图转笔记需再造一条特判分支——不可扩展，重蹈硬编码覆辙。
+
+### 方案 B：正文源多态抽象（**选定**）
+- 优点：`detect_body_source` 是独立抽象层，新正文源（PDF / 网页截图）只加变体 + 对应过滤链，不改既有 Transcript 路径核；与 `kind` 字段解耦（未来导入语音会话同路径）。
+- 缺点：一次性引入枚举 + 分派 + 三路 match，改动面略大。
+- 适用场景：长期重构，多正文源演进。
+
+## 选择理由
+
+正文源多态是长期重构而非打补丁。`BodySource` 枚举把"哪个是正文"提升为数据层语义，过滤链核只按来源分派，为未来"导入 PDF/网页截图直接转笔记"提供架构地基（仅需新增 `BodySource::PdfDirect` + 对应过滤链）。Transcript 路径零改动消除回归风险。
+
+## 影响
+
+### 正面影响
+- 修复纯图文会话转笔记空内容的 P0 设计债。
+- 正文来源表达层化，未来多源扩展只加变体。
+
+### 负面影响 / 代价
+- `filter_note` 新增枚举 + 分派 + `filter_note_empty`；`NoteFilterResult` 增加 `body_source` / `ocr_body` 两个 serde-skip 内部字段。
+
+### 风险
+- Empty 分支对"空转写段 + 辅助字幕 OCR 块"的视频会话 edge case 由"保留 ocr_screens"变为"标题仅"——与设计一致性（Empty=标题仅）相符，属有意行为。
+
+## 合规性验证
+
+- `cargo test note_filter`（`detect_body_source` 黄金 6 用例、`filter_note_from_ocr` 7 用例、`filter_note_with_empty_segments` 新语义）。
+- 纯图文会话转笔记 → markdown 含 OCR 识别文本 + "图文提取"标注段；视频会话转笔记 → 零变化（回归护栏）。
+
+## 相关决策
+
+- ADR-020: 会话类型字段（图文会话）
+- ADR-010: AI gap-filling 隐私契约
+
+## 参考
+
+- docs/versions/v0.12.0.md（正文源多态 M1）
@@ -0,0 +1,69 @@
+# ADR-022: WGC 窗口级捕获——三级降级链
+
+## 状态
+
+提议（v0.12.0 M2，2026-08-23 规划定稿；待实施）
+
+## 日期
+
+2026-08-23
+
+## 背景
+
+当前 DXGI Desktop Duplication 是显示器级捕获，窗口上方覆盖的 UI（弹窗/任务栏/通知）会入镜；GDI BitBlt 降级更差，遮挡完全无法避免。目标窗口被遮挡导致采集内容含遮挡物（能力债）。
+
+## 决策
+
+我们将新增 WGC（Windows.Graphics.Capture，Win 10 1903+）后端，构建三级降级自愈链：
+
+```
+WGC（主，窗口级，Win 10 1903+）
+  ↓ AcquireNextFrame 失败 / 安全桌面 / 窗口最小化
+DXGI Desktop Duplication（降级 1，屏幕级+窗口裁剪，当前主路径）
+  ↓ 远程桌面 / 锁屏 / 设备丢失
+GDI BitBlt（兜底，全场景可用）
+```
+
+- 新增 `capture/wgc_capture.rs`（WinRT 异步帧回调 → 通道同步化，`capture()` 保持同步接口——上层 Worker 零改动，变化检测/双速率调度/OCR 编排全部复用）。
+- `ScreenCaptureSampler` 扩展为三级链：新增 `CaptureBackend { Wgc, Dxgi, Gdi }`，`try_create_backend` 逐级尝试（WGC → DXGI → GDI），`capture()` 按当前后端路由，失败自动降级下一级。
+- WGC 初版编译期 `#[cfg(windows)]` gate——Win 10 1903 以下回退 DXGI/GDI（旧系统行为零变化）。
+- 三级链不引入新不确定性：WGC 最小化场景不回退到 DXGI 后不尝试自动切回——沿用 DXGI 已有 30s 周期重建（TD-033 快速节流同理）。
+
+## 备选方案
+
+### 方案 A：继续 DXGI，只在窗口裁剪上增强
+- 优点：无新依赖。
+- 缺点：DXGI 是显示器级，窗口遮挡本质无法规避——治标不治本。
+
+### 方案 B：WGC 主路径 + 三级降级（**选定**）
+- 优点：WGC 窗口级捕获真正抗遮挡（弹窗/任务栏/通知不入镜）；三级链覆盖不稳定场景（安全桌面/全屏独占 DX 游戏/最小化/远程桌面/无 DWM）。
+- 缺点：WinRT FFI 复杂度；Win 10 1903 以下不可用（编译期 gate 回退）。
+- 适用场景：窗口被遮挡是用户核心痛点。
+
+## 选择理由
+
+WGC 提供真正的窗口级捕获，是唯一能规避窗口遮挡的方案。三级降级链保证在 WGC 不稳定的各类场景（UAC 安全桌面、全屏独占 DX 游戏、窗口最小化、远程桌面、Server Core 无 DWM）不 panic 且行为与当前一致，最大化兼容性。
+
+## 影响
+
+### 正面影响
+- 目标窗口被遮挡时捕获内容为窗口实际内容（非遮挡物）。
+
+### 负面影响 / 代价
+- 新增 WinRT FFI 模块（异步转同步的通道化样板）；`ScreenCaptureSampler` 增加后端状态机。
+
+### 风险
+- WGC WinRT 异步回调 → 通道同步的 FFI 复杂度；需真机验证各降级路径（安全桌面/远程桌面/锁屏）。
+
+## 合规性验证
+
+- 目标窗口被遮挡时捕获内容为窗口实际内容；远程桌面会话自动降级 DXGI/GDI 且不 panic；窗口关闭/最小化按现有 DXGI/GDI 逻辑兜底；`cargo build` 通过。
+
+## 相关决策
+
+- ADR-002: DXGI 屏幕捕获
+- ADR-007: 实时会话生命周期（30s 周期重建）
+
+## 参考
+
+- docs/versions/v0.12.0.md（WGC 窗口级捕获 M2）
@@ -0,0 +1,63 @@
+# ADR-023: 视频会话 OCR 下线 + AI 精修图片理解（vision-exp）
+
+## 状态
+
+已接受（v0.12.0 M5，2026-08-23 用户裁决；精修侧已实施交付，画面要点降级侧待真机验证）
+
+## 日期
+
+2026-08-23
+
+## 背景
+
+本地 PaddleOCR 对视频**全帧画面要点**提取质量差（动态模糊/复杂版面/小字/干扰物）——同一引擎在字幕/图文场景效果好（质量债）。且图片上传是最敏感的隐私动作，需独立授权闸门。
+
+## 决策
+
+- **本地 OCR 只做字幕（视频）+ 图文采集（photo 会话）**——视频会话不再做全帧 OCR。
+- **关键帧纯图**（存图不识别）；存图触发从"OCR 文本非空"解耦为"grid diff 变化 + 时间间隔"。
+- **vision-exp 图片理解（可选增强，仅视频会话，并入 AI 精修）**：不做独立提取命令——精修时若 `vision_refine_enabled` 开启，屏卡图随转写文本一并送 `deepseek-v4-flash-vision-exp`（content 数组多模态），精修输出直接含画面要点；屏卡缩略图走现有 `attach_images`。
+- **图文会话 OCR 已足够，不启用 vision**（用户决策：仅视频会话使用）。
+- **图片精修可选性**：`vision_refine_enabled` 开关（默认关）——图片上传最敏感，独立闸门；关闭则精修纯文本（现有行为零变化）。
+- **AI 强化链条总开关**：复用现有 `AiSettings.enabled`（全局闸门，默认关）——关闭则采集期领域识别/AI 复核/精修/补充全部拒绝（已有 `content_gate` 门控）。
+
+**隐私红线（ADR-010 扩展）**：图片上传默认关（`vision_refine_enabled` 默认 false + 全局 `enabled` 默认关）；关闭时精修走纯文本（零变化）；图片仅随精修切片请求上传，不作独立提取。
+
+## 备选方案
+
+### 方案 A：保留视频全帧本地 OCR，仅调参增强
+- 优点：无架构改动。
+- 缺点：本地 OCR 在动态模糊/复杂版面根本性不可靠——调参治标不治本，且维持全帧 OCR 的算力/成本。
+
+### 方案 B：视频全帧 OCR 下线 + vision-exp 精修图片理解（**选定**）
+- 优点：质量债根治（关键帧纯图，不识别）；画面要点经 vision-exp 高质量提取并并入精修；图片上传独立闸门 + 默认关，隐私可控。
+- 缺点：画面要点提取依赖云端 vision（需授权 + 有条件）；离线降级 = 无画面要点（纯图存证）。
+- 适用场景：视频会话以转写为主体，画面要点为增强。
+
+## 选择理由
+
+本地 OCR 质量差的根因是引擎对视频全帧的鲁棒性不足——降级为"只做字幕/图文采集"规避该根因。画面要点本属增强，交给 vision-exp 高质量提取并在精修时随切片上云，同时以独立闸门 + 默认关满足图片隐私红线。
+
+## 影响
+
+### 正面影响
+- 视频会话不再产生低质全帧 OCR；画面要点提取质量提升（vision-exp）；图片上传可控。
+
+### 负面影响 / 代价
+- 关闭开关时视频会话精修无画面要点（纯文本）；图片随精修上云需用户授权（默认关）。
+
+### 风险
+- vision-exp 画面要点抽取质量依赖云端模型（未实测校准）；需真机验证采集端改动（video 会话不再 OCR 全帧）。
+
+## 合规性验证
+
+- 视频会话关键帧纯图（无 OCR 文字）；开启图片开关后精修请求含屏卡图、输出含画面要点；关闭开关精修纯文本零变化；图文会话不受影响；`enabled=false` 时精修命令拒绝。
+
+## 相关决策
+
+- ADR-010: AI gap-filling 隐私契约（本 ADR 扩展图片授权）
+- ADR-011: grid diff OCR 触发
+
+## 参考
+
+- docs/versions/v0.12.0.md（视频画面要点降级 + vision 提取 M5）
@@ -24,9 +24,9 @@
 | ADR-017 | [安全加固批（CSP 基线与白名单、opener 移除、compose 强制配置、nginx 安全头、.env.production 去跟踪）](./ADR-017-security-hardening-batch.md) | 已接受 | 2026-08-21 |
 | ADR-018 | [间隔重复调度器引入 fsrs crate（FSRS-6）](./ADR-018-fsrs-scheduler-adoption.md) | 已接受 | 2026-08-22 |
 | ADR-020 | [会话类型字段（图文会话）](./ADR-020-session-kind-field.md) | 已接受 | 2026-08-22 |
-| ADR-021 | 笔记正文源多态——`detect_body_source` 抽象层（图文会话 OCR 进笔记正文） | 提议（v0.12.0 M1，待写） | 2026-08-23 |
-| ADR-022 | WGC 窗口级捕获——三级降级链（WGC→DXGI→GDI） | 提议（v0.12.0 M2，待写） | 2026-08-23 |
-| ADR-023 | 视频会话 OCR 下线 + AI 精修图片理解（含隐私授权契约） | 提议（v0.12.0 M5，待写） | 2026-08-23 |
+| ADR-021 | [笔记正文源多态——`detect_body_source` 抽象层（图文会话 OCR 进笔记正文）](./ADR-021-note-body-source-polymorphism.md) | 已接受（v0.12.0 M1，已交付） | 2026-08-23 |
+| ADR-022 | [WGC 窗口级捕获——三级降级链（WGC→DXGI→GDI）](./ADR-022-wgc-window-capture.md) | 提议（v0.12.0 M2，待实施） | 2026-08-23 |
+| ADR-023 | [视频会话 OCR 下线 + AI 精修图片理解（含隐私授权契约）](./ADR-023-video-ocr-offline-vision-extract.md) | 已接受（v0.12.0 M5，精修侧已交付） | 2026-08-23 |
 
 ## 编号规则
 
 
@@ -29,7 +29,7 @@
 | v0.11.5 | [v0.11.md](./v0.11.md#v0115-交付采集体验与笔记打磨11-项2026-08-22-用户裁决立项) — 采集体验与笔记打磨（档案采集中可改+记忆机制修正 / 识别率增强 / 窗口刷新 / 编号序号化 / 新颖度变化区域 / 水印 A+B+C / 产物视图下线+精修懒自动 / 精修工作台 / 锚点剥离 / 画面要点移出笔记 / 笔记页树形合并+缩略图，2026-08-22 交付） | 版本文档（代码已交付 2026-08-22，真机验收待执行） |
 | v0.11.6 | [v0.11.6.md](./v0.11.6.md) — AI 平台化：Provider 抽象 + 能力声明化 + 产出策略定制（三层；M1→M3 排期） | 版本文档（规划中 2026-08-22） |
 | v0.11.7 | [v0.11.7.md](./v0.11.7.md) — 图文会话：截屏导入 + 跨链路采集体验同步（kind 字段 + 5 命令 + 框选遮罩；排期于 v0.11.6 之后） | 版本文档（规划中 2026-08-22） |
-| v0.12.0 | [v0.12.0.md](./v0.12.0.md) — 图文与窗口捕获重塑：正文源多态 + WGC 抗遮挡 + 系统级截屏覆盖层 + DeepSeek 默认化 + vision 精修 + 采集浮窗化（M1-M7，七项改进修正五个断裂） | 版本文档（规划定稿 2026-08-23，设计完成待实施） |
+| v0.12.0 | [v0.12.0.md](./v0.12.0.md) — 图文与窗口捕获重塑：正文源多态 + WGC 抗遮挡 + 系统级截屏覆盖层 + DeepSeek 默认化 + vision 精修 + 采集浮窗化（M1-M7，七项改进修正五个断裂） | 版本文档（规划定稿 2026-08-23；M1/M4/M5-精修侧已交付，其余待实施） |
 
 ## 沉淀规则