更新备忘录和项目规划-v10.2完成记录

Author: zcj220

开发备忘录.md

@@ -1,6 +1,6 @@
 # TestPilot AI 开发备忘录
 
-> 最后更新：2026-03-07（v10.2 多端Demo验证推进中 | 小程序Demo+桌面蓝本+MCP工具+API端点+940测试）
+> 最后更新：2026-03-07（v10.2 完成 | 独立蓝本多选+start_command自动启动+全局蓝本UI+编程AI智能审视 | 947测试）
 > 项目结构详见 README.md，此处不重复。
 
 ---
@@ -705,46 +705,66 @@ MCP配置文件位置：`~/.codeium/windsurf/mcp_config.json`（即 `C:\Users\
 
 ---
 
-### v10.2 进展记录（2026-03-07）
-
-#### 已完成
-
-**测试修复**
-- `tests/test_blueprint_generator.py`：`test_from_url_full_flow` mock修复（chat替代analyze_screenshot）
-- 932测试全通过
-
-**shop-demo 响应式布局**
-- `shop-demo/index.html`：添加 viewport meta
-- `shop-demo/style.css`：添加 `@media (max-width: 768px)` 响应式规则
-- 侧边栏变顶部横排、统计卡片两列、表格紧凑、表单纵向排列
-
-**微信小程序 Demo（miniprogram-demo/）**
-- 含4个预埋Bug的测试小程序（BuggyMini）
-- Bug1: 机械键盘加入购物车价格从199变599
-- Bug2: 总价浮点精度问题
-- Bug3: 空购物车直接跳转不提示
-- Bug4: 总价超500结算报Error 500
-- 包含 testpilot.json 蓝本
-
-**桌面应用测试蓝本（desktop-demo/）**
-- `desktop-demo/testpilot.json`：应用启动验证+页面导航场景
-
-**MCP 新增工具（共9个）**
-- `run_miniprogram_test`：小程序蓝本测试
-- `run_desktop_test`：桌面应用蓝本测试
-
-**API 新增端点**
-- `POST /api/v1/test/miniprogram-blueprint`：小程序蓝本测试
-- `POST /api/v1/test/desktop-blueprint`：桌面应用蓝本测试
-
-**单元测试**
-- `tests/test_mcp_server.py`：新增8个测试（小程序+桌面MCP工具）
-- 总测试数：932 -> 940，全部通过
-
-#### 下次待办
-
-1. **手机实机验证**：USB连Android手机，启动Appium，运行 `run_mobile_blueprint_test`
-2. **小程序实机验证**：安装微信开发者工具，开启服务端口，运行 `run_miniprogram_test`
-3. **桌面应用实机验证**：启动Tauri桌面应用，运行 `run_desktop_test`
-4. **蓝本功能描述模式（v10.3）**：URL + 功能简述 -> AI全自动蓝本
+### v10.2 完成记录（2026-03-07）
+
+#### 核心功能
+
+**独立蓝本多选+批量执行**
+- Blueprint模型添加 `description` 字段（50-200字功能说明）
+- 后端API：`GET /blueprint/list` 扫描蓝本列表 + `POST /test/blueprint-batch` 批量执行
+- MCP工具：`list_blueprints` + `run_blueprint_batch`（共11个工具）
+- 插件UI：下拉框改为多选框列表，显示蓝本元数据+悬浮说明预览
+- 全选按钮 + 批量测试汇总报告
+
+**蓝本统一存放规范**
+- 6个demo蓝本全部移入 `testpilot/` 子文件夹
+- 预览服务器扫描逻辑适配 `testpilot/` 目录
+- copilot-instructions更新：要求按功能模块拆分蓝本（auth/product/order）
+
+**start_command自动启动应用**
+- Blueprint模型添加 `start_command` 和 `start_cwd` 字段
+- BlueprintRunner测试前自动启动应用并等待就绪（最多30秒）
+- 支持 `npm start`、`python app.py`、`docker-compose up` 等命令
+- 纯HTML应用留空，走内置预览服务器
+
+**全局蓝本优先级UI**
+- 蓝本列表顶部固定 🌍 全局蓝本选项（默认勾选）
+- 勾选全局 → 局部蓝本全部灰化禁用 + 悬浮提示
+- 取消全局 → 局部蓝本恢复可选
+- 全选按钮只影响局部蓝本
+
+**编程AI智能审视蓝本**
+- copilot-instructions新增规则：代码变化时自动审视并更新对应模块蓝本
+- 6种触发条件（覆盖Web/小程序/手机/桌面）：
+  1. 新增/删除UI元素
+  2. 修改元素ID/class/选择器
+  3. 修改文本内容
+  4. 修改业务逻辑
+  5. 修复Bug
+  6. 修改应用配置（URL/端口/路由/权限/启动入口）
+- 其他情况（CSS/注释/重构）自动跳过，节省token
+
+**插件UI优化**
+- 修复侧边栏窄宽度下蓝本列表溢出问题
+- 文字单行省略 + overflow-x:hidden
+- 蓝本生成提示词更新：要求按模块拆分 + 填写start_command
+
+#### 测试数据
+- 总测试数：940 -> 947（新增7个批量蓝本测试）
+- 全部通过
+
+#### Git提交
+- c0c9d78: 蓝本统一放testpilot/文件夹+修复UI溢出
+- 802b127: start_command自动启动+预览服务器适配
+- 20ead48: 全局蓝本优先级UI+互斥逻辑
+- fbd7f73: copilot-instructions更新+编程AI自动审视蓝本
+- 4d823e0: 简化蓝本检查规则-只列出需要检查的6种情况
+- 3c33dca: 蓝本检查规则扩展-全平台覆盖
+
+#### 下一步（v10.3）
+
+**蓝本功能描述模式（终极目标）**
+- 用户输入：URL + "这个应用有：登录、商品管理、订单管理"
+- AI全自动生成蓝本 → 测试 → 修复 → 0 Bug
+- 无需录制，无需人工参与，完全自动化
 

项目规划.md

@@ -1141,15 +1141,15 @@ TestPilot AI 核心引擎（通用，只需写一次）
 | v9.0 | 多端协同测试(协调器+AI扮演+录制回放+一致性+网络模拟+设备池) | ✅ | Phase1-3全部完成 |
 | v10.0 | IDE插件完善+MCP闭环稳定+蓝本质量提升 | ✅ | 2026-03-06完成 |
 | v10.1 | 蓝本自动生成+引擎内置Preview服务器+MCP/插件集成 | ✅ | 2026-03-06完成 |
-| v10.2 | 多端Demo验证（手机/小程序/桌面 闭环演示） | 🚧 下一步 | 近期 |
-| v10.3 | 蓝本功能描述模式（用户说功能→AI生成全覆盖蓝本） | 📋 计划中 | 近期 |
+| v10.2 | 独立蓝本多选+start_command自动启动+全局蓝本UI+编程AI智能审视 | ✅ | 2026-03-07完成 |
+| v10.3 | 蓝本功能描述模式（用户说功能→AI生成全覆盖蓝本） | 📋 下一步 | 近期 |
 | v11.0 | Mac/Linux/iOS+高级手势+性能基准(按需) | 📋 远期 | 按用户反馈 |
 
 ---
 
 ## 十一、下一阶段规划（v10.1～v10.3）
 
-> 最后更新：2026-03-06
+> 最后更新：2026-03-07
 
 ### v10.1 — 蓝本自动生成（从URL到testpilot.json）
 
@@ -1181,14 +1181,53 @@ TestPilot AI 核心引擎（通用，只需写一次）
 
 ---
 
-### v10.2 — 多端Demo验证
-
-**目标**：验证手机/小程序/桌面应用的完整闭环，与Web端闭环对齐。
-
-**子任务**：
-1. **手机浏览器**：shop-demo加响应式布局，USB连Android手机，运行 `run_mobile_blueprint_test`，验证闭环
-2. **微信小程序**：安装开发者工具+miniprogram-automator，新建含Bug小程序，运行 `MiniProgramController`，添加MCP工具 `run_miniprogram_test`
-3. **Windows桌面应用**：用已安装的Tauri桌面应用为被测对象，`DesktopController`跑测试，添加MCP工具 `run_desktop_test`
+### v10.2 — 独立蓝本多选+自动启动+全局蓝本UI（已完成）
+
+**✅ v10.2 完成内容（2026-03-07）**：
+
+**独立蓝本多选+批量执行**
+- Blueprint模型添加 `description` 字段（50-200字功能说明）
+- 后端API：`GET /blueprint/list` 扫描蓝本列表 + `POST /test/blueprint-batch` 批量执行
+- MCP工具：`list_blueprints` + `run_blueprint_batch`（共11个工具）
+- 插件UI：下拉框改为多选框列表，显示蓝本元数据+悬浮说明预览
+- 全选按钮 + 批量测试汇总报告
+
+**蓝本统一存放规范**
+- 6个demo蓝本全部移入 `testpilot/` 子文件夹
+- 预览服务器扫描逻辑适配 `testpilot/` 目录
+- copilot-instructions更新：要求按功能模块拆分蓝本（auth/product/order）
+
+**start_command自动启动应用**
+- Blueprint模型添加 `start_command` 和 `start_cwd` 字段
+- BlueprintRunner测试前自动启动应用并等待就绪（最多30秒）
+- 支持 `npm start`、`python app.py`、`docker-compose up` 等命令
+- 纯HTML应用留空，走内置预览服务器
+
+**全局蓝本优先级UI**
+- 蓝本列表顶部固定 🌍 全局蓝本选项（默认勾选）
+- 勾选全局 → 局部蓝本全部灰化禁用 + 悬浮提示
+- 取消全局 → 局部蓝本恢复可选
+- 全选按钮只影响局部蓝本
+
+**编程AI智能审视蓝本**
+- copilot-instructions新增规则：代码变化时自动审视并更新对应模块蓝本
+- 6种触发条件（覆盖Web/小程序/手机/桌面）：
+  1. 新增/删除UI元素
+  2. 修改元素ID/class/选择器
+  3. 修改文本内容
+  4. 修改业务逻辑
+  5. 修复Bug
+  6. 修改应用配置（URL/端口/路由/权限/启动入口）
+- 其他情况（CSS/注释/重构）自动跳过，节省token
+
+**插件UI优化**
+- 修复侧边栏窄宽度下蓝本列表溢出问题
+- 文字单行省略 + overflow-x:hidden
+- 蓝本生成提示词更新：要求按模块拆分 + 填写start_command
+
+**测试数据**：940 -> 947（新增7个批量蓝本测试），全部通过
+
+**Git提交**：c0c9d78, 802b127, 20ead48, fbd7f73, 4d823e0, 3c33dca
 
 ---