@kkeve/suite 0.0.1 → 0.0.2

package/doc/skills/keve-static-analysis/references/security-scan-guide.md

@@ -0,0 +1,32 @@
+# eslint-plugin-security 规则完整列表
+
+> AI 执行安全扫描时的规则参考
+
+---
+
+## 高优先级规则
+
+| 规则 | 检测 | 风险 |
+|------|------|------|
+| `detect-eval-with-expression` | `eval(userInput)`, `new Function(str)` | 🔴 代码注入 |
+| `detect-unsafe-regex` | `/(a+)+/`, `/(a\|a)*$/` | 🟠 ReDoS |
+| `detect-non-literal-regexp` | `new RegExp(userInput)` | 🟠 ReDoS |
+| `detect-object-injection` | `obj[userInput]` | 🟡 属性注入 |
+| `detect-xss` | `innerHTML = userInput`, `v-html` | 🔴 XSS |
+
+## 中优先级规则
+
+| 规则 | 检测 | 风险 |
+|------|------|------|
+| `detect-non-literal-fs-filename` | `fs.readFile(userInput)` | 🟠 路径遍历 |
+| `detect-pseudoRandomBytes` | `Math.random()` 用于安全场景 | 🟡 弱随机 |
+| `detect-possible-timing-attacks` | `password === input` | 🟡 时序攻击 |
+| `detect-buffer-usage` | `new Buffer(userInput)` | 🟡 内存泄露 |
+
+## Vue 专项
+
+| 规则 | 检测 | 风险 |
+|------|------|------|
+| `vue/no-v-html` | `<div v-html="userContent">` | 🔴 XSS |
+| `vue/require-v-for-key` | `<div v-for="item in list">` | 🟡 性能/DOM |
+| `vue/no-mutating-props` | `props.data = newValue` | 🟡 数据流 |

package/doc/skills/keve-static-analysis/references/ts-error-patterns.md

@@ -0,0 +1,98 @@
+# TypeScript 常见错误码及修复模式
+
+> AI 修复 TS 类型错误时的参考手册
+
+---
+
+## 高频错误码
+
+### TS2322: 类型不匹配
+
+```typescript
+// ❌ 错误
+const name: string = 123;
+
+// ✅ 修复：修正类型标注或转换值
+const name: string = '123';
+// 或
+const name: number = 123;
+```
+
+### TS2339: 属性不存在
+
+```typescript
+// ❌ 错误
+interface User { name: string; }
+const user: User = { name: 'Alice' };
+console.log(user.age); // Property 'age' does not exist
+
+// ✅ 修复：扩展接口或使用可选链
+interface User { name: string; age?: number; }
+console.log(user.age?.toString());
+```
+
+### TS2304: 找不到名称
+
+```typescript
+// ❌ 错误
+const result = someFunction(); // Cannot find name 'someFunction'
+
+// ✅ 修复：补充 import
+import { someFunction } from './utils';
+```
+
+### TS2307: 找不到模块
+
+```typescript
+// ❌ 错误
+import { foo } from './nonexistent'; // Cannot find module
+
+// ✅ 修复：检查路径、补充 .vue 后缀、或创建声明文件
+import { foo } from './existent';
+```
+
+### TS2769: 函数参数类型不匹配
+
+```typescript
+// ❌ 错误
+function greet(name: string) { ... }
+greet(123); // Argument of type 'number' is not assignable
+
+// ✅ 修复：传入正确类型
+greet('Alice');
+// 或
+greet(String(123));
+```
+
+### TS7053: 索引签名缺失
+
+```typescript
+// ❌ 错误
+const obj: Record<string, string> = { a: '1' };
+obj['b']; // Element implicitly has an 'any' type
+
+// ✅ 修复：添加索引签名或类型断言
+const obj: Record<string, string> = { a: '1' };
+obj['b'] as string | undefined;
+```
+
+---
+
+## 修复原则
+
+1. **优先修正类型标注**，而不是用 `as any` 绕过
+2. **检查 import 路径**，确认文件存在且大小写正确
+3. **检查 `.vue` 文件导入**，可能需要 `shims-vue.d.ts`
+4. **检查泛型约束**，可能需要补充 `extends` 条件
+5. **检查响应式类型**，`Ref<T>` vs `T` 需要 `.value`
+
+---
+
+## 禁止做法
+
+| 禁止 | 原因 |
+|------|------|
+| `@ts-ignore` | 掩盖错误，不解决问题 |
+| `@ts-nocheck` | 整个文件跳过检查 |
+| `as any` | 丢失类型安全 |
+| 删除文件 | 不是修复，是逃避 |

