各版本的深度文档（发版计划 / 需求追溯 / 总结报告 / 测试标准）。 与根目录 CHANGELOG.md 的关系：CHANGELOG 是全量变更流水账（可自动化生成），本目录沉淀需要深度记录的版本文档（人工撰写）。
| 版本 | 文档 | 类型 |
|---|---|---|
| v0.1.0 | v0.1.0.md — 第一阶段：本地提取链路 MVP（ASR+OCR+拼接+笔记） | 发版文档 |
| v0.2.0 | v0.2.0.md — 第二阶段：系统实时捕获链路（WASAPI+DXGI+流式ASR+字幕OCR+双源融合+会话） | 发版文档（规划中） |
| v0.3.0 | v0.3.0.md — 第三阶段：文件导入+字幕探测+融合异步化+采集质量优化+实时活动面板（REQ-015~018/031/034/035） | 发版文档（代码已交付 2026-08-18，真机验收待执行） |
| v0.4.0 | v0.4.0.md — 第四阶段：课堂助手本地模式完成+三维优化（GPU 卸载/动态 ROI/实时体验/资源预算/热词闭环） | 发版文档（规划中） |
| v0.5.0 | v0.5.0.md — 第五阶段：视频类型优化+版面分析与结构化提取+图片配套+产物体系+AI 补缝前置 | 发版文档（代码已交付，真机验收待执行） |
| v0.6.0 | v0.6.0.md — 第六阶段：提取质量与信任+性能资源+会话体验（REQ-059~087，含 ADR-011/012） | 发版文档（开发完成 2026-08-19，M7 真机验收待执行） |
| v0.7.0 | v0.7.0.md — 第七阶段：信任收尾+存储使能+类型扩展（三通道模型；REQ-088/098~134，37 项） | 发版文档（开发完成 2026-08-19，M4 真机验收待执行） |
| v0.7.1 | v0.7.1.md — 会话体验小版本：管理控制台+转化流水线（REQ-135~137，含 ADR-014） | 发版文档（开发完成 2026-08-19，真机验收待执行） |
| v0.7.2 | v0.7.2.md — 课堂助手实时体验深化：信息面板+合集检测联动+说话人分离弱化版+断句自适应（REQ-148~154） | 发版文档（开发中 2026-08） |
| v0.7.3 | v0.7.3.md — 画面要点屏卡体系：屏聚合/bbox 落库/在线分配/笔记配图/结构识别接线（REQ-155~161，含 ADR-015） | 发版文档（已实施 2026-08-20，真机验收待执行） |
| v0.7.5 | v0.7.5.md — 会话转笔记规则净化优化+停止状态残留修复（REQ-162~176；结构组织暂不实施） | 发版文档（已实施 2026-08-20） |
| v0.7.6 | v0.7.6.md — 笔记纯本地结构渲染：章节标题+词汇表入笔记（REQ-177~181） | 发版文档（已实施 2026-08-20） |
| v0.7.7 | v0.7.7.md — 结构图捕获持久化（REQ-182~187） | 发版文档（规划中 2026-08-20） |
| v0.8.0 | v0.8.0.md — 第八阶段：AI 接入——会话→笔记精修+知识补充+信任基建（REQ-138~147，含余额查询） | 发版文档（规划中，M0 验收总清前置） |
| v0.9.0 | v0.9.0.md — 第九阶段：视频档案框架 v2——四维解耦重新设计（形态 7 类 × 画面价值 4 档 × 领域标签 × 语言预留；REQ-188~193） | 发版文档（规划中 2026-08-21） |
| v0.10.0 | v0.10.0.md — 第十阶段：笔记能力建设（单笔记）——「活沉淀」定位：渲染/编辑/版本/时间戳回链/标签（2026-08-21 头脑风暴定稿，含市场优点融合+舍弃清单） | 发版文档（已实施 2026-08-21，真机验收待执行） |
| v0.10.1 | v0.10.1.md — 笔记编辑机制修复 + 笔记图片功能（串写修复/版本去重/resolve_note_image 三命令 + NoteImage） | 发版文档（已实施 2026-08-21） |
| v0.10.2 | v0.10.2.md — 结构图准确性重构：参考图集单一分析 + 三层过滤（L0 字幕重叠 / L1 版面类型 / L2 OCR 置信度反向 / L3 位置约束） | 发版文档（规划定稿 2026-08-21） |
| v0.11 | v0.11.md — 大目标版本系列：笔记组与学习循环（v0.11.0 组基建容器侧 / v0.11.1 feed 进料 / v0.11.2 FSRS 学习循环 / v0.11.3 组结算 / v0.11.4 内容分型+周契约+feed 消费闭环，v4 Phase 1-3 落地） | 系列文档（代码已交付 2026-08-22，真机验收待执行） |
| v0.11.5 | v0.11.md — 采集体验与笔记打磨（档案采集中可改+记忆机制修正 / 识别率增强 / 窗口刷新 / 编号序号化 / 新颖度变化区域 / 水印 A+B+C / 产物视图下线+精修懒自动 / 精修工作台 / 锚点剥离 / 画面要点移出笔记 / 笔记页树形合并+缩略图，2026-08-22 交付） | 版本文档（代码已交付 2026-08-22，真机验收待执行） |
| v0.11.6 | v0.11.6.md — AI 平台化：Provider 抽象 + 能力声明化 + 产出策略定制（三层；M1→M3 排期） | 版本文档（规划中 2026-08-22） |
| v0.11.7 | v0.11.7.md — 图文会话：截屏导入 + 跨链路采集体验同步（kind 字段 + 5 命令 + 框选遮罩；排期于 v0.11.6 之后） | 版本文档（规划中 2026-08-22） |
| v0.12.0 | v0.12.0.md — 图文与窗口捕获重塑：正文源多态 + WGC 抗遮挡 + 系统级截屏覆盖层 + DeepSeek 默认化 + vision 精修 + 采集浮窗化（M1-M7，七项改进修正五个断裂） | 版本文档（规划定稿 2026-08-23；M1-M7 全部已交付，真机验收待执行） |
| v0.12.1 | v0.12.1.md — OCR 引擎回归修复：oar-ocr auto-download 误关（v0.12.0 构建修复连带）+ 引擎就绪状态真实化（engine_ready 四处落地）+ 图文会话讲者分析误报修复 | 版本文档（代码已交付 2026-08-23，真机验收回归路径待执行） |
| v0.12.2 | v0.12.2.md — 笔记页信息架构重构：三栏布局（组筛选/笔记列表/阅读编辑）+ 收件箱动线（二元论碎片→升笔记补口子）+ 路由信息收敛（ⓘ 弹层）+ 新建零对话框 | 版本文档（规划定稿 2026-08-23；未启动，顺延为后续版本候选） |
| v0.12.3 | v0.12.3.md — 真机验收两雷同修：浮窗/覆盖层窗口创建死锁（sync 命令主线程建窗，wry#583）+ 精修工作台 serde camelCase 契约漏网（ruleMarkdown undefined.split 崩）；附带浮窗交互层（双形态/拖拽吸附/穿透锁定/置顶/透明度/回主窗）与架构层（常驻预创建/状态收敛/capabilities 拆分） | 版本文档（代码已交付 2026-08-23，真机验收待执行） |
| v0.12.4 | v0.12.4.md — 旧改动完整性修复：视频会话画面要点纯图落地（删直播/导入两条残留 region OCR，关键帧纯图归档，展示层按 kind 分派）+ 笔记预览时间戳锚点 chip 化（renderTimestampAnchors 接入两个轻量字符串渲染器） | 版本文档（代码已交付 2026-08-23，真机验收待执行） |
| v0.12.5 | v0.12.5.md — AI 精修线路修复：工作台采纳前右侧恒空（refine_workbench 三级数据源 + 未采纳任务持久化兜底）+ 线路优化（完成即自动打开工作台 / 采纳回传 taskId / 重新生成走父级管线） | 版本文档（代码已交付 2026-08-23，真机验收待执行） |
| v0.12.6 | v0.12.6.md — 采集浮窗显隐链路修复：启动自动显示（预创建参数传反）+ 浮窗出现→主窗隐藏/收起→回显 + 锁定自解锁（ADR-025：全局快捷键 Ctrl+Shift+F，float_toggle 单一语义）+ 浮窗窗口级 CSS 重置（两侧透明条/滚条） | 版本文档（代码已交付 2026-08-23，真机验收待执行） |
| v0.12.7 | v0.12.7.md — 会话内部 ID 不外显：采集/导入/融合/任务中心等用户可见文案全部去掉「会话 #N」，仅保留显示序号 display_no（与内部 id 解耦） | 版本文档（代码已交付 2026-08-23） |
| v0.12.8 | v0.12.8.md — 笔记列表级批量删除：行内勾选 + 底部批量操作栏（全选三态/计数/批量删除），与会话管理台同操作逻辑，无需先打开笔记 | 版本文档（代码已交付 2026-08-23） |
| v0.13 | v0.13.md — 大目标版本系列：知识体系层（v0.13.0 理念修订批/ADR-024 / v0.13.1 体系基建 / v0.13.2 概念双面体 / v0.13.3 决策与应用 / v0.13.4 审计与整合；方案 B：全局+领域双层、组仍唯一容器、REQ-202~212；v0.13.7 体系上手路径：入口补全+具象化；v0.13.8 画布可视化：React Flow 节点式无限画布） | 系列文档（v0.13.1 代码已交付 2026-08-23，真机验收待执行；v0.13.2~4 未启动，REQ-146 门控；v0.13.7 代码已交付 2026-08-24；v0.13.8 代码已交付 2026-08-24，真机验收待执行） |
| v0.14 | v0.14.md — 体验与质量攻坚系列：A 编辑器基础体验（CodeMirror 6）/ B 视觉系统（四级颜色）/ C 知识体系架构（Obsidian 式组侧栏 + 多关系分层图谱 + 深度联动 v2）/ D 采集质量（章节级混合形态 + 质量门控 + 版面重建/行合并/跨帧增量 + 平台模板适配） | 版本文档（2026-08-27~28 头脑风暴定稿；A 代码已交付 2026-08-28，真机验收待执行；B/C/D 设计完成待实施） |
| v0.14.1 | v0.14.1.md — 笔记组 CRUD（新建/行内重命名/影响面确认后级联删除）+ 知识画布连线/布局选项（连线 4 样式+箭头开关、布局 6 算法、按体系持久化） | 版本文档（2026-08-29 设计定稿，待实施） |
| v0.15 | v0.15.md — 笔记体验打磨：标题切换语义 + 全站列自适应（拖拽/记忆/窄窗折叠）+ 分组树与整列折叠 + 图片落盘三入口（剪贴板/外链/文件）+ 编辑态剪贴板导入图片 + remark-breaks 换行一致 | 版本文档（代码已交付 2026-08-30，真机验收待执行） |
| v0.16.0 | v0.16.0.md — 内嵌 AI 对话（纯聊天 · DSH 蓝本）：AI 对话页 + 流式/停止/重发 + 会话管理 + 每会话模型 + 授权/成本/审计 + 任务对话视图（REQ-224~230） | 版本文档（代码已交付 2026-08-30） |
| v0.16.1 | v0.16.1.md — 用户反馈批·体验修复与 AI 对话闭环：图片插入 RangeError 修复 + 正文多色 ==[色]文本==（含 hName 缺陷修复）+ 对话转笔记双入口 + 任务对话化（线程卡/追问//命令/精修自动跳转）+ 工作台深链 + 右键菜单完整性 + 浏览器原生右键菜单去除（REQ-238~244） |
版本文档（代码已交付 2026-08-31） |
| v0.17.0 | v0.17.0.md — AI 精修可到达度：策略化提示词（JSON v3 声明/四档阶梯/六旋钮/书面目标 chips/预览所见即所发）+ 笔记级 AI 能力（编辑态 🤖 AI 统一入口/手写档案/内容传参/工作台笔记级）+ 精修流式会话化（片级解析流事件/对话卡流式正文/完成双入口）（REQ-245~247，ADR-026） | 版本文档（代码已交付 2026-09-01） |
| v0.17.1 | v0.17.1.md — bug 修复：知识补充轨迹 NULL 列崩溃（get_ai_task_trajectory Option 化）+ 笔记级精修卡住（NoteAiDialog hook taskIdRef 接线 + 结果取回防御） | 版本文档（代码已交付 2026-09-01） |
| v0.18.0 | v0.18.0.md — 学习目标层 M1：目标对象 + 访谈式设定（四步+宣言+里程碑草案）+ 跨组聚合看板（REQ-030 激活/REQ-248~250，ADR-027；M1 代码已交付 2026-09-02，真机验收待执行） | 版本文档（M1 已实施） |
| v0.18.1 | v0.18.1.md — 学习目标层 M2：毕业仪式 + 回顾流时间线 + 暂停/放弃 + 组删除降级提示（REQ-255~257；报告快照目标删除后仍可读） | 版本文档（M2 已实施 2026-09-02，真机验收待执行） |
| v0.18.2 | v0.18.2.md — AI 目标规划师：规划建议+体系深度联动（建议制·默认关；协议/预算/摘要/弱项/双入口确认流已交付——REQ-251~254，ADR-028） | 版本文档（M1 批已实施 2026-09-02，设置段//goal 下批） |
| v0.19.0 | v0.19.0.md — 检索与发现层·索引基建：kb 派生三表 + 生命周期钩子 + reindex_all/stats + kb_search 全库混合检索（切词校准=trigram+2 字 LIKE；FTS-only 可发布——REQ-258，ADR-029） | 版本文档（已实施 2026-09-03，真机验收待执行） |
| v0.19.1 | v0.19.1.md — 读路径 A 学习库问答「问我的学习库」：📚 会话模式 + 命中恒可用 + 双闸门生成（pack_fragments 转正/预算/审计）+ 引用 chips 跳笔记高亮命中词 + 设置「学习库」段（REQ-260/262 部分） | 版本文档（已实施 2026-09-03，真机验收待执行） |
| v0.19.2 | v0.19.2.md — 采集体验小版本：窗口选择增强（抖音/快手/B站客户端评分表 + z 序置顶 + 系统窗口过滤开关找回）+ 开始即录门控（15s 就绪等待自动开录/等待期无采集中控件/AV 同刻，REQ-271~273；REQ-261/259 顺延 v0.19.3/v0.19.4） | 版本文档（已实施 2026-09-03，真机验收待执行） |
| v0.19.3 | v0.19.3.md — 读路径 B 检索建议（发现路径）：概念「相关素材建议」候选（排除已链接）+ 勾选确认经引用通道落库（建议零双写）+ 跨体系相似概念提示（不自动合并）+ kb_discovery 默认关（REQ-261/262 余项） | 版本文档（已实施 2026-09-03，真机验收待执行） |
| v0.19.4 | v0.19.4.md — AI 任务体验与标识治理批（2026-09-04 用户反馈批）：全局 AI 对话面板（丙案·按需唤起+内容保活）+ 响应速度帧级批量渲染 + 挂体系浮层残缺修复 + 裸号显示治理与 notes/sessions uid 基建 + 通用变更事件总线（data:* 五域）+ 精修程度「自定义」+标准恒纯净 + 联合整理远期登记（REQ-274~280；REQ-259 顺延 v0.19.5） | 版本文档（已实施 2026-09-04，真机验收待执行） |
| v0.19.5 | v0.19.5.md — 语义增强：本地 embedding（REQ-259/262 余项）——bge-small-zh ONNX 内嵌引擎 + BERT 分词 + kb 向量回填 + 混合检索 RRF 合流 + 下载/加载/状态治理 UI（244ea92→cd9bcee 七提交；真机模型实测待执行） | 版本文档（已实施 2026-09-04，真机验收待执行） |
| v0.19.6 | v0.19.6.md — 用户反馈批一：焦点采集自愈（帧心跳 + WGC watchdog + 停更提示）+ 标题内容化 + 拖拽修复 + 精修埋点先行（REQ-281/282/285/290③） | 版本文档（已实施 2026-09-05，4c7dad0~843886e0 五提交；真机验收待执行） |
| v0.19.7 | v0.19.7.md — 用户反馈批二：画面理解开关入精修发起弹层 + AI 精修加速（片内流式 NDJSON + 输出预算化）+ 挂体系轻建 + 笔记列表交互重构（REQ-284/286/287/290①②/291） | 版本文档（已实施 2026-09-05，c0c6eff~7460ae3 九提交；真机验收待执行） |
| v0.20 | v0.20.md — ASR 质量增强系列（自验证路线）：v0.20.0 asr_eval harness + 首轮报告（REQ-263）→ v0.20.1 DTW 接线/参数定案族/热词加固/积压验证（REQ-264 |
系列文档（v0.20.0/0.20.1 已交付 2026-09-05（首轮报告与标定结论页归档，全量 2159 绿）· v0.20.2 已实施 2026-09-06（REQ-268 |
| v0.22 | v0.22.md — 前端重设计系列（组件体系 / 布局 / 动效 · L0–L6 全层）：批 0 基座（ADR-032~035 + 修订 ADR-010 + 豁免表纠偏 + 拆 4 个超限文件 + token 层 + 图标集 + 原语三层）→ 批 1 删除批（21 命令）→ 批 2 包体治理 → 批 3 壳层 → 批 4 原语迁移 → 批 5 视图层样板 → 批 6 动效系统 → 批 7 未接线落地 → 批 8 治理收口；权威规格见 superpowers/specs/2026-09-11-frontend-redesign-design.md | 系列文档（设计已批准 2026-09-11 · 待实施；版本归属取 v0.22 因 v0.21 已由执行型智能体预留——不插队不改预留） |
- 何时沉淀：版本含重大架构变更、多模块协同发版、或值得事后回顾的决策时，为版本撰写深度文档
- 目录 vs 单文件：单一文档用
vX.Y.Z.md；多文档合集建vX.Y.Z/目录，内部文档用NN-描述.md编号 - 命名：文件名使用 kebab-case 或中文短描述，禁止带版本号之外的临时后缀（如
重制2） - 缺失版本：未沉淀深度文档的版本，变更记录在 CHANGELOG 中追溯即可，无需补写
- 发版前：更新 CHANGELOG（按 Keep a Changelog 格式）
- 发版时：按需撰写本目录深度文档
- 发版后：更新 README 版本徽章（如有）与根 README 路线图