docs: 更新备忘录+规划至v12.2完成

Author: zcj220

开发备忘录.md

@@ -1,6 +1,6 @@
 # TestPilot AI 开发备忘录
 
-> 最后更新：2026-03-12（桌面测试增强 | 97%通过率 | client区域截图+pywinauto+AI OCR | 坑16-22）
+> 最后更新：2026-03-15（AI中枢v12.0-12.2完成 | L0.5规则预判+L2归因+FaultType标签 | 坑16-22）
 > 项目结构详见 README.md，此处不重复。
 
 ---
@@ -107,6 +107,9 @@ git pull && poetry install && cd desktop && npm install && npm run build
 | v10.1 | ✅ IDE插件蓝本生成重设计：<br>**废弃**：URL→AI爬取HTML→生成蓝本（原理缺陷：看不到JS逻辑/未触发状态/容易超时）<br>**新方案**：插件提供「📋 复制蓝本生成提示词」按钮 → 用户粘贴到Cursor/Windsurf → 编程AI读源码生成精准蓝本<br>核心哲学：**编程AI是第一负责人**，TestPilot只做执行器 |
 | v10.2 | ✅ 蓝本生成提示词13条黄金规则（含深度Bug挖掘+功能文档参考+截图策略+功能模块拆分+增量更新）|
 | v10.3 | ✅ **截图策略修复+Session管理**（commit 2115af2）：<br>**Bug修复**：引擎每步都截图→改为按需截图（仅蓝本写了screenshot或有expected时）<br>**Session清理**：安卓项目切换后旧session残留→自动检测失效并清理<br>**蓝本拆分验证**：mobile-demo拆为5个功能模块蓝本，PC测试249/251通过(99.2%) |
+| v12.0 | ✅ **AI中枢决策层AIHub**（commit 85b0481）：跨平台统一AI大脑，L0直通→L1弹窗自愈→L2失败诊断→L3场景熔断，Bridge模式接入三大Runner |
+| v12.1 | ✅ **L2升级：截图+步骤历史**（commit bea4c10）：StepRecord自然语言描述，L2发截图+历史问AI像人一样分析，三Runner统一record_step |
+| v12.2 | ✅ **归因预判FaultType**（commit 6f634e1）：L0.5规则预判零token判定APP Bug，L2提示词加fault归因，Bug标签[应用Bug]/[测试问题] |
 
 - 测试总数：**932个**，全部通过
 - 引擎端口：**8900**（统一）
@@ -2116,3 +2119,58 @@ if bp_dir.name == "testpilot":
 - `mobile_blueprint_runner.py` 导入测试：✅ OK
 - 引擎启动（端口8900）：✅ 正常，无报错
 - API健康检查：✅ 200 OK
+
+#### 13.23.4 L2升级：截图+步骤历史直接问AI（v12.1, 2026-03-14）
+
+**核心改进：** L2不再只看当前步骤，而是把最近8步操作历史一起发给AI，像"坐在你旁边的同事看图说话"。
+
+**新增类/字段：**
+- `StepRecord` dataclass：step_num/action/target/value/passed/error + `describe()` 方法（自然语言描述）
+- `AIHub._step_history`：最近8步操作记录列表
+- `AIHub.record_step()`：Runner每步执行完都调用
+- `AIHub._build_history_context()`：拼成大白话历史供L2分析
+- `AIHub.on_scenario_start()`：场景开始时清空历史
+
+**L2提示词核心改变：** 把步骤历史+当前失败+截图三合一发给多模态AI，AI像人一样观察分析。
+
+**三Runner改造：**
+- 每步执行后统一调用 `hub.record_step(step_num, action, target, value, passed, error)`
+- SKIP_STEP 处理：三个Runner统一支持
+
+**验证（故意打破蓝本测试L2）：**
+- 改坏 `add_priority.testpilot.json`：选择器写错 + 断言不可能通过
+- L2成功诊断："添加的High优先级任务实际显示为Medium优先级"（AI看截图看到了`[M] Fix critical bug`）
+- 结果：7/9通过，2个Bug正确识别，L1调2次，L2调2次
+
+**发现的问题：**
+- JSON中文引号导致`json.loads`失败（`"xxx"` → 需替换为`"xxx"`）
+- 大截图(393KB)可能超AI超时(25秒)
+
+#### 13.23.5 归因预判：谁的锅？（v12.2, 2026-03-14）
+
+**问题：** 所有失败都调AI分析 → 浪费token。但"文本不匹配"这种100%是应用Bug，不需要AI看。
+
+**L0.5规则预判（零token）：**
+```
+步骤失败 → AIHub.on_step_failed()
+  → L3 熔断（无AI）
+  → L0.5 规则预判（无AI）
+       ├─ "文本断言失败: 预期'X', 实际'Y'" → APP Bug，不调AI ✅
+       ├─ "计算验证失败" → APP Bug，不调AI ✅
+       └─ 其他 → 继续L1/L2（调AI）
+  → L1 弹窗自愈（AI截图）
+  → L2 失败诊断+归因（AI截图+历史）
+```
+
+**新增 `FaultType` 枚举：**
+- `APP` — 应用的Bug（数据错误/崩溃/功能异常）→ 报给编程AI
+- `TEST` — 测试脚本/框架问题（选择器错/时序/弹窗）→ 中枢自己处理
+- `UNKNOWN` — 无法判断
+
+**Bug标签系统：** Runner根据 `decision.fault` 给Bug.category加前缀：
+- `[应用Bug]文本断言失败` → 编程AI该修
+- `[测试问题]步骤执行错误` → 我们的问题，编程AI不用管
+
+**L2提示词升级：** 要求AI同时判断fault归因 + 中文引号容错修复
+
+**统计新增：** `hub.stats["rule_judgments"]` — 规则预判次数（省了多少次AI调用）