package/doc/skills/keve-static-analysis/references/vue-security-guide.md

@@ -0,0 +1,72 @@
+# Vue 安全扫描指南
+
+> AI 扫描 Vue 项目安全风险时的参考
+
+---
+
+## XSS 风险
+
+| 模式 | 风险等级 | 说明 |
+|------|---------|------|
+| `v-html="userInput"` | 🔴 Critical | 直接渲染用户输入 = XSS |
+| `element.innerHTML = userInput` | 🔴 Critical | 原生 innerHTML |
+| `v-html="sanitizedContent"` | 🟡 Medium | 取决于 sanitization 实现 |
+| `v-text="userInput"` | ✅ 安全 | 自动转义 |
+| `{{ userInput }}` | ✅ 安全 | 模板语法自动转义 |
+
+### v-html 安全修复
+
+```typescript
+// ❌ 危险
+<div v-html="comment.content" />
+
+// ✅ 使用 DOMPurify
+import DOMPurify from 'dompurify';
+const sanitized = DOMPurify.sanitize(comment.content);
+<div v-html="sanitized" />
+
+// ✅ 最佳：不用 v-html
+<div>{{ comment.content }}</div>
+```
+
+---
+
+## 数据流风险
+
+### Props 修改
+
+```typescript
+// ❌ 风险：直接修改 props
+props: { list: Array },
+setup(props) { props.list.push(newItem); }
+
+// ✅ 修复：emit 事件
+emits: ['update:list'],
+setup(props, { emit }) { emit('update:list', [...props.list, newItem]); }
+```
+
+### 计算属性中的副作用
+
+```typescript
+// ❌ 风险：计算属性中发请求
+computed: {
+  data() { return fetchData(this.id); }  // 每次访问都触发
+}
+
+// ✅ 修复：用 watch + ref
+watch: {
+  id(newId) { this.fetchData(newId); }
+}
+```
+
+---
+
+## 依赖安全
+
+### 已知 Vue 生态漏洞
+
+| 包 | CVE | 修复版本 |
+|----|-----|---------|
+| lodash < 4.17.21 | CVE-2021-23337 | 升级到 4.17.21+ |
+| vue < 2.6.12 | XSS in templates | 升级到 2.6.12+ |
+| vue-server-renderer | CVE-2024-6345 | 检查版本 |

