@hupan56/wlkj 3.4.6 → 3.4.8

package/templates/qoder/skills/wl-test/SKILL.md

@@ -1,524 +1,540 @@
----
-name: wl-test
-description: "测试: quick(意图式用例,默认) / browser(Playwright浏览器) / unit(单元) / coverage(测试覆盖矩阵)。触发: /wl-test 命令; 或自然语言带'功能验证点'(如'测一下XX支不支持YY')。需确认(DANGEROUS)。"
-trigger: "用户显式打 /wl-test; 或自然语言带功能验证点('测一下XX支不支持YY''验一下XX能不能ZZ')。⚠️边界: '写需求/写PRD'→/wl-prd; '报错/bug/无法提交'若是写需求场景→/wl-prd不归本skill; 纯排查bug不走任何wl工作流"
----
-
-# wl-test — 测试工作流（/wl-test 命令 或 带功能验证点的自然语言触发）
-
-> ⚠️ **触发边界（关键：区分"功能测试" vs "随手看"）**：
-> - ✅ **走本工作流**：用户带**具体功能验证点**——"测一下异常记录**支不支持**项目类型搜索""验一下导出**能不能**用""保险搜索**对不对**"。
->   （含"支不支持/能不能/对不对/是否/有没有/测一下XX的YY功能"= 要验证一个行为点 = 功能测试）
-> - ❌ **不走本工作流**：纯随手操作——"打开保险页""看看登录""帮我点一下新增"。（无验证点，QoderWork 用自带浏览器直接做即可）
-> 区别：本工作流产出**可复用的测试用例 + 锚点沉淀 + 执行报告**；随手操作不沉淀。
-
-三条线，按用户意图路由。**默认 quick**（最常用、最快）。
-
-## 🎯 核心原则（最重要，务必遵守）
-
-1. **🔴 用户只说测什么，AI 全自动跑完，全程不问"要不要我跑"。**
-   禁止让用户写 `--env test --platform web` 这种参数（平台/环境 AI 自己定，web 默认、test 默认）。
-   **禁止问"要我跑还是你来跑""我帮你测还是你自己测""要不要现在执行"——/wl-test 触发即代表要跑，直接跑到出报告。**
-   不要问地址、不要问登录方式——config/个人文档里都有。
-   **唯一允许打断用户的场景**：填验证码这种真人校验（见铁律⑤），其它一律自动做完。
-2. **🚫 quick 模式绝不搜代码、绝不读源码、绝不查 API。** 用户说"测登录"，AI 直接据
-   该类页面的通用交互模式生成用例，不跑 search_index、不读 .vue。搜代码是 unit 的事。
-3. **🚫 脚本不自己开浏览器。** autotest.py 只生成用例+注入数据+出执行计划。真正的
-   浏览器操作由 **QoderWork 的 Browser Use 连接器**承担。AI 绝不在脚本里 import playwright/selenium。
-4. **已登录就别重复登录。** 先查登录态。已登录 → 用例直接 goto 目标功能页。未登录 → 才生成登录步骤。
-5. **缺啥问啥、一次问清。** 能合并的合并，别一个参数问一轮。
-
-## 🔴 quick 执行铁律（违反任何一条 = 测试失败，实测踩过的坑）
-
-**① 必须用意图式格式（intent+anchor），禁止旧 action+selector 格式。**
-```json
-// ✅ 对: 意图式, anchor 来自 recall 或 snapshot
-{"intent":"fill","desc":"账号输入框","value":"{{ask:登录账号}}","anchor":{"role":"textbox","name":"尊敬的管理员"}}
-// ❌ 错: 旧 action+CSS selector (脆弱, 脆弱, recall 锚点白沉淀)
-{"action":"form_input","target":"input[placeholder*='账号']","value":"{{ask:测试账号}}"}
-```
-
-**② 占位符必须用 `{{ask:登录账号}}` / `{{ask:登录密码}}`（精确匹配个人文档的 key）。**
-- 个人文档 `autotest-data.yaml` 里存的是 `登录账号` / `登录密码`。
-- 用 `{{ask:测试账号}}` / `{{ask:测试密码}}` → 读不到 → 问用户 → **违反原则①**。
-- 脚本 `quick` 会自动注入，**不要问用户账号密码**。
-
-**③ 用例 JSON 必须用 `--cases-file` 传文件，禁止内联 `--cases`。**
-```bash
-# ✅ 对: 写文件再传路径(不截断)
-(python "$R 2>/dev/null || python3 "$R)/.qoder/scripts/orchestration/wlkj.py" test quick --cases-file <文件路径> --env test --platform web
-# ❌ 错: 内联(长JSON截断, 多条用例必丢)
-(python "$R 2>/dev/null || python3 "$R)/.qoder/scripts/orchestration/wlkj.py" test quick --cases '[{"case_id"...(超长)...}]'
-```
-
-**④ 无锚点时必须先 snapshot 拿真实 anchor 再填，禁止预猜 CSS selector。**
-```bash
-# recall 空时 → 不预猜! 先 navigate + snapshot 拿到真实 a11y 树
-# 再把 snapshot 里看到的 role+name 填进 step.anchor
-```
-- recall 命中 → 直接用 recall 的 anchor（确定性命中，零 LLM）
-- recall 空（首次）→ **navigate + browser_snapshot → 从 a11y 树提取 anchor → 填进用例**
-- **绝不**在没看页面的情况下凭"登录页一般有账号框"去猜 selector
-
-**⑤ URL 必须写成 `{{base_url}}/auth/login`（带斜杠）。**
-- base_url 已去尾斜杠（脚本行为），写 `{{base_url}}auth/login` 会拼成 `https://xxxauth/login` 坏地址。
-- 脚本会检测并告警，但 AI 应一次写对。
-
-**⑥ recall 的 `--url` 必须用相对路径（无前导斜杠），避开 Git-bash/MSYS 路径转换坑。**
-```bash
-# ✅ 对: 相对路径 (MSYS 不转换)
-(python "$R 2>/dev/null || python3 "$R)/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
-# ❌ 错: 前导斜杠会被 Windows Git-bash 转成 /D:/.../Git/auth/login
-(python "$R 2>/dev/null || python3 "$R)/.qoder/scripts/orchestration/wlkj.py" test recall --url /auth/login
-```
-（脚本已加 normalize 兜底能修这个，但别依赖兜底——直接写相对路径最干净。）
-
-**⑦ Playwright 工具一次性批量加载，snapshot 结果直接用内存 a11y 树，禁止写文件再 Read。**
-```bash
-# ✅ 对: 一个回合里并发加载所有要用的 browser_* 工具描述
-# ✅ 对: browser_snapshot 返回的 a11y 树直接在对话里读, 不落地文件
-# ❌ 错: 用一个加载一个(调用数翻倍); snapshot 写 yml 文件 → 再 Read 读回来(每步2次调用)
-```
-
-**⑧ 验证码识别一气呵成（截图→Read→type→删图），不绕路、不预先纠结。**
-- 登录用例里**不写**验证码 step——点登录后若弹验证码，执行循环自动走 5 步。
-- 固定 5 步连发：`browser_snapshot` 找验证码图 → `browser_take_screenshot` 存图 → Read 看图算 → `browser_type` 填 → 删图。
-- 验证码有时效（1-2分钟），所以**填完立刻点登录**，别在中间插别的操作。
-- 自识别连失 2 次才交人。
-
-**⑨ 用例必须一次生成全部（正向+异常），禁止一条一条生成。**
-- 每生成一条 = 一次模型调用。一次写完 Q-1(正向) + Q-2(异常) + ... 全部。
-
-## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
-
-> 🔴 **脚本路径——不要反复 dir 搜索！**
->
-> **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-> ```bash
-> R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
-> ```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。
-> **后续脚本统一用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`，不要再搜！**
-> 如果 `repo_root.py` 报错找不到，先在仓库里跑 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
-
-- `<R>/.qoder/.developer` — 当前开发者
-- `<R>/.qoder/config.yaml` 的 `autotest:` 段 — 环境/域名
-- **quick 不需要**读任务/PRD/代码。browser 才需要任务目录。
-
-### 🔴 测试页面 URL 用 --routes 查，禁止 grep 路由文件！（实测 QoderWork 反复踩坑）
-
-**🚫 绝对禁止**：grep 源码里的 `router/routes/*.ts` 找 URL、读 `core.ts` 搜 component、从 API 端点反推 URL。
-（实测：QoderWork 里 AI 反复 grep `abnormalManage.*index.vue in core.ts` 搜了十几遍无匹配，纯浪费。）
-
-**唯一正确做法**——1 条命令查 MySQL sys_menu 真实路由：
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" search --routes 保险
-# → 保险管理 -> /veh/vehicle/vehAffair/insurance
-```
-- 数据来自 MySQL `sys_menu` 表（后台动态菜单，**唯一事实源**）
-- 没找到 → 先 `--routes` 搜英文关键词（insurance/asset/attendance），再试中文
-- **还是没找到 → 直接问用户页面叫什么，不要去 grep 源码**
-
-### 生成用例时用 MySQL MCP 补真实数据（少手填、覆盖边界）
-
-1. **取真实测试数据**：需要业务单号/账号时 `cap.mcp.call("query_data", {"table": "表名", "columns": "id", "单号列", "where": "条件", "limit": "5"})`
-   - 拿测试库真实可用的数据，别编造。填进用例的 data 里。
-   - [QAS环境] 数据行仅参考格式，不代表线上。
-2. **枚举边界覆盖**：涉及状态/类型字段时 `cap.mcp.call("query_distinct", {"table": "表名", "column": "状态列"})`
-   - 查真实取值范围（如 case_status = 1/2/3/4），按每个值造边界用例。
-   - 取值范围可信 → 用例枚举全覆盖，不漏分支。
-
-## 🚦 路由（仅在 /wl-test 命令或明确测试任务触发时，决定走哪条线）
-
-| 用户输入 | 路由 | 要不要搜代码 |
-|---------|------|-------------|
-| `/wl-test`（不带参数）/ "测试盲区" | **coverage** — 调 `coverage_matrix` 展示哪些功能没测 | ❌ |
-| `/wl-test 测一下登录` / "跑登录测试用例" | **quick**（默认） | ❌ |
-| `/wl-test browser 06-14-login` / "回归测试 XXX 任务" | **browser** | ❌（读任务PRD） |
-| `/wl-test unit` / "写单元测试" | **unit** | ✅（这条才搜代码） |
-
-> ⚠️ **不触发本工作流的情况**（用 QoderWork 自带浏览器即可）：
-> "测一下这个页面""看看登录能不能打开""帮我打开浏览器操作一下"——这些是随手操作，不走 autotest.py、不沉淀锚点、不产出测试报告。
-
-没明说任务名、只是随口"测一下 XX" → **quick**。
-
----
-
-## coverage 测试覆盖视图（`/wl-test` 不带参数时）
-
-用户只输入 `/wl-test` 或说"测试盲区"→ 调知识图谱的 `coverage_matrix`，展示哪些功能有测试、哪些是空白：
-```
-coverage_matrix()
-→ 资产管理[✓有测试] / 考勤[✗无测试] / 薪资[✗无测试] / 保险[✓有测试]
-```
-然后建议："考勤和薪资是盲区，要补测吗？" 用户选一个 → 进入 quick/browser 生成用例。
-
----
-
-## quick 快速测试（默认 · 详）
-
-**不要任务/PRD。零搜索。** 用意图+锚点格式（A方案），observe-act-extract 执行。
-
-### Step 0 + 0.5：recall 查锚点 + context_pack 取全（两者无依赖，同回合并发）
-
-> Step0（recall 锚点）和 Step0.5（context_pack 上下文）互不依赖 → **同一条消息并发发**，别先跑0再跑0.5。
-
-**Step 0：recall 查锚点**（用相对 URL，避开 MSYS 坑）
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
-```
-- **有锚点** → 生成用例时直接把 anchor 填进 step（确定性命中，快、零 LLM）
-- **无锚点（首次）** → **先 navigate + snapshot 拿真实锚点，再生成用例**（见 Step 0.6）
-
-**Step 0.5：用知识图谱 MCP 增强用例**（1 次调用取全，与 recall 并发）
-```python
-context_pack(keyword='功能名', platform='web', role='test')
-```
-- 返回(role=test 裁剪): 代码落点 + 相关历史 PRD 标题 + API + 字段
-- 拿到后用于: API→断言点, 字段→fill 步骤更准
-
-> ⚠️ **注意：context_pack 不抓 PRD 验收标准正文**（它只取 PRD 的 title+keywords，
-> 不解析「## 验收标准」章节）。**业务规则断言不要指望 context_pack**，它给不了 expected。
-> 要把 PRD 验收标准翻译成可执行断言，用 `assertion-gen` 子命令（见下方专节）。
-
-> 图谱无数据 → 跳过，按通用模式生成。**不要再单独调 feature_overview**（信息重叠，浪费一轮）。
-
-### Step 0.6：recall 空时，先 snapshot 拿真实锚点（🔴 首次跑关键，禁止预猜 selector）
-
-**recall 返回空 = 第一次测这页。此时绝不能凭"登录页一般有账号框"去猜 CSS selector。**
-正确做法：先用 Playwright 打开页面拿一次 a11y 树，从里面提取真实 anchor：
-
-```bash
-# 1. 批量加载要用的 browser_* 工具描述 (一次并发, 别一个一个加载)
-#    最少: browser_navigate, browser_snapshot, browser_click, browser_type,
-#          browser_take_screenshot, browser_evaluate
-
-# 2. browser_navigate 到 {{base_url}}/auth/login (base_url 从 config 取, 已去尾斜杠)
-# 3. browser_snapshot 一次 → 拿到 a11y 树 (直接读对话里的内容, 不写文件)
-```
-snapshot 返回形如：
-```
-- textbox "尊敬的管理员，请输入您的账号" [ref=e36]
-- textbox "请输入您的密码" [ref=e42]
-- textbox "验证码" [ref=e56]
-- button "login" [ref=e64]: 登录
-```
-**把这里的 role+name 直接填进用例的 anchor**：
-```json
-{"intent":"fill","desc":"账号输入框","value":"{{ask:登录账号}}","anchor":{"role":"textbox","name":"尊敬的管理员，请输入您的账号"}}
-```
-> 这一步把"首次跑要靠 LLM 兜底匹配"变成"确定性命中"，是省调用的根本。
-> 拿到锚点后继续 Step 1。
-
-**🎯 知道页面名/URL 时，AI 先查按钮+接口画像（最精准，1 条命令拿到所有交互点）：**
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test page --kw 保险        # 按业务名查
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test page --url /veh/insurance  # 按URL查
-```
-（这是 AI 在 `/wl-test` 流程内部自动调用的工具，**用户只用 `/wl-test`，不碰此命令**。）
-输出每个按钮的 handler + 调用接口 + HTTP 方法 + 置信度，**直接对应到用例的 click→assert 断言点**。开发 `finish` 任务时也会自动生成 `test-handoff.md`，内容同此画像——交接场景直接读那份即可，不必重查。
-
-### Step 1：AI 据用户描述 + 锚点生成意图式用例 JSON（**一次生成全部用例**）
-**意图+锚点格式**（A方案核心）：用 `intent` 表达"做什么"，用 `anchor` 精确定位（有锚点则确定性命中，无则 LLM 兜底）。
-```json
-[{"case_id":"Q-1","title":"正确账号密码登录","platform":"web","env":"test",
-  "steps":[
-    {"intent":"goto","desc":"登录页","value":"{{base_url}}/auth/login"},
-    {"intent":"fill","desc":"账号输入框","value":"{{ask:登录账号}}",
-     "anchor":{"role":"textbox","name":"尊敬的管理员，请输入我的账号"}},
-    {"intent":"fill","desc":"密码输入框","value":"{{ask:登录密码}}",
-     "anchor":{"role":"textbox","name":"请输入您的密码"}},
-    {"intent":"click","desc":"登录按钮","anchor":{"role":"button","name":"登录"}},
-    {"intent":"extract","desc":"是否已离开登录页进入系统"}
-  ],
-  "expected":"登录成功进系统"}]
-```
-> 验证码不是单独的 step——登录按钮点击后，如果跳出验证码弹层/数学题，执行循环会**自动**走铁律⑤的 5 步自识别（screenshot→Read→type→删图），不需要在用例里写 `ask_human`。只有自识别连失 2 次才暂停交人。
-**intent 取值**：`goto`(导航) / `observe`(读页面) / `click`(点击) / `fill`(填表) / `extract`(语义断言) / `ask_human`(人机协同) / `assert`(确定性断言)
-**anchor 取值**（稳定锚点，不随刷新变）：`{role, name, placeholder, text}` 任一组合。recall 有就用，没有就留空（执行时 LLM 兜底匹配）。
-真实数据用 `{{ask:描述}}` 占位；URL 用 `{{base_url}}`。
-> ⚠️ **一次生成所有用例**（正向+异常），不要一条一条生成——每生成一条 = 一次模型调用，耗不起。
-
-### Step 2：用文件传 cases（根治命令行截断）+ 注入数据 + 出执行计划
-**把用例 JSON 写文件，再传路径**（不要内联 --cases，长 JSON 会截断）：
-```bash
-# AI 先写文件:
-#   写 workspace/members/{dev}/drafts/_autotest-cases.json
-# 再调:
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
-  --cases-file workspace/members/{dev}/drafts/_autotest-cases.json \
-  --desc "<用户描述>" --platform <web|app>
-```
-脚本自动：解析环境域名 + 从个人文档注入账号密码 + 出执行计划。
-若提示"需要测试数据 N 项" → 逐项问用户，再用 `--data` 传。
-
-### Step 3：执行循环（observe-act-extract）
-
-> **🔴 必须用 Playwright MCP 工具驱动浏览器，禁止用 QoderWork 自带连接器！**
->
-> 自带连接器（tabs_context/navigate/computer）实测**极慢**（5-8 分钟）、tab 管理混乱、
-> Computer 截图反复失败。**Playwright MCP 快 30 倍、稳定、不折腾 tab。**
->
-> | 操作 | 用 Playwright MCP 的工具 | ❌ 禁止用自带连接器的 |
-> |------|------------------------|---------------------|
-> | 导航 | `browser_navigate` | tabs_context_mcp / Navigate |
-> | 读页面 | `browser_snapshot` | read_page / Find |
-> | 填表单 | `browser_type` | form_input |
-> | 点击 | `browser_click` | Computer click |
-> | 截图 | `browser_take_screenshot` | Computer screenshot/zoom |
-> | 执行JS | `browser_evaluate` | javascript_tool |
->
-> **如果你看不到 browser_* 开头的工具，说明 Playwright MCP 没生效——检查 Settings → MCP 里
-> playwright 是否启用，或重启 QoderWork。**
-
-> **🔴 工具名必须逐字匹配，禁止自创/大小写错（实测 QoderWork 里 AI 把 `browser_navigate` 调成 `BrowserNavigate` 导致全失败）。**
-> Playwright MCP（`@playwright/mcp`）注册的**全部 23 个工具**（snake_case 小写，逐字照抄）：
-> ```
-> browser_navigate  browser_navigate_back  browser_tabs  browser_close  browser_resize
-> browser_snapshot  browser_click  browser_type  browser_fill_form  browser_select_option
-> browser_hover  browser_drag  browser_drop  browser_press_key  browser_file_upload
-> browser_take_screenshot  browser_wait_for  browser_evaluate  browser_handle_dialog
-> browser_console_messages  browser_network_requests  browser_network_request  browser_run_code_unsafe
-> ```
-> ⚠️ **截图工具是 `browser_take_screenshot`（不是 browser_screenshot）**。
-> ⚠️ **导航是 `browser_navigate`（不是 BrowserNavigate / navigate）**。
-> 调用前对照上面清单，名字写错 = 工具不存在 = 整个测试失败。
-
-**🔴 调用效率（实测:一次登录测试不该超过 12 步调用）：**
-1. **工具批量加载**：进入执行阶段时，在一个回合里并发加载所有要用的 `browser_*` 工具描述（navigate/snapshot/click/type/take_screenshot/evaluate），不要用一个加载一个。
-2. **snapshot 不落地**：`browser_snapshot` 返回的 a11y 树**直接在对话里读**，禁止写 yml 文件再 Read 回来（每步省一次调用）。
-3. **有 anchor 连发不思考**：锚点已确定，`browser_type`/`browser_click` 直接按 role+name 操作，零模型调用。
-
-**对每个 step（用 Playwright MCP 工具，连着发，别每步深度思考）：**
-1. **intent=goto** → `browser_navigate`（1 次）
-2. **首次到新页面** → `browser_snapshot` **1 次**拿 a11y 树（直接读，不写文件）
-3. **intent=click/fill**（锚点优先，**确定性匹配不思考**）：
-   - **有 anchor** → snapshot 结果里按 `role+name`/`placeholder` 直接匹配 → 拿到元素 → `browser_type`/`browser_click`（**零模型调用，连着发**）
-   - **无 anchor** → 用 `desc` 语义匹配（1 次模型调用）
-   - 匹配失败 → self-heal：重新 `browser_snapshot` + 重试，最多 2 次
-4. **intent=extract** → 看 URL / 当前页面判断（1 次模型调用）
-5. **intent=ask_human** → 暂停等人
-6. **intent=assert** → 确定性校验（零模型调用）
-
-### Step 3.5：验证码识别一条龙（数学题）— 一气呵成，别绕路
-
-> **🔴 验证码铁律（实测反复踩坑）：**
-> - **禁止用 Computer 截图 / zoom 截验证码**——实测反复失败、超时、浪费 5-6 步。
-> - **禁止填默认值/瞎蒙**（如 000000）。
-> - **唯一正确路径**：JS 提取 base64 → 存图 → Read 看 → 算答案 → 填 → 删图。固定 5 步，不偏离。
-> - **验证码有时效（1-2 分钟），所以填完立刻点登录，中间别插别的操作。**
-
-按这个**固定顺序**一次走完（用 Playwright MCP 工具，约 30 秒，**连发不思考**）：
-1. **`browser_snapshot`**（如果刚才已经 snapshot 过且页面没变，可跳过）看页面元素，找到验证码图片元素
-2. **`browser_take_screenshot`** 截验证码图片 → 存临时文件（稳定，不像 Computer 截图会失败）
-3. **Read 工具看图 → 算出答案**（QoderWork 自带视觉，1 次模型调用，数学题识别率高）
-4. **`browser_type`** 填答案到验证码输入框
-5. **立刻 `browser_click` 点登录**（验证码刚填、还没过期，抓住窗口）
-6. **删掉临时图片**（bash `del _captcha.png`）
-> 验证码过期了（提示"验证码已失效"）→ 别纠结，直接刷新重走 1-5 步。
-> 识别完**必须删图**，不留垃圾。
-> 自识别连续失败 2 次或明显是短信/扫码类 → 才交人（见 Step A 铁律⑤）。
-
-### Step 4：回收结果 + 自学习沉淀（🔴 必须，不做完不出报告）
-
-> **测试跑完 ≠ 结束。** 出报告前必须回收结果 + 沉淀锚点，让下次测同页更快（Stagehand 式缓存）。
-> **不做这步 = 白测**（下次还得从零找元素）。
-
-**执行方式**：把测试结果 + 测试中 `browser_snapshot` 看到的页面元素一起回传：
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
-  --cases-file <之前的cases文件> \
-  --record '{"Q-1":"pass","Q-2":"pass","Q-3":"pass"}' \
-  --page-json '{"url":"/veh/vehicle/vehAffair/insurance","elements":[{"role":"textbox","name":"车牌号"},{"role":"button","name":"搜索"},{"role":"button","name":"新增"}]}'
-```
-
-`--record` 回收时自动：
-- ① 从 `--page-json` 提取页面元素锚点 → 存进 `test-pages.json`
-- ② 从**通过的** intent 用例提取 goto URL + anchor → 沉淀
-- ③ 登录用例通过 → 自动标记已登录
-
-**🔴 `--page-json` 的 elements 怎么来的**：测试中每次 `browser_snapshot` 看到的元素，记下来，回传时填进去。
-不需要全部——**只填这个页面关键的交互元素**（搜索框/按钮/Tab/表格），5-10 个就够。
-
-**沉淀效果**：下次 `/wl-test 测保险` → recall 命中保险页锚点 → 不用 snapshot 找元素 → 直接操作 → **省一半时间**。
-
----
-
-## browser 基于任务的浏览器测试（用户明确给了任务名时）
-
-```bash
-cap.mcp.call("list_tasks", {})                     # 确认任务存在
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test generate <task>      # 生成骨架到 autotest-cases.jsonl
-# AI 读任务 PRD「验收标准」补全 steps/expected (真实数据用 {{ask:}}, 不搜源码)
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test run <task>           # 注入+出执行计划
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test run <task> --record '{"..":"pass"}'  # 回收结果
-```
-
-**回归测试增强（图谱 MCP）**：测接口改动时，用 `get_impact` 查影响范围，自动覆盖受影响页面：
-```
-get_impact(endpoint='/asset/list')
-→ 返回: 资产列表页、资产导出按钮、资产详情页都调这个接口
-→ 为每个受影响页面生成回归用例
-```
-
----
-
-## unit 单元测试（说"单元测试/单测"才走这条）
-
-读 **test-generator** skill：用 `search_index.py` 定位实现代码 → 读 spec → 生成
-JUnit 测试（Mock + MockMvc，Given-When-Then，`@DisplayName`，AssertJ）→
-输出 `tests/{package}/{Class}Test.java`。
-**（只有这条线才搜代码、读源码。）**
-
----
-
-## 📋 断言生成 assertion-gen（业务规则断言 · 第三档专用）
-
-> 解决痛点：quick 模式的 `_check_expect` 能执行 `{fetch, jsonpath, equals}` 断言，
-> 但那个 **equals 期望值从哪来** 没人管——靠 LLM 瞎编不可信。
-> `assertion-gen` 把"PRD 验收标准 → 可执行断言"这条断链接上。
-
-**分工（呼应图谱边界三条红线）：**
-- **人补语义**：PRD 里写结构化验收（Given-When-Then，或"条件-操作-预期"带接口名/状态码/字段值）
-- **图谱补字段**：`page_probe` 查按钮→接口，`field_map` 查中文标题→字段名
-- **真跑定对错**：assertion-gen 只产断言 JSON，跑不跑交给 quick/webaccess
-
-**什么时候用**：业务规则断言（保险延期要审批、退保校验、状态流转）——这是 quick 通用模式
-搞不定的第三档。冒烟（页面没崩）、CRUD 流（新增→列表出现）用 quick 就够，不需要这个。
-
-```bash
-# 从任务 PRD 的验收标准章节抿断言
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen --task <任务名> --page 保险
-
-# 临时用 GWT 文本兜底（PRD 没写验收标准时）
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen \
-  --gwt "Given 已登录保险页 When 点击延期提交 Then 接口 /api/insurance/delay 返回 code=200 且 状态列显示审批中" \
-  --page 保险
-```
-
-**输出**：`workspace/tasks/<task>/assertions.json`，每条断言带 `source` 置信度标记：
-- `规则·句中含接口` / `图谱·按钮画像` = 可信（接口路径已确定）
-- `需确认·字段未命中` = 待补（字段表查不到，留 `{{ask:}}` 占位）
-
-**两条铁律（assertion-gen 内置）：**
-1. **抽不到就老实说**：PRD 验收标准为空/纯描述 → 输出"无可抽取的结构化断言"，**绝不编造**断言。
-2. **语义不背书**：字段补全命中标 `[图谱]`，查不到留占位标 `[需确认]`，不让图谱假装懂业务。
-
-**下一步**：把 `assertions.json` 的 assertions 数组并进 quick 用例的 steps（`intent:"assert"`），
-用 webaccess 或 quick 执行真跑验证。**assertion-gen 自己不执行、不真跑。**
-
----
-
-## 🔐 测试数据处理原则（个人 vs 团队隔离）
-
-- **绝不编造**：账号/密码/手机号用 `{{ask:描述}}` 占位，问用户要。
-- **个人测试数据放个人文档，绝不进 config.yaml**：config 是团队共用会 push，放账号=泄漏。
-  域名才放 config（全团队一致）。账号密码每人不同 → 个人文档。
-- **个人文档**：`workspace/members/{你的名字}/autotest-data.yaml`（gitignored，永不 push）
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test init-data                          # 生成模板
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test set-data 登录账号 test --env test   # 填(按环境/平台分块)
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test list-data --env test                # 查看(密码脱敏)
-```
-run/quick 时按 env/platform 自动取最精确的值；`--data` 可临时覆盖。
-
-## 🔁 登录态 + 登录前置（内部页面测试的前提）
-
-**测考勤/资产/保险等内部页面，前提是已登录。** 处理逻辑（一句话：能复用就复用，不能就 AI 自己登，验证码按铁律⑤走）：
-
-**Step A：查登录态**
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test login-state show
-```
-
-**Step B：按登录态决定行为**
-- **已登录** → 用例直接 `goto` 目标功能页（如 `/attendance`），**不带任何登录步骤**
-- **未登录** → **AI 自己生成登录用例并自动跑完**（账号密码从个人文档注入，验证码按铁律⑤ 的 5 步流程：`browser_take_screenshot` 截图 → Read 看图算答案 → `browser_type` 填入 → 删图）。
-  - **只有在**截图识别连续失败 2 次、或验证码明显是短信/扫码这类 AI 必定过不了的形式时，才退回人机协同：暂停一次，让用户手动过验证码，用户说"好了"就继续。**不要一上来就甩给用户。**
-
-> 🔴 **不要再说"AI 过不了验证码"这种话**——铁律⑤ 已经给了能跑通的自识别路径（Playwright 截图 + QoderWork/VLM 视觉）。默认先自己试，不行再交人。先放弃 = 违反原则①。
-
-**Step C：执行时双重校验登录态**
-即使 login-state 显示已登录，执行时也要**实际验证**（goto 目标页后看有没有被踢回登录页）：
-- `browser_navigate` 到考勤页 → `browser_snapshot` 看当前页面
-- 如果 URL 变成 `/auth/login` 或页面是登录表单 → **session 过期了** → 自动生成登录用例重登（不要让用户手动登）
-- 如果正常显示考勤页面 → 继续执行用例
-
-**执行计划里**：若 login-state 显示已登录，显示 "💡 已登录 ... 直接 goto 目标页即可"。
-若发现 session 过期/被踢 → 自动重登，不打断用户。
-
-```bash
-# 手动操作（一般不用，AI 会自动）:
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test login-state mark --env pre --platform web   # 标记已登录
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" test login-state clear --env pre                 # 清除(强制重登录)
-```
-
-## 🧩 QoderWork 增强：浏览器自动执行（可选 · 无连接器则自动回退）
-
-> 依赖 QoderWork 桌面端的 Browser Use / Computer 控制连接器（Settings → Connectors）。
-> **纯 Qoder IDE/CLI 无连接器 → 降级为人工核对清单，不报错。**
-- 有连接器：Agent 读脚本出的执行计划，用 Browser Use 驱动 Chrome 真实操作 → 记 pass/fail → 回传
-- 无连接器：输出人工核对清单，用户自己在浏览器点
-
-### 🔐 验证码 / 登录页（默认自识别，兜底人机协同）
-
-> ⚠️ **本工作流的默认策略是 AI 自识别验证码**（见 quick 铁律⑤ + Step 3.5），不是"全部甩给用户"。
-> 下面这段是**兜底**：自识别跑不通时（连续失败 2 次 / 短信扫码类验证码）才退到人机协同。
-
-登录页带**数学题验证码**时，用 `solve_captcha` action 声明：
-```json
-{"action":"solve_captcha",
- "target":"<验证码图片元素>",
- "fill_target":"<答案输入框>",
- "desc":"验证码: 先 AI 自识别(screenshot→Read算→type), 失败2次再交人"}
-```
-
-**执行到 solve_captcha 时，AI 这样走（先自己试，不行才交人）：**
-1. **先自己识别**：按 Step 3.5 的 5 步——`browser_take_screenshot` 截验证码 → Read 看图算出答案 → `browser_type` 填入 → 删图（**这是默认路径，先走这条**）
-2. **连续 2 次识别失败 / 验证码明显是短信/扫码** → 才退人机协同：告诉用户"账号密码已填好，验证码我没识别出来，请你手动完成并点登录，好了告诉我"
-3. **等待**用户确认登录成功（AI 可 `browser_snapshot` 看是否已离开登录页判断）
-4. 用户登录成功后，AI 继续执行后续用例
-
-**不要一开始就跳到第 2 步**——那等于放弃了自识别能力，违背本工作流全自动的目标。
-
-### 🔁 登录态复用（能复用就别重复登录）
-
-**已登录的浏览器共享 cookie/session。** 所以：
-- 生成用例前，先 `browser_snapshot` 看当前页面，判断是否已登录（不在登录页 = 已登录）
-- **已登录** → 用例直接 `goto` 目标功能页，不写登录步骤（最快）
-- **未登录** → AI 自己生成登录用例跑完（验证码按上面策略：先自识别，兜底交人）
-
-> 不存在"必须用户先手动登录"的硬性要求——AI 能自己登就自己登。
-
-### 🛠️ 两种连接器 + 工具冲突降级（实战经验）
-
-QoderWork 有**两种**浏览器控制方式，遇到问题要在两者间切换：
-
-**① Browser Use（builtin_browser，Chrome 扩展）**——精度高、直接操作 DOM
-- ✅ 能用：`navigate` / `read_page` / `find`（只读工具，几乎不挂）
-- ❌ 易挂：`computer`(点击/截图) / `form_input`(表单) / `javascript_tool`(JS注入) —— 被 Chrome 扩展冲突拦
-- 挂的原因：其他扩展（Claude/Codex/其他 debugger 扩展）抢占了 debugger 通道
-
-**② Computer Use（builtin_computer_use，桌面自动化）**——系统级，不依赖 Chrome 扩展
-- ✅ 不受扩展冲突影响（它是模拟鼠标键盘，不走 debugger）
-- ⚠️ 要求：**浏览器窗口必须在最前台**（前台是别的应用如 ToDesk/IDE 时会操作到错误窗口）
-- ⚠️ 靠坐标，精度比 Browser Use 低
-
-**降级决策（遇到工具报错时按此走，别直接 BLOCKED）：**
-
-| 场景 | 处理 |
-|------|------|
-| Browser Use 的 form_input/click 挂了 | ① 先让用户关冲突扩展重试；② 不行就**切 Computer Use** + 提示用户**把浏览器切到前台** |
-| Computer Use 操作了错误窗口 | 提示用户：浏览器切前台（别让 ToDesk/IDE 挡着），再重试 |
-| read_page 能用但点击不能 | 用 read_page 拿到元素的坐标/ref，Computer Use 按坐标点 |
-
-**`chrome-extension://` 冲突**：`chrome://extensions` 禁用其他自动化扩展（Claude/Codex），
-只留 QoderWork 连接器。若一时解不了，**切 Computer Use + 浏览器前台**是可靠的绕过路径。
-
-## 输出规则
-- **触发即跑，跑完出报告**：/wl-test 触发 = 要测，直接生成用例→执行→出结果，不要问"要我跑吗"
-- quick/browser：用例表 + 执行结果（pass/fail），失败列原因 + 建议，全过建议继续
-- 别在 quick 里啰嗦搜代码的过程——用户要的是"测了没、通没通"
-- 验证码/登录：默认 AI 自识别（截图→算→填），连续 2 次失败或短信/扫码类才交人
+---
+n## 🚨 铁律：MCP工具优先，禁跑本地脚本
+所有知识查询走 mcp__qoder-knowledge-graph__ 工具（云平台SSE），绝不跑 wlkj.py kg/context/search（本地kg空）。
+name: wl-test
+description: "测试: quick(意图式用例,默认) / browser(Playwright浏览器) / unit(单元) / coverage(测试覆盖矩阵)。触发: /wl-test 命令; 或自然语言带'功能验证点'(如'测一下XX支不支持YY')。需确认(DANGEROUS)。"
+trigger: "用户显式打 /wl-test; 或自然语言带功能验证点('测一下XX支不支持YY''验一下XX能不能ZZ')。⚠️边界: '写需求/写PRD'→/wl-prd; '报错/bug/无法提交'若是写需求场景→/wl-prd不归本skill; 纯排查bug不走任何wl工作流"
+---
+n## 🚨 铁律：MCP工具优先，禁跑本地脚本
+所有知识查询走 mcp__qoder-knowledge-graph__ 工具（云平台SSE），绝不跑 wlkj.py kg/context/search（本地kg空）。
+
+# wl-test — 测试工作流（/wl-test 命令 或 带功能验证点的自然语言触发）
+
+> ⚠️ **触发边界（关键：区分"功能测试" vs "随手看"）**：
+> - ✅ **走本工作流**：用户带**具体功能验证点**——"测一下异常记录**支不支持**项目类型搜索""验一下导出**能不能**用""保险搜索**对不对**"。
+>   （含"支不支持/能不能/对不对/是否/有没有/测一下XX的YY功能"= 要验证一个行为点 = 功能测试）
+> - ❌ **不走本工作流**：纯随手操作——"打开保险页""看看登录""帮我点一下新增"。（无验证点，QoderWork 用自带浏览器直接做即可）
+> 区别：本工作流产出**可复用的测试用例 + 锚点沉淀 + 执行报告**；随手操作不沉淀。
+
+三条线，按用户意图路由。**默认 quick**（最常用、最快）。
+
+## 🎯 核心原则（最重要，务必遵守）
+
+1. **🔴 用户只说测什么，AI 全自动跑完，全程不问"要不要我跑"。**
+   禁止让用户写 `--env test --platform web` 这种参数（平台/环境 AI 自己定，web 默认、test 默认）。
+   **禁止问"要我跑还是你来跑""我帮你测还是你自己测""要不要现在执行"——/wl-test 触发即代表要跑，直接跑到出报告。**
+   不要问地址、不要问登录方式——config/个人文档里都有。
+   **唯一允许打断用户的场景**：填验证码这种真人校验（见铁律⑤），其它一律自动做完。
+2. **🚫 quick 模式绝不搜代码、绝不读源码、绝不查 API。** 用户说"测登录"，AI 直接据
+   该类页面的通用交互模式生成用例，不跑 search_index、不读 .vue。搜代码是 unit 的事。
+3. **🚫 脚本不自己开浏览器。** autotest.py 只生成用例+注入数据+出执行计划。真正的
+   浏览器操作由 **QoderWork 的 Browser Use 连接器**承担。AI 绝不在脚本里 import playwright/selenium。
+4. **已登录就别重复登录。** 先查登录态。已登录 → 用例直接 goto 目标功能页。未登录 → 才生成登录步骤。
+5. **缺啥问啥、一次问清。** 能合并的合并，别一个参数问一轮。
+
+## 🔴 quick 执行铁律（违反任何一条 = 测试失败，实测踩过的坑）
+
+**① 必须用意图式格式（intent+anchor），禁止旧 action+selector 格式。**
+```json
+// ✅ 对: 意图式, anchor 来自 recall 或 snapshot
+{"intent":"fill","desc":"账号输入框","value":"{{ask:登录账号}}","anchor":{"role":"textbox","name":"尊敬的管理员"}}
+// ❌ 错: 旧 action+CSS selector (脆弱, 脆弱, recall 锚点白沉淀)
+{"action":"form_input","target":"input[placeholder*='账号']","value":"{{ask:测试账号}}"}
+```
+
+**② 占位符必须用 `{{ask:登录账号}}` / `{{ask:登录密码}}`（精确匹配个人文档的 key）。**
+- 个人文档 `autotest-data.yaml` 里存的是 `登录账号` / `登录密码`。
+- 用 `{{ask:测试账号}}` / `{{ask:测试密码}}` → 读不到 → 问用户 → **违反原则①**。
+- 脚本 `quick` 会自动注入，**不要问用户账号密码**。
+
+**③ 用例 JSON 必须用 `--cases-file` 传文件，禁止内联 `--cases`。**
+```bash
+# ✅ 对: 写文件再传路径(不截断)
+(python "$R 2>/dev/null || python3 "$R)/.qoder/scripts/orchestration/wlkj.py" test quick --cases-file <文件路径> --env test --platform web
+# ❌ 错: 内联(长JSON截断, 多条用例必丢)
+(python "$R 2>/dev/null || python3 "$R)/.qoder/scripts/orchestration/wlkj.py" test quick --cases '[{"case_id"...(超长)...}]'
+```
+
+**④ 无锚点时必须先 snapshot 拿真实 anchor 再填，禁止预猜 CSS selector。**
+```bash
+# recall 空时 → 不预猜! 先 navigate + snapshot 拿到真实 a11y 树
+# 再把 snapshot 里看到的 role+name 填进 step.anchor
+```
+- recall 命中 → 直接用 recall 的 anchor（确定性命中，零 LLM）
+- recall 空（首次）→ **navigate + browser_snapshot → 从 a11y 树提取 anchor → 填进用例**
+- **绝不**在没看页面的情况下凭"登录页一般有账号框"去猜 selector
+
+**⑤ URL 必须写成 `{{base_url}}/auth/login`（带斜杠）。**
+- base_url 已去尾斜杠（脚本行为），写 `{{base_url}}auth/login` 会拼成 `https://xxxauth/login` 坏地址。
+- 脚本会检测并告警，但 AI 应一次写对。
+
+**⑥ recall 的 `--url` 必须用相对路径（无前导斜杠），避开 Git-bash/MSYS 路径转换坑。**
+```bash
+# ✅ 对: 相对路径 (MSYS 不转换)
+(python "$R 2>/dev/null || python3 "$R)/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
+# ❌ 错: 前导斜杠会被 Windows Git-bash 转成 /D:/.../Git/auth/login
+(python "$R 2>/dev/null || python3 "$R)/.qoder/scripts/orchestration/wlkj.py" test recall --url /auth/login
+```
+（脚本已加 normalize 兜底能修这个，但别依赖兜底——直接写相对路径最干净。）
+
+**⑦ Playwright 工具一次性批量加载，snapshot 结果直接用内存 a11y 树，禁止写文件再 Read。**
+```bash
+# ✅ 对: 一个回合里并发加载所有要用的 browser_* 工具描述
+# ✅ 对: browser_snapshot 返回的 a11y 树直接在对话里读, 不落地文件
+# ❌ 错: 用一个加载一个(调用数翻倍); snapshot 写 yml 文件 → 再 Read 读回来(每步2次调用)
+```
+
+**⑧ 验证码识别一气呵成（截图→Read→type→删图），不绕路、不预先纠结。**
+- 登录用例里**不写**验证码 step——点登录后若弹验证码，执行循环自动走 5 步。
+- 固定 5 步连发：`browser_snapshot` 找验证码图 → `browser_take_screenshot` 存图 → Read 看图算 → `browser_type` 填 → 删图。
+- 验证码有时效（1-2分钟），所以**填完立刻点登录**，别在中间插别的操作。
+- 自识别连失 2 次才交人。
+
+**⑨ 用例必须一次生成全部（正向+异常），禁止一条一条生成。**
+- 每生成一条 = 一次模型调用。一次写完 Q-1(正向) + Q-2(异常) + ... 全部。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+> 🔴 **脚本路径——不要反复 dir 搜索！**
+>
+> **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+> ```bash
+> R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
+> ```
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。
+> **后续脚本统一用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`，不要再搜！**
+> 如果 `repo_root.py` 报错找不到，先在仓库里跑 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" install-qw`。
+
+- `<R>/.qoder/.developer` — 当前开发者
+- `<R>/.qoder/config.yaml` 的 `autotest:` 段 — 环境/域名
+- **quick 不需要**读任务/PRD/代码。browser 才需要任务目录。
+
+### 🔴 测试页面 URL 用 --routes 查，禁止 grep 路由文件！（实测 QoderWork 反复踩坑）
+
+**🚫 绝对禁止**：grep 源码里的 `router/routes/*.ts` 找 URL、读 `core.ts` 搜 component、从 API 端点反推 URL。
+（实测：QoderWork 里 AI 反复 grep `abnormalManage.*index.vue in core.ts` 搜了十几遍无匹配，纯浪费。）
+
+**唯一正确做法**——1 条命令查 MySQL sys_menu 真实路由：
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" search --routes 保险
+# → 保险管理 -> /veh/vehicle/vehAffair/insurance
+```
+- 数据来自 MySQL `sys_menu` 表（后台动态菜单，**唯一事实源**）
+- 没找到 → 先 `--routes` 搜英文关键词（insurance/asset/attendance），再试中文
+- **还是没找到 → 直接问用户页面叫什么，不要去 grep 源码**
+
+### 生成用例时用 MySQL MCP 补真实数据（少手填、覆盖边界）
+
+1. **取真实测试数据**：需要业务单号/账号时 `cap.mcp.call("query_data", {"table": "表名", "columns": "id", "单号列", "where": "条件", "limit": "5"})`
+   - 拿测试库真实可用的数据，别编造。填进用例的 data 里。
+   - [QAS环境] 数据行仅参考格式，不代表线上。
+2. **枚举边界覆盖**：涉及状态/类型字段时 `cap.mcp.call("query_distinct", {"table": "表名", "column": "状态列"})`
+   - 查真实取值范围（如 case_status = 1/2/3/4），按每个值造边界用例。
+   - 取值范围可信 → 用例枚举全覆盖，不漏分支。
+
+## 🚦 路由（仅在 /wl-test 命令或明确测试任务触发时，决定走哪条线）
+
+| 用户输入 | 路由 | 要不要搜代码 |
+|---------|------|-------------|
+| `/wl-test`（不带参数）/ "测试盲区" | **coverage** — 调 `coverage_matrix` 展示哪些功能没测 | ❌ |
+| `/wl-test 测一下登录` / "跑登录测试用例" | **quick**（默认） | ❌ |
+| `/wl-test browser 06-14-login` / "回归测试 XXX 任务" | **browser** | ❌（读任务PRD） |
+| `/wl-test unit` / "写单元测试" | **unit** | ✅（这条才搜代码） |
+
+> ⚠️ **不触发本工作流的情况**（用 QoderWork 自带浏览器即可）：
+> "测一下这个页面""看看登录能不能打开""帮我打开浏览器操作一下"——这些是随手操作，不走 autotest.py、不沉淀锚点、不产出测试报告。
+
+没明说任务名、只是随口"测一下 XX" → **quick**。
+
+---
+n## 🚨 铁律：MCP工具优先，禁跑本地脚本
+所有知识查询走 mcp__qoder-knowledge-graph__ 工具（云平台SSE），绝不跑 wlkj.py kg/context/search（本地kg空）。
+
+## coverage 测试覆盖视图（`/wl-test` 不带参数时）
+
+用户只输入 `/wl-test` 或说"测试盲区"→ 调知识图谱的 `coverage_matrix`，展示哪些功能有测试、哪些是空白：
+```
+coverage_matrix()
+→ 资产管理[✓有测试] / 考勤[✗无测试] / 薪资[✗无测试] / 保险[✓有测试]
+```
+然后建议："考勤和薪资是盲区，要补测吗？" 用户选一个 → 进入 quick/browser 生成用例。
+
+---
+n## 🚨 铁律：MCP工具优先，禁跑本地脚本
+所有知识查询走 mcp__qoder-knowledge-graph__ 工具（云平台SSE），绝不跑 wlkj.py kg/context/search（本地kg空）。
+
+## quick 快速测试（默认 · 详）
+
+**不要任务/PRD。零搜索。** 用意图+锚点格式（A方案），observe-act-extract 执行。
+
+### Step 0 + 0.5：recall 查锚点 + context_pack 取全（两者无依赖，同回合并发）
+
+> Step0（recall 锚点）和 Step0.5（context_pack 上下文）互不依赖 → **同一条消息并发发**，别先跑0再跑0.5。
+
+**Step 0：recall 查锚点**（用相对 URL，避开 MSYS 坑）
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test recall --url auth/login
+```
+- **有锚点** → 生成用例时直接把 anchor 填进 step（确定性命中，快、零 LLM）
+- **无锚点（首次）** → **先 navigate + snapshot 拿真实锚点，再生成用例**（见 Step 0.6）
+
+**Step 0.5：用知识图谱 MCP 增强用例**（1 次调用取全，与 recall 并发）
+```python
+context_pack(keyword='功能名', platform='web', role='test')
+```
+- 返回(role=test 裁剪): 代码落点 + 相关历史 PRD 标题 + API + 字段
+- 拿到后用于: API→断言点, 字段→fill 步骤更准
+
+> ⚠️ **注意：context_pack 不抓 PRD 验收标准正文**（它只取 PRD 的 title+keywords，
+> 不解析「## 验收标准」章节）。**业务规则断言不要指望 context_pack**，它给不了 expected。
+> 要把 PRD 验收标准翻译成可执行断言，用 `assertion-gen` 子命令（见下方专节）。
+
+> 图谱无数据 → 跳过，按通用模式生成。**不要再单独调 feature_overview**（信息重叠，浪费一轮）。
+
+### Step 0.6：recall 空时，先 snapshot 拿真实锚点（🔴 首次跑关键，禁止预猜 selector）
+
+**recall 返回空 = 第一次测这页。此时绝不能凭"登录页一般有账号框"去猜 CSS selector。**
+正确做法：先用 Playwright 打开页面拿一次 a11y 树，从里面提取真实 anchor：
+
+```bash
+# 1. 批量加载要用的 browser_* 工具描述 (一次并发, 别一个一个加载)
+#    最少: browser_navigate, browser_snapshot, browser_click, browser_type,
+#          browser_take_screenshot, browser_evaluate
+
+# 2. browser_navigate 到 {{base_url}}/auth/login (base_url 从 config 取, 已去尾斜杠)
+# 3. browser_snapshot 一次 → 拿到 a11y 树 (直接读对话里的内容, 不写文件)
+```
+snapshot 返回形如：
+```
+- textbox "尊敬的管理员，请输入您的账号" [ref=e36]
+- textbox "请输入您的密码" [ref=e42]
+- textbox "验证码" [ref=e56]
+- button "login" [ref=e64]: 登录
+```
+**把这里的 role+name 直接填进用例的 anchor**：
+```json
+{"intent":"fill","desc":"账号输入框","value":"{{ask:登录账号}}","anchor":{"role":"textbox","name":"尊敬的管理员，请输入您的账号"}}
+```
+> 这一步把"首次跑要靠 LLM 兜底匹配"变成"确定性命中"，是省调用的根本。
+> 拿到锚点后继续 Step 1。
+
+**🎯 知道页面名/URL 时，AI 先查按钮+接口画像（最精准，1 条命令拿到所有交互点）：**
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test page --kw 保险        # 按业务名查
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test page --url /veh/insurance  # 按URL查
+```
+（这是 AI 在 `/wl-test` 流程内部自动调用的工具，**用户只用 `/wl-test`，不碰此命令**。）
+输出每个按钮的 handler + 调用接口 + HTTP 方法 + 置信度，**直接对应到用例的 click→assert 断言点**。开发 `finish` 任务时也会自动生成 `test-handoff.md`，内容同此画像——交接场景直接读那份即可，不必重查。
+
+### Step 1：AI 据用户描述 + 锚点生成意图式用例 JSON（**一次生成全部用例**）
+**意图+锚点格式**（A方案核心）：用 `intent` 表达"做什么"，用 `anchor` 精确定位（有锚点则确定性命中，无则 LLM 兜底）。
+```json
+[{"case_id":"Q-1","title":"正确账号密码登录","platform":"web","env":"test",
+  "steps":[
+    {"intent":"goto","desc":"登录页","value":"{{base_url}}/auth/login"},
+    {"intent":"fill","desc":"账号输入框","value":"{{ask:登录账号}}",
+     "anchor":{"role":"textbox","name":"尊敬的管理员，请输入我的账号"}},
+    {"intent":"fill","desc":"密码输入框","value":"{{ask:登录密码}}",
+     "anchor":{"role":"textbox","name":"请输入您的密码"}},
+    {"intent":"click","desc":"登录按钮","anchor":{"role":"button","name":"登录"}},
+    {"intent":"extract","desc":"是否已离开登录页进入系统"}
+  ],
+  "expected":"登录成功进系统"}]
+```
+> 验证码不是单独的 step——登录按钮点击后，如果跳出验证码弹层/数学题，执行循环会**自动**走铁律⑤的 5 步自识别（screenshot→Read→type→删图），不需要在用例里写 `ask_human`。只有自识别连失 2 次才暂停交人。
+**intent 取值**：`goto`(导航) / `observe`(读页面) / `click`(点击) / `fill`(填表) / `extract`(语义断言) / `ask_human`(人机协同) / `assert`(确定性断言)
+**anchor 取值**（稳定锚点，不随刷新变）：`{role, name, placeholder, text}` 任一组合。recall 有就用，没有就留空（执行时 LLM 兜底匹配）。
+真实数据用 `{{ask:描述}}` 占位；URL 用 `{{base_url}}`。
+> ⚠️ **一次生成所有用例**（正向+异常），不要一条一条生成——每生成一条 = 一次模型调用，耗不起。
+
+### Step 2：用文件传 cases（根治命令行截断）+ 注入数据 + 出执行计划
+**把用例 JSON 写文件，再传路径**（不要内联 --cases，长 JSON 会截断）：
+```bash
+# AI 先写文件:
+#   写 workspace/members/{dev}/drafts/_autotest-cases.json
+# 再调:
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
+  --cases-file workspace/members/{dev}/drafts/_autotest-cases.json \
+  --desc "<用户描述>" --platform <web|app>
+```
+脚本自动：解析环境域名 + 从个人文档注入账号密码 + 出执行计划。
+若提示"需要测试数据 N 项" → 逐项问用户，再用 `--data` 传。
+
+### Step 3：执行循环（observe-act-extract）
+
+> **🔴 必须用 Playwright MCP 工具驱动浏览器，禁止用 QoderWork 自带连接器！**
+>
+> 自带连接器（tabs_context/navigate/computer）实测**极慢**（5-8 分钟）、tab 管理混乱、
+> Computer 截图反复失败。**Playwright MCP 快 30 倍、稳定、不折腾 tab。**
+>
+> | 操作 | 用 Playwright MCP 的工具 | ❌ 禁止用自带连接器的 |
+> |------|------------------------|---------------------|
+> | 导航 | `browser_navigate` | tabs_context_mcp / Navigate |
+> | 读页面 | `browser_snapshot` | read_page / Find |
+> | 填表单 | `browser_type` | form_input |
+> | 点击 | `browser_click` | Computer click |
+> | 截图 | `browser_take_screenshot` | Computer screenshot/zoom |
+> | 执行JS | `browser_evaluate` | javascript_tool |
+>
+> **如果你看不到 browser_* 开头的工具，说明 Playwright MCP 没生效——检查 Settings → MCP 里
+> playwright 是否启用，或重启 QoderWork。**
+
+> **🔴 工具名必须逐字匹配，禁止自创/大小写错（实测 QoderWork 里 AI 把 `browser_navigate` 调成 `BrowserNavigate` 导致全失败）。**
+> Playwright MCP（`@playwright/mcp`）注册的**全部 23 个工具**（snake_case 小写，逐字照抄）：
+> ```
+> browser_navigate  browser_navigate_back  browser_tabs  browser_close  browser_resize
+> browser_snapshot  browser_click  browser_type  browser_fill_form  browser_select_option
+> browser_hover  browser_drag  browser_drop  browser_press_key  browser_file_upload
+> browser_take_screenshot  browser_wait_for  browser_evaluate  browser_handle_dialog
+> browser_console_messages  browser_network_requests  browser_network_request  browser_run_code_unsafe
+> ```
+> ⚠️ **截图工具是 `browser_take_screenshot`（不是 browser_screenshot）**。
+> ⚠️ **导航是 `browser_navigate`（不是 BrowserNavigate / navigate）**。
+> 调用前对照上面清单，名字写错 = 工具不存在 = 整个测试失败。
+
+**🔴 调用效率（实测:一次登录测试不该超过 12 步调用）：**
+1. **工具批量加载**：进入执行阶段时，在一个回合里并发加载所有要用的 `browser_*` 工具描述（navigate/snapshot/click/type/take_screenshot/evaluate），不要用一个加载一个。
+2. **snapshot 不落地**：`browser_snapshot` 返回的 a11y 树**直接在对话里读**，禁止写 yml 文件再 Read 回来（每步省一次调用）。
+3. **有 anchor 连发不思考**：锚点已确定，`browser_type`/`browser_click` 直接按 role+name 操作，零模型调用。
+
+**对每个 step（用 Playwright MCP 工具，连着发，别每步深度思考）：**
+1. **intent=goto** → `browser_navigate`（1 次）
+2. **首次到新页面** → `browser_snapshot` **1 次**拿 a11y 树（直接读，不写文件）
+3. **intent=click/fill**（锚点优先，**确定性匹配不思考**）：
+   - **有 anchor** → snapshot 结果里按 `role+name`/`placeholder` 直接匹配 → 拿到元素 → `browser_type`/`browser_click`（**零模型调用，连着发**）
+   - **无 anchor** → 用 `desc` 语义匹配（1 次模型调用）
+   - 匹配失败 → self-heal：重新 `browser_snapshot` + 重试，最多 2 次
+4. **intent=extract** → 看 URL / 当前页面判断（1 次模型调用）
+5. **intent=ask_human** → 暂停等人
+6. **intent=assert** → 确定性校验（零模型调用）
+
+### Step 3.5：验证码识别一条龙（数学题）— 一气呵成，别绕路
+
+> **🔴 验证码铁律（实测反复踩坑）：**
+> - **禁止用 Computer 截图 / zoom 截验证码**——实测反复失败、超时、浪费 5-6 步。
+> - **禁止填默认值/瞎蒙**（如 000000）。
+> - **唯一正确路径**：JS 提取 base64 → 存图 → Read 看 → 算答案 → 填 → 删图。固定 5 步，不偏离。
+> - **验证码有时效（1-2 分钟），所以填完立刻点登录，中间别插别的操作。**
+
+按这个**固定顺序**一次走完（用 Playwright MCP 工具，约 30 秒，**连发不思考**）：
+1. **`browser_snapshot`**（如果刚才已经 snapshot 过且页面没变，可跳过）看页面元素，找到验证码图片元素
+2. **`browser_take_screenshot`** 截验证码图片 → 存临时文件（稳定，不像 Computer 截图会失败）
+3. **Read 工具看图 → 算出答案**（QoderWork 自带视觉，1 次模型调用，数学题识别率高）
+4. **`browser_type`** 填答案到验证码输入框
+5. **立刻 `browser_click` 点登录**（验证码刚填、还没过期，抓住窗口）
+6. **删掉临时图片**（bash `del _captcha.png`）
+> 验证码过期了（提示"验证码已失效"）→ 别纠结，直接刷新重走 1-5 步。
+> 识别完**必须删图**，不留垃圾。
+> 自识别连续失败 2 次或明显是短信/扫码类 → 才交人（见 Step A 铁律⑤）。
+
+### Step 4：回收结果 + 自学习沉淀（🔴 必须，不做完不出报告）
+
+> **测试跑完 ≠ 结束。** 出报告前必须回收结果 + 沉淀锚点，让下次测同页更快（Stagehand 式缓存）。
+> **不做这步 = 白测**（下次还得从零找元素）。
+
+**执行方式**：把测试结果 + 测试中 `browser_snapshot` 看到的页面元素一起回传：
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test quick \
+  --cases-file <之前的cases文件> \
+  --record '{"Q-1":"pass","Q-2":"pass","Q-3":"pass"}' \
+  --page-json '{"url":"/veh/vehicle/vehAffair/insurance","elements":[{"role":"textbox","name":"车牌号"},{"role":"button","name":"搜索"},{"role":"button","name":"新增"}]}'
+```
+
+`--record` 回收时自动：
+- ① 从 `--page-json` 提取页面元素锚点 → 存进 `test-pages.json`
+- ② 从**通过的** intent 用例提取 goto URL + anchor → 沉淀
+- ③ 登录用例通过 → 自动标记已登录
+
+**🔴 `--page-json` 的 elements 怎么来的**：测试中每次 `browser_snapshot` 看到的元素，记下来，回传时填进去。
+不需要全部——**只填这个页面关键的交互元素**（搜索框/按钮/Tab/表格），5-10 个就够。
+
+**沉淀效果**：下次 `/wl-test 测保险` → recall 命中保险页锚点 → 不用 snapshot 找元素 → 直接操作 → **省一半时间**。
+
+---
+n## 🚨 铁律：MCP工具优先，禁跑本地脚本
+所有知识查询走 mcp__qoder-knowledge-graph__ 工具（云平台SSE），绝不跑 wlkj.py kg/context/search（本地kg空）。
+
+## browser 基于任务的浏览器测试（用户明确给了任务名时）
+
+```bash
+cap.mcp.call("list_tasks", {})                     # 确认任务存在
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test generate <task>      # 生成骨架到 autotest-cases.jsonl
+# AI 读任务 PRD「验收标准」补全 steps/expected (真实数据用 {{ask:}}, 不搜源码)
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test run <task>           # 注入+出执行计划
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test run <task> --record '{"..":"pass"}'  # 回收结果
+```
+
+**回归测试增强（图谱 MCP）**：测接口改动时，用 `get_impact` 查影响范围，自动覆盖受影响页面：
+```
+get_impact(endpoint='/asset/list')
+→ 返回: 资产列表页、资产导出按钮、资产详情页都调这个接口
+→ 为每个受影响页面生成回归用例
+```
+
+---
+n## 🚨 铁律：MCP工具优先，禁跑本地脚本
+所有知识查询走 mcp__qoder-knowledge-graph__ 工具（云平台SSE），绝不跑 wlkj.py kg/context/search（本地kg空）。
+
+## unit 单元测试（说"单元测试/单测"才走这条）
+
+读 **test-generator** skill：用 `search_index.py` 定位实现代码 → 读 spec → 生成
+JUnit 测试（Mock + MockMvc，Given-When-Then，`@DisplayName`，AssertJ）→
+输出 `tests/{package}/{Class}Test.java`。
+**（只有这条线才搜代码、读源码。）**
+
+---
+n## 🚨 铁律：MCP工具优先，禁跑本地脚本
+所有知识查询走 mcp__qoder-knowledge-graph__ 工具（云平台SSE），绝不跑 wlkj.py kg/context/search（本地kg空）。
+
+## 📋 断言生成 assertion-gen（业务规则断言 · 第三档专用）
+
+> 解决痛点：quick 模式的 `_check_expect` 能执行 `{fetch, jsonpath, equals}` 断言，
+> 但那个 **equals 期望值从哪来** 没人管——靠 LLM 瞎编不可信。
+> `assertion-gen` 把"PRD 验收标准 → 可执行断言"这条断链接上。
+
+**分工（呼应图谱边界三条红线）：**
+- **人补语义**：PRD 里写结构化验收（Given-When-Then，或"条件-操作-预期"带接口名/状态码/字段值）
+- **图谱补字段**：`page_probe` 查按钮→接口，`field_map` 查中文标题→字段名
+- **真跑定对错**：assertion-gen 只产断言 JSON，跑不跑交给 quick/webaccess
+
+**什么时候用**：业务规则断言（保险延期要审批、退保校验、状态流转）——这是 quick 通用模式
+搞不定的第三档。冒烟（页面没崩）、CRUD 流（新增→列表出现）用 quick 就够，不需要这个。
+
+```bash
+# 从任务 PRD 的验收标准章节抿断言
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen --task <任务名> --page 保险
+
+# 临时用 GWT 文本兜底（PRD 没写验收标准时）
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test assertion-gen \
+  --gwt "Given 已登录保险页 When 点击延期提交 Then 接口 /api/insurance/delay 返回 code=200 且 状态列显示审批中" \
+  --page 保险
+```
+
+**输出**：`workspace/tasks/<task>/assertions.json`，每条断言带 `source` 置信度标记：
+- `规则·句中含接口` / `图谱·按钮画像` = 可信（接口路径已确定）
+- `需确认·字段未命中` = 待补（字段表查不到，留 `{{ask:}}` 占位）
+
+**两条铁律（assertion-gen 内置）：**
+1. **抽不到就老实说**：PRD 验收标准为空/纯描述 → 输出"无可抽取的结构化断言"，**绝不编造**断言。
+2. **语义不背书**：字段补全命中标 `[图谱]`，查不到留占位标 `[需确认]`，不让图谱假装懂业务。
+
+**下一步**：把 `assertions.json` 的 assertions 数组并进 quick 用例的 steps（`intent:"assert"`），
+用 webaccess 或 quick 执行真跑验证。**assertion-gen 自己不执行、不真跑。**
+
+---
+n## 🚨 铁律：MCP工具优先，禁跑本地脚本
+所有知识查询走 mcp__qoder-knowledge-graph__ 工具（云平台SSE），绝不跑 wlkj.py kg/context/search（本地kg空）。
+
+## 🔐 测试数据处理原则（个人 vs 团队隔离）
+
+- **绝不编造**：账号/密码/手机号用 `{{ask:描述}}` 占位，问用户要。
+- **个人测试数据放个人文档，绝不进 config.yaml**：config 是团队共用会 push，放账号=泄漏。
+  域名才放 config（全团队一致）。账号密码每人不同 → 个人文档。
+- **个人文档**：`workspace/members/{你的名字}/autotest-data.yaml`（gitignored，永不 push）
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test init-data                          # 生成模板
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test set-data 登录账号 test --env test   # 填(按环境/平台分块)
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test list-data --env test                # 查看(密码脱敏)
+```
+run/quick 时按 env/platform 自动取最精确的值；`--data` 可临时覆盖。
+
+## 🔁 登录态 + 登录前置（内部页面测试的前提）
+
+**测考勤/资产/保险等内部页面，前提是已登录。** 处理逻辑（一句话：能复用就复用，不能就 AI 自己登，验证码按铁律⑤走）：
+
+**Step A：查登录态**
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test login-state show
+```
+
+**Step B：按登录态决定行为**
+- **已登录** → 用例直接 `goto` 目标功能页（如 `/attendance`），**不带任何登录步骤**
+- **未登录** → **AI 自己生成登录用例并自动跑完**（账号密码从个人文档注入，验证码按铁律⑤ 的 5 步流程：`browser_take_screenshot` 截图 → Read 看图算答案 → `browser_type` 填入 → 删图）。
+  - **只有在**截图识别连续失败 2 次、或验证码明显是短信/扫码这类 AI 必定过不了的形式时，才退回人机协同：暂停一次，让用户手动过验证码，用户说"好了"就继续。**不要一上来就甩给用户。**
+
+> 🔴 **不要再说"AI 过不了验证码"这种话**——铁律⑤ 已经给了能跑通的自识别路径（Playwright 截图 + QoderWork/VLM 视觉）。默认先自己试，不行再交人。先放弃 = 违反原则①。
+
+**Step C：执行时双重校验登录态**
+即使 login-state 显示已登录，执行时也要**实际验证**（goto 目标页后看有没有被踢回登录页）：
+- `browser_navigate` 到考勤页 → `browser_snapshot` 看当前页面
+- 如果 URL 变成 `/auth/login` 或页面是登录表单 → **session 过期了** → 自动生成登录用例重登（不要让用户手动登）
+- 如果正常显示考勤页面 → 继续执行用例
+
+**执行计划里**：若 login-state 显示已登录，显示 "💡 已登录 ... 直接 goto 目标页即可"。
+若发现 session 过期/被踢 → 自动重登，不打断用户。
+
+```bash
+# 手动操作（一般不用，AI 会自动）:
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test login-state mark --env pre --platform web   # 标记已登录
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" test login-state clear --env pre                 # 清除(强制重登录)
+```
+
+## 🧩 QoderWork 增强：浏览器自动执行（可选 · 无连接器则自动回退）
+
+> 依赖 QoderWork 桌面端的 Browser Use / Computer 控制连接器（Settings → Connectors）。
+> **纯 Qoder IDE/CLI 无连接器 → 降级为人工核对清单，不报错。**
+- 有连接器：Agent 读脚本出的执行计划，用 Browser Use 驱动 Chrome 真实操作 → 记 pass/fail → 回传
+- 无连接器：输出人工核对清单，用户自己在浏览器点
+
+### 🔐 验证码 / 登录页（默认自识别，兜底人机协同）
+
+> ⚠️ **本工作流的默认策略是 AI 自识别验证码**（见 quick 铁律⑤ + Step 3.5），不是"全部甩给用户"。
+> 下面这段是**兜底**：自识别跑不通时（连续失败 2 次 / 短信扫码类验证码）才退到人机协同。
+
+登录页带**数学题验证码**时，用 `solve_captcha` action 声明：
+```json
+{"action":"solve_captcha",
+ "target":"<验证码图片元素>",
+ "fill_target":"<答案输入框>",
+ "desc":"验证码: 先 AI 自识别(screenshot→Read算→type), 失败2次再交人"}
+```
+
+**执行到 solve_captcha 时，AI 这样走（先自己试，不行才交人）：**
+1. **先自己识别**：按 Step 3.5 的 5 步——`browser_take_screenshot` 截验证码 → Read 看图算出答案 → `browser_type` 填入 → 删图（**这是默认路径，先走这条**）
+2. **连续 2 次识别失败 / 验证码明显是短信/扫码** → 才退人机协同：告诉用户"账号密码已填好，验证码我没识别出来，请你手动完成并点登录，好了告诉我"
+3. **等待**用户确认登录成功（AI 可 `browser_snapshot` 看是否已离开登录页判断）
+4. 用户登录成功后，AI 继续执行后续用例
+
+**不要一开始就跳到第 2 步**——那等于放弃了自识别能力，违背本工作流全自动的目标。
+
+### 🔁 登录态复用（能复用就别重复登录）
+
+**已登录的浏览器共享 cookie/session。** 所以：
+- 生成用例前，先 `browser_snapshot` 看当前页面，判断是否已登录（不在登录页 = 已登录）
+- **已登录** → 用例直接 `goto` 目标功能页，不写登录步骤（最快）
+- **未登录** → AI 自己生成登录用例跑完（验证码按上面策略：先自识别，兜底交人）
+
+> 不存在"必须用户先手动登录"的硬性要求——AI 能自己登就自己登。
+
+### 🛠️ 两种连接器 + 工具冲突降级（实战经验）
+
+QoderWork 有**两种**浏览器控制方式，遇到问题要在两者间切换：
+
+**① Browser Use（builtin_browser，Chrome 扩展）**——精度高、直接操作 DOM
+- ✅ 能用：`navigate` / `read_page` / `find`（只读工具，几乎不挂）
+- ❌ 易挂：`computer`(点击/截图) / `form_input`(表单) / `javascript_tool`(JS注入) —— 被 Chrome 扩展冲突拦
+- 挂的原因：其他扩展（Claude/Codex/其他 debugger 扩展）抢占了 debugger 通道
+
+**② Computer Use（builtin_computer_use，桌面自动化）**——系统级，不依赖 Chrome 扩展
+- ✅ 不受扩展冲突影响（它是模拟鼠标键盘，不走 debugger）
+- ⚠️ 要求：**浏览器窗口必须在最前台**（前台是别的应用如 ToDesk/IDE 时会操作到错误窗口）
+- ⚠️ 靠坐标，精度比 Browser Use 低
+
+**降级决策（遇到工具报错时按此走，别直接 BLOCKED）：**
+
+| 场景 | 处理 |
+|------|------|
+| Browser Use 的 form_input/click 挂了 | ① 先让用户关冲突扩展重试；② 不行就**切 Computer Use** + 提示用户**把浏览器切到前台** |
+| Computer Use 操作了错误窗口 | 提示用户：浏览器切前台（别让 ToDesk/IDE 挡着），再重试 |
+| read_page 能用但点击不能 | 用 read_page 拿到元素的坐标/ref，Computer Use 按坐标点 |
+
+**`chrome-extension://` 冲突**：`chrome://extensions` 禁用其他自动化扩展（Claude/Codex），
+只留 QoderWork 连接器。若一时解不了，**切 Computer Use + 浏览器前台**是可靠的绕过路径。
+
+## 输出规则
+- **触发即跑，跑完出报告**：/wl-test 触发 = 要测，直接生成用例→执行→出结果，不要问"要我跑吗"
+- quick/browser：用例表 + 执行结果（pass/fail），失败列原因 + 建议，全过建议继续
+- 别在 quick 里啰嗦搜代码的过程——用户要的是"测了没、通没通"
+- 验证码/登录：默认 AI 自识别（截图→算→填），连续 2 次失败或短信/扫码类才交人
 - 工具冲突：先 Playwright MCP，挂了再试 QoderWork Browser Use，最后 Computer Use + 浏览器前台，别直接 BLOCKED