项目规划.md

@@ -1,7 +1,7 @@
 # TestPilot AI - 项目规划文档
 
-> **项目状态**：v10.5全部完成✅ | Web+小程序+Android端到端验证通过 | 5平台蓝本各1本 | AI蓝本生成提示词已验证
-> **最后更新**：2026-03-10
+> **项目状态**：v12.2完成✅ | AI中枢决策层+归因预判 | 5平台蓝本+三大Runner统一AIHub
+> **最后更新**：2026-03-15
 > **项目名称**：TestPilot AI（已确认）
 > **项目文件夹**：TestPilotAI
 
@@ -1207,17 +1207,17 @@
 | v10.5 小程序蓝本测试闭环 | 通用执行器+AI蓝本生成提示词+地雷挖掘验证 | ✅ 2026-03-08 |
 | v10.6 Android真机实测 | Flutter真机92%通过率+U2自动恢复+蓝本提示词同步 | ✅ 2026-03-10 |
 
-**当前执行顺序：v11.0**
+**当前执行顺序：v13（后续）**
 
 | 步骤 | 内容 | 优先级 | 状态 |
 |------|------|:---:|------|
-| **v10.6+ 弹窗自愈+蓝本拆分** | 弹窗自愈机制+TodoApp蓝本独立模块化 | 🔴 最高 | 🔄 进行中 |
-| **v11.0-A 端到端实测验证** | Windows桌面蓝本实测验证 | 🔴 高 | 下一步 |
-| **v11.0-B 调试记忆+社区经验库** | 个人记忆增强+匿名云端共享+成就勋章 | 🔴 高 | 紧随其后 |
-| **v11.0-C 商业化上线准备** | 用户注册API对接前端+付费积分系统+部署方案 | 🔴 高 | 之后做 |
+| **v10.6+ 弹窗自愈+蓝本拆分** | 弹窗自愈机制+TodoApp蓝本独立模块化 | 🔴 最高 | ✅ 已完成 |
+| **v11.0-A 端到端实测验证** | Windows桌面蓝本实测验证（97%通过率） | 🔴 高 | ✅ 已完成 |
+| **v12.0-12.2 AI中枢决策层** | AIHub+L2截图诊断+归因预判FaultType | 🔴 高 | ✅ 已完成 |
+| **v11.0-B 调试记忆+社区经验库** | 个人记忆增强+匿名云端共享+成就勋章 | 🔴 高 | 📋 下一步 |
+| **v11.0-C 商业化上线准备** | 用户注册API对接前端+付费积分系统+部署方案 | 🔴 高 | 📋 下一步 |
 | **v11.0-D API开放+文档** | RESTful API文档+第三方接入指南+SDK | 🟡 中 | 之后做 |
 | **v11.0-E 发布准备** | VSCode Marketplace+安装包+官网+文档 | 🟡 中 | 最后 |
-| **v12.0 AI中枢决策层** | 引擎从"AI当工具"升级为"AI当大脑" | 🟡 中 | 蓝本拆分+弹窗自愈完成后 |
 
 ---
 
@@ -1253,7 +1253,7 @@ todo-demo/testpilot/
 
 ---
 
-## v12.0 AI中枢决策层（架构规划）
+## v12.0 AI中枢决策层（✅ 已完成 v12.0-12.2）
 
 > **愿景**：引擎从"AI当工具"升级为"AI当大脑"，像真人测试员一样观察→理解→决策→行动。
 
@@ -1397,13 +1397,15 @@ TestPilot AI 核心引擎（通用，只需写一次）
 | v10.3 | 插件改造：项目隔离+平台路由+Tooltip分区+前置检查 | ✅ | 2026-03-08完成 |
 | v10.5 | 小程序蓝本测试闭环：通用执行器+AI蓝本提示词+地雷验证 | ✅ | 2026-03-08完成 |
 | v10.6 | Android真机实测：Flutter 92%通过+U2自动恢复+提示词同步 | ✅ | 2026-03-10完成 |
-| v10.6+ | 弹窗自愈机制+TodoApp蓝本独立模块化 | 🔄 | 进行中 |
-| v11.0-A | 端到端实测：Windows桌面蓝本测试验证 | 📋 下一步 | 近期 |
+| v10.6+ | 弹窗自愈机制+TodoApp蓝本独立模块化 | ✅ | 2026-03-12完成 |
+| v11.0-A | 端到端实测：Windows桌面蓝本测试验证（97%通过率） | ✅ | 2026-03-12完成 |
+| v12.0 | AI中枢决策层：L0直通→L1弹窗自愈→L2诊断→L3熔断 | ✅ | 2026-03-14完成 |
+| v12.1 | L2升级：截图+步骤历史直接问AI，像人一样分析 | ✅ | 2026-03-14完成 |
+| v12.2 | 归因预判FaultType：L0.5零token判APP Bug+Bug标签 | ✅ | 2026-03-14完成 |
 | v11.0-B | 调试记忆+社区经验库：个人记忆增强+匿名云端+成就勋章 | 📋 下一步 | 近期 |
 | v11.0-C | 商业化上线：注册API前端对接+积分系统+部署 | 📋 中期 | 按需 |
 | v11.0-D | API开放：RESTful文档+第三方接入+SDK | 📋 中期 | 按需 |
 | v11.0-E | 发布准备：Marketplace+安装包+官网+文档 | 📋 中期 | 按需 |
-| v12.0 | AI中枢决策层：L1弹窗自愈→L2上下文理解→L3全局决策 | 📋 中期 | 蓝本拆分后 |
 | v13.0 | Mac/Linux/iOS+高级手势+性能基准 | 📋 远期 | 按用户反馈 |
 
 ---