package/doc/skills/keve-test-eval/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: keve-test-eval
+description: 测试执行与评估技能。指导用例执行（keve run），读取 Reporter 工程分类和 AI 评估结果，对失败用例做根因分析、给出修复建议、指导重跑闭环。
+allowed-tools: Bash(shell:*) Bash(npx:*) Bash(npm:*) Bash(node:*) Bash(git:*) ask_user_questions
+---
+
+# keve-test-eval
+
+## 1. 定位
+
+**本技能负责**：执行用例 → 评估结果 → 分析根因 → 修复 → 重跑。
+
+```
+keve run → confidence-data.jsonl
+                │
+                ├─ data="通过"    → 无需处理
+                ├─ data="跳过"    → 按 errorCategory 排查
+                ├─ data="不通过"  → 读 thought 判断根因 → 修复/报Bug/问用户
+                └─ data="待确认"  → ask_user_questions 确认
+```
+
+## 2. 用例执行
+
+### 2.1 前置条件
+
+项目已通过 `keve init` 初始化（见 keve-e2e-gen Phase 0），目录结构详见 `keve_test_spec/keve.yaml` 顶部注释。
+
+### 2.2 keve run 命令
+
+```bash
+# 基本执行（必传 KEVE_TASK_DIR 和 --config）
+KEVE_TASK_DIR=.keve/mr-868-temp npx keve run --config=keve_test_spec/keve-test.config.ts
+
+# 重跑失败用例
+KEVE_TASK_DIR=.keve/mr-868-temp npx keve run --config=keve_test_spec/keve-test.config.ts --last-failed
+
+# 指定/筛选用例
+KEVE_TASK_DIR=.keve/mr-868-temp npx keve run --config=keve_test_spec/keve-test.config.ts --cases=AG-01,KB-03
+```
+
+## 3. 执行结果分析
+
+读 `$KEVE_TASK_DIR/test-artifacts/latest/confidence-data.jsonl`，按 `data` + `errorCategory` 分流：
+
+| data | errorCategory | 行动 |
+|------|--------------|------|
+| 通过 | pass | 无需处理 |
+| 跳过 | env | [common-fix-guide 第2节](references/common-fix-guide.md)：Auth/网络/元素找不到 |
+| 跳过 | script | [common-fix-guide 第3节](references/common-fix-guide.md)：测试代码本身有错 |
+| 跳过 | visual | [common-fix-guide 第4节](references/common-fix-guide.md)：keveAssert 判断异常 |
+| 不通过 | assert | 读 `thought` 判断根因：脚本缺陷→自修 / 应用Bug→报Bug / 需求变更→问用户 |
+| 不通过 | script | 自修 POM/spec → --last-failed 重跑 |
+| 待确认 | * | ask_user_questions 确认实际结果 |
+
+**定位根因**：`errorCategory` → `thought` → `keveScreenshots` 截图 → 必要时读 `test-results.json` 取 error.stack → 定位 `@keveScene` / POM 方法
+
+**即时确认规则**：遇到以下情况，必须立即用 `ask_user_questions` 向用户确认，不要自行决策：
+- errorCategory=env → 确认是修复环境、添加 mock 还是标记跳过
+- thought 提示需求/预期可能变更 → 确认预期是否需要更新
+- data="待确认" → 确认实际结果是否符合预期
+
+## 4. 修复闭环
+
+```
+data="跳过" → 按 errorCategory 排查 → env 时检查 Auth → 重跑（global-setup 自动获取）
+data="不通过" + script → 自修 POM/spec → --last-failed 重跑 → 由编排层控制迭代轮次
+data="不通过" + assert → 读 thought 判断 → 自修/报Bug/问用户
+data="待确认" → ask_user_questions → 人工复核
+```
+
+每轮修复后在 `run-state.yaml` 中记录修复内容（fixes 字段），编排层读取轮次进度。
+
+> 脚本缺陷的子类型和修复流程详见 [fix-loop-guide](references/fix-loop-guide.md)
+
+## References
+
+- [confidence-data-guide.md](references/confidence-data-guide.md) — confidence-data.jsonl 字段说明、组合解读、thought 关键词、示例
+- [common-fix-guide.md](references/common-fix-guide.md) — 各 errorCategory 的排查与修复流程

package/doc/skills/keve-test-eval/references/common-fix-guide.md

