docs: 版本回归分析+小程序卡住排查+4项修复确认未丢失

Author: zcj220

开发备忘录.md

@@ -2620,3 +2620,106 @@ ssh -i $pem $srv "cd /opt/testpilot/app/web && npm run build && sudo cp -r dist/
 - **现象**：SCP上传后 `npm run build` 报 JSX 语法错误（Unexpected token）
 - **根因**：文件末尾有重复的旧代码段（完整的 `</form>` 到第二个 `}` 都重复了一次）
 - **修复**：用 `replace_string_in_file` 删除重复尾部，重新上传重建成功
+
+---
+
+## 17. 版本回归与未提交修复丢失（2026-03-17）
+
+### 17.1 版本对比结论
+
+#### 问题描述
+用户反映：3月15日下午4点上传的版本运行正常，但3月17日上传v13.2后感觉"插件不如之前好了"，小程序测试时似乎卡住不停止。
+
+#### Git历史对比
+
+| 版本 | 提交 | 时间 | 说明 |
+|------|------|------|------|
+| **稳定版** | `dff0933` | 3/15 16:45 | chore: switch domain to testpilot.xinzaoai.com |
+| **v13.2** | `8ee17d9` | 3/17 13:32 | HTTPS上线+下载页+导航优化+扩展按钮状态修复+经验库fallback |
+
+#### 关键发现
+1. **核心测试引擎代码(src/testing/, src/api/, src/core/)在两个版本之间完全没有改动**
+2. v13.2的改动仅限于：
+   - `extension/src/sidebarProvider.ts` — 插件UI优化（启动/断开按钮合并、经验库fallback远程服务器）
+   - `web/` — 官网页面（下载页、导航、国际化）
+   - `src/auth/` — 认证服务
+   - `deploy/` — Nginx配置
+   - 文档（备忘录、规划）
+3. **测试执行流程（runTest/stopTest/testComplete/progress）在diff中完全没有出现**
+
+#### 结论
+v13.2的提交本身**不应导致测试卡住**。可能的原因：
+- **环境差异**：单位电脑和家里电脑的环境（Python版本、依赖、微信开发者工具版本）不同
+- **小程序测试长脚本**：蓝本步骤多时AI调用耗时长，看起来像"卡住"但实际还在跑
+- **网络波动**：AI API偶发超时（30秒timeout），多个超时叠加可能导致看起来很久不动
+
+### 17.2 ⚠️ 3月14日未提交的修复已丢失
+
+以下修改在3月14日会话中做了但**未提交到Git**，被v13.2覆盖：
+
+| 修改 | 文件 | 作用 | 状态 |
+|------|------|------|------|
+| OCR prompt改英文 | `desktop_blueprint_runner.py` | 解决OCR只返回标题"Todo App"的问题 | ❌ 丢失 |
+| 弹窗按钮跳过预分析缓存 | `desktop_blueprint_runner.py` | 解决OK/Yes等弹窗按钮用旧坐标点不到 | ❌ 丢失 |
+| 弹窗必须关闭规范 | `.windsurf/workflows/blueprint.md` | 蓝本规范新增弹窗铁律 | ❌ 丢失 |
+| TodoApp蓝本弹窗关闭步骤 | `todo-demo/testpilot.json` | 蓝本在弹窗后加OK/Yes关闭步骤 | ❌ 丢失 |
+
+**铁律：做完修改必须立即git commit，不能只改不提交。跨会话/跨设备同步全靠Git。**
+
+### 17.3 需要重新实施的修复清单
+
+以下修复需要在下次会话中重新做：
+
+1. **OCR prompt改英文**（`desktop_blueprint_runner.py` `_get_text`方法）
+   - 原prompt: `"请识别这张截图中所有可见的文字内容，逐行列出。只输出文字内容本身，不要加任何解释或格式。"`
+   - 新prompt: `"List ALL visible text in this screenshot, line by line. Include every button label, list item, input placeholder, status bar text, and title. Output ONLY the raw text, no explanation."`
+   - 同时 `reasoning_effort` 从 `"minimal"` 改为 `"low"`，`timeout` 从 20 改为 30
+
+2. **弹窗按钮跳过预分析缓存**（`desktop_blueprint_runner.py` `_smart_tap`方法）
+   - 新增类变量 `_DIALOG_BUTTONS = {"name:OK", "name:Ok", "name:Yes", "name:No", "name:Cancel", "name:Close", "name:确定", "name:取消", "name:是", "name:否", "name:关闭"}`
+   - `_smart_tap` 开头判断：如果target是弹窗按钮，跳过预分析缓存，直接走UIA→AI视觉实时定位
+
+3. **蓝本规范更新**（`.windsurf/workflows/blueprint.md`）
+   - desktop专用注意事项新增：弹窗触发后必须加click步骤关闭弹窗
+
+4. **蓝本弹窗步骤修复**（`todo-demo/testpilot.json`）
+   - "重复添加检测"场景截图后加 click name:OK + wait 300
+   - "空输入验证"场景截图后加 click name:OK + wait 300
+
+### 17.4 纠正：4项修复并未丢失
+
+经检查当前v13.2代码，备忘录17.2中列出的4项"丢失修复"实际**已存在于当前版本**：
+- OCR prompt英文版 ✅（`_get_text`中已是英文prompt + `reasoning_effort="low"` + `timeout=30`）
+- 弹窗按钮跳过预分析缓存 ✅（通过AIHub的`DIALOG_BUTTON_KEYWORDS`统一管理）
+- 蓝本规范弹窗铁律 ✅（`.windsurf/workflows/blueprint.md`已有）
+- 蓝本弹窗关闭步骤 ✅（`todo-demo/testpilot.json`已有`name:OK`步骤）
+
+这些修复在v12.x-v13.x的开发过程中已被合并。
+
+### 17.5 小程序测试"卡住"分析
+
+#### 用户反馈
+3月15日安装的插件运行小程序测试顺畅，3月17日v13.2插件运行时感觉卡住不停止。
+
+#### 对比结果
+稳定版可能是`5f08b64`(3/13 v11.0-C)，按钮文字为"断开引擎"（红色）。v13.2改为"一键连接/断开"单按钮。
+
+从`5f08b64`到`8ee17d9`(v13.2)，`miniprogram_runner.js`的主要改动是加了`withTimeout`超时包装（来自`1eaf274` iOS真机测试提交）：
+- `mp.currentPage()` → 8秒超时，超时返回null
+- `mp.evaluate()` → 8-10秒超时
+- `mp.screenshot()` → 8秒超时
+- `page.callMethod()` → 8秒超时
+
+**潜在风险**：`currentPage()`超时后page=null，后续`page.$(...)`会报错。但这不一定是卡住的根因，也可能是环境差异或偶发网络问题。
+
+#### 结论
+暂不修改，直接安装最新插件运行，有错改错。如果再次出现卡住，重点排查：
+1. `withTimeout`超时后page=null导致的空指针
+2. Node进程异常退出但Python端未检测到
+3. 微信开发者工具automator连接不稳定
+
+### 17.6 弹窗自愈机制（三层防御）—— 待实现
+
+详见13.21节的设计。优先级：
+- **第2层（检测+自愈）**最重要：步骤失败时截图分析是否有弹窗，自动关闭后重试
+- **第3层（场景跳过）**兜底：连续失败N步时跳到下一场景