@@ -0,0 +1,166 @@
+# 常规问题修复建议
+
+> 针对报告中常见错误分类的修复策略与操作指引。
+
+---
+
+## 1. errorCategory 分类与对应修复
+
+| errorCategory | 报告显示 | 典型原因 | 修复方式 |
+|---------------|----------|----------|----------|
+| script | 脚本错误 | TypeError / ReferenceError / SyntaxError | 修复测试脚本代码 |
+| env | 环境异常 | Timeout / 网络错误 / Auth 重定向 / Cookie 过期 | 检查环境或更新 Auth |
+| visual | 视觉断言失败 | keveAssert 视觉比对不通过 | 检查截图，确认是 Bug 还是断言预期需更新 |
+| assert | 断言失败 | Playwright expect 断言不通过 | 根因分析（A/B/C/D），见下方 |
+| unknown | 未知异常 | 无法自动分类的错误 | 人工排查 |
+| pass | 通过 | 测试正常通过 | 无需处理 |
+
+---
+
+## 2. 环境异常（env）修复流程
+
+环境异常是最常见的"非脚本问题"导致测试失败的原因。
+
+### 2.1 Auth / Cookie 过期
+
+**识别信号**：
+- 错误信息包含 `authenticate`、`redirect`、`ERR_`、`401`、`403`
+- 截图显示登录页面而非目标页面
+- `navigation intercepted`
+
+**修复步骤**：
+
+```bash
+# 直接重跑测试 — global-setup 每次自动获取 Auth（打开浏览器手动登录）
+KEVE_TASK_DIR=.keve/mr-868-temp npx keve run --config=keve_test_spec/keve-test.config.ts
+```
+
+`keve run` 的 global-setup 会自动：
+- 打开浏览器（非 headless）
+- 导航到登录页面，等待用户手动登录
+- 自动检测登录完成（URL 不再包含 login/auth）
+- 保存 cookies + localStorage 到 `.auth/storage-state.json`
+
+**注意事项**：
+- 确保 dev server 正在运行（`pnpm dev`），否则无法打开目标页面
+- 如果目标 URL 不是默认的 `http://localhost:3000`，使用 `--url` 参数指定
+- 如果 storage-state 路径不是默认的 `.auth/storage-state.json`，使用 `--config` 参数让命令从 Playwright config 中读取
+
+### 2.2 网络超时（Timeout）
+
+**识别信号**：
+- 错误信息包含 `timeout`、`timed out`、`TimeoutError`
+- 截图显示空白页面或部分加载的页面
+
+**排查方向**：
+1. dev server 是否正在运行？
+2. 目标页面加载是否确实很慢？（调整 Playwright config 中 `timeout` / `actionTimeout`）
+3. 网络是否不稳定？（如果是偶发，重跑一次即可）
+
+**修复步骤**：
+
+```bash
+# 如果是偶发超时，直接重跑
+KEVE_TASK_DIR=.keve/mr-868-temp npx keve run --config=keve_test_spec/keve-test.config.ts --retry-from=<round>
+
+# 如果是系统性超时，调整 timeout 配置
+# 编辑 .keve/keve-test.config.ts 中的 timeout 和 actionTimeout
+```
+
+### 2.3 元素未找到（Locator not found）
+
+**识别信号**：
+- 错误信息包含 `locator.*not found`、`waiting for selector`
+- 截图显示页面但缺少预期元素
+
+**排查方向**：
+1. 页面是否真的没有这个元素？（→ 应用 Bug，报告给开发）
+2. 定位器是否写错了？（→ 脚本缺陷，修复定位器）
+3. 页面是否还在加载中？（→ 增加 `waitFor` 或 timeout）
+4. Auth 是否过期导致页面跳转到登录？（→ 更新 Auth，见 2.1）
+
+---
+
+## 3. 脚本错误（script）修复流程
+
+脚本错误是测试代码本身的问题，与被测应用无关。
+
+**常见类型**：
+
+| 错误类型 | 典型原因 | 修复方式 |
+|----------|----------|----------|
+| TypeError | 调用 undefined 的方法、属性访问错误 | 检查变量是否已定义 |
+| ReferenceError | 使用未声明的变量 | 检查 import / 变量声明 |
+| SyntaxError | 代码语法错误 | 检查括号、逗号等语法 |
+
+**修复步骤**：
+1. 查看报告中"执行结果"列的错误信息
+2. 定位到对应的 `@keveScene` 测试脚本
+3. 修复代码错误
+4. 重跑验证
+
+---
+
+## 4. 视觉断言失败（visual）修复流程
+
+视觉断言失败说明 keveAssert 的 AI 判断认为页面视觉状态不符合预期。
+
+**排查方向**：
+1. **是真的 Bug？** → 截图显示页面确实有问题（文案错误、样式异常、功能缺失）
+2. **是断言预期不合理？** → 截图显示页面正常，但 keveAssert 的描述与实际不符
+3. **是 AI 误判？** → 截图显示页面正常，断言描述也合理，但 AI 误判了
+
+**修复方式**：
+
+| 场景 | 修复方式 |
+|------|----------|
+| 真的 Bug | 报告 Bug，不修脚本 |
+| 断言预期不合理 | 更新 `keveAssert` 的 description，使其更精确 |
+| AI 误判 | 重跑一次确认（AI 误判概率 < 5%）；如果反复误判，考虑改用 Playwright expect 断言 |
+
+---
+
+## 5. 断言失败（assert）修复流程
+
+断言失败是经过 AI 评估仍确认为"不通过"的用例，需做根因分析。
+
+### 5.1 断言失败的根因判断
+
+读 `confidence-data.jsonl` 中 `data="不通过"` 的记录，根据 `errorCategory` + `thought` 判断行动：
+
+| errorCategory | thought 关键词 | 根因 | 行动 |
+|--------------|---------------|------|------|
+| script | "locator not found" / "element not found" | 脚本缺陷 | 自修 POM/spec |
+| script | "timeout" / "wait" | 等待策略不足 | 调整 waitFor/timeout |
+| assert | "text mismatch" + MR 有相关 diff | 需求变更 | ask_user_questions 确认 |
+| assert | "element exists but behavior wrong" | 应用 Bug | 报 Bug，不修脚本 |
+| visual | "keveAssert failed but DOM passed" | 假阳性 | 查截图判断 |
+
+### 5.2 决策流程
+
+```
+data="不通过"
+  ├─ errorCategory=script → 自修 POM/spec → --last-failed 重跑
+  ├─ errorCategory=assert
+  │    ├─ thought 提示需求/文案变更 → ask_user_questions 确认
+  │    ├─ thought 提示应用 Bug → 报 Bug，不修脚本
+  │    └─ thought 提示断言逻辑错 → 自修断言 → 重跑
+  └─ errorCategory=visual → 查截图 → 判断 Bug/预期/AI误判
+```
+
+---
+
+## 6. 快速参考卡片
+
+```
+看 confidence-data.jsonl → 按 data + errorCategory 分流
+  │
+  ├─ script → 修代码 → 重跑
+  ├─ env → 检查 auth/server/网络
+  │   ├─ auth 过期 → 重跑（global-setup 自动获取 Auth）
+  │   ├─ server 没跑 → pnpm dev → 重跑
+  │   └─ 偶发超时 → 直接重跑
+  ├─ visual → 查截图 → 判断 Bug/预期/AI误判
+  ├─ assert → 读 thought 判断根因 → 修脚本/报Bug/问用户
+  └─ unknown → 人工排查
+```

package/doc/skills/keve-test-eval/references/confidence-data-guide.md

@@ -0,0 +1,78 @@
+# confidence-data.jsonl 解读指南
+
+> 每次执行后 Reporter 写入 `$KEVE_TASK_DIR/test-artifacts/latest/confidence-data.jsonl`，每行一条用例的评估结果。
+
+## 文件位置
+
+```
+.keve/mr-868-temp/test-artifacts/latest/confidence-data.jsonl
+                                           ↑ 符号链接，指向当前 round-N/
+```
+
+## 格式
+
+每行一个 JSON 对象：
+
+```json
+{"title":"AG-01: 筛选区域不显示天策门户","data":"通过","confidence":95,"thought":"DOM断言通过 + keveAssert视觉验证通过","errorCategory":"pass","keveScreenshots":["keveAssert-筛选区域验证"]}
+```
+
+## 字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `title` | string | 用例标题（@keveScene 的 title） |
+| `data` | string | 最终结论：通过 / 不通过 / 跳过 / 待确认 |
+| `confidence` | number | AI 评估置信度 0-100（跳过时为 0） |
+| `thought` | string | AI 分析推理过程（跳过时为短路原因） |
+| `errorCategory` | string | 错误分类：pass / script / env / visual / assert / unknown |
+| `keveScreenshots` | string[] | keveAssert 截图 attachment 名称列表 |
+
+## data + errorCategory 组合解读
+
+| data | errorCategory | 含义 | 行动 |
+|------|--------------|------|------|
+| 通过 | pass | 可信通过（confidence >= 80） | 无需处理 |
+| 通过 | pass | 有保留的通过（confidence < 80） | 可人工抽检 |
+| 跳过 | env | 环境异常导致未执行 | [common-fix-guide 第2节](./common-fix-guide.md) |
+| 跳过 | script | 测试代码本身有错导致未执行 | [common-fix-guide 第3节](./common-fix-guide.md) |
+| 跳过 | visual | keveAssert 异常导致跳过 | [common-fix-guide 第4节](./common-fix-guide.md) |
+| 不通过 | script | 脚本缺陷 | 自修 POM/spec → --last-failed 重跑 |
+| 不通过 | assert | 断言失败（经 AI 评估仍不通过） | 读 thought 判断根因 → 修脚本/报Bug/问用户 |
+| 不通过 | visual | 视觉断言失败 | 查截图判断 |
+| 待确认 | * | AI 证据不足无法判定 | ask_user_questions |
+
+## thought 字段解读
+
+`thought` 是 AI 的推理过程，包含具体的错误描述和判断依据。重点关键词：
+
+| thought 关键词 | 可能根因 | 行动 |
+|---------------|---------|------|
+| "locator not found" / "element not found" | 定位器找不到元素 | 检查 POM 定位器是否匹配源码 |
+| "timeout" / "wait" | 等待策略不足 | 调整 waitFor/timeout |
+| "text mismatch" | 预期与实际文本不符 | 检查 MR diff 是否有需求变更 |
+| "keveAssert failed but DOM passed" | 假阳性 | 查 keveScreenshots 截图 |
+| "redirect" / "auth" | 认证/重定向问题 | 检查 Auth 状态 |
+| "ERR_CONNECTION" | 网络问题 | 检查 dev server 和网络 |
+
+## 示例
+
+**通过**：
+```json
+{"title":"AG-01: 类型筛选只显示用户自建","data":"通过","confidence":95,"thought":"DOM断言通过 + keveAssert视觉验证通过","errorCategory":"pass","keveScreenshots":["keveAssert-AG01-Step1"]}
+```
+
+**跳过（环境异常）**：
+```json
+{"title":"AG-02: 搜索功能","data":"跳过","confidence":0,"thought":"短路: navigation timeout, page.goto 超时, 可能 dev server 未启动","errorCategory":"env","keveScreenshots":[]}
+```
+
+**不通过（脚本缺陷）**：
+```json
+{"title":"AG-03: 创建Agent","data":"不通过","confidence":88,"thought":"locator('[data-e2e-name=创建按钮]') not found, 源码中该元素使用 aria-label 而非 data-e2e-name","errorCategory":"script","keveScreenshots":["keveAssert-AG03-Step1"]}
+```
+
+**不通过（断言失败，需人工判断）**：
+```json
+{"title":"AG-04: 删除Agent","data":"不通过","confidence":72,"thought":"点击删除后页面仍显示该Agent, 但MR diff 显示删除逻辑已改为软删除(标记而非移除)","errorCategory":"assert","keveScreenshots":["keveAssert-AG04-Step2"]}
+```

package/doc/skills/keve-test-eval/references/fix-loop-guide.md

@@ -0,0 +1,67 @@
+# 修复闭环指南 (Fix Loop Guide)
+
+> test-eval 执行用例后，读 confidence-data.jsonl 按 errorCategory 分流，对 script 类自行修复。
+
+---
+
+## 脚本缺陷子类型（errorCategory=script 时自行修复）
+
+| 子类型 | 说明 | 修复方式 |
+|--------|------|----------|
+| 定位器不匹配 | 页面有替代元素 | 更新 POM 定位器 |
+| 硬编码路径/ID/路由 | 路由格式错误 | 对照源代码 router 配置验证，严禁猜测 |
+| 断言逻辑错误 | 页面显示正确但断言写错 | 调整断言 |
+| 渲染类型不匹配 | 条件渲染/动态组件 | 改用正确的定位策略 |
+| 等待策略不足 | 元素渲染时机不对 | 增加 waitFor 或调整 timeout |
+
+> errorCategory=env/visual/assert 时不自修，用 `ask_user_questions` 确认或按 [common-fix-guide](./common-fix-guide.md) 排查。
+
+---
+
+## 修复流程
+
+单次修复闭环（test-eval 内部）：
+
+```
+1. 读 confidence-data.jsonl → 按 errorCategory 分流
+2. errorCategory=script → 定位失败用例 → 修复 POM 或 spec
+3. 重跑失败用例：KEVE_TASK_DIR=.keve/mr-868-temp npx keve run --config=keve_test_spec/keve-test.config.ts --last-failed
+4. 读新一轮 confidence-data.jsonl → 重新评估修复效果
+```
+
+---
+
+## 每轮执行结果天然隔离（KEVE_TASK_DIR）
+
+每轮 round 独立输出到 `$KEVE_TASK_DIR/test-artifacts/round-N/`，`latest` 符号链接始终指向最新轮次：
+
+```
+.keve/mr-868-temp/test-artifacts/
+  ├── round-1/
+  │   ├── test-results.json
+  │   └── confidence-data.jsonl
+  ├── round-2/
+  └── latest → round-2/
+```
+
+每轮修复后在 `run-state.yaml` 中记录修复内容，编排层读取轮次进度：
+
+```yaml
+current_round: 3
+rounds:
+  1:
+    status: completed
+    passed: 14
+    failed: 5
+    fixes: ["AG-01: strict mode → .first()", "KB tooltip: broader popper locator"]
+  2:
+    status: completed
+    passed: 16
+    failed: 3
+    fixes: ["WW: scope to 欢迎语容器", "REG-01: add NotAvailable分支"]
+  3:
+    status: completed
+    passed: 19
+    failed: 0
+    fixes: []
+```