6130478c96
P0-8 扩大: do_mode.py finish_worker 全专家插件强制路由 - GUI→XDB, network→NDB, C/C++→SDB, done→Rvr, blocked/failed→Dbg - 证据去重: 已有 xdbSessions/ndbSessions/sdbReports/rvrReviewed 则跳过 P1-GAP17: 事件 emit 规范化 - 新增 7 个事件常量 (TASK_ENTERED, TASK_FINISHED, ENGINE_ENTERED 等) - 全部 emit 调用替换字符串字面量为常量，零残留 - 30 个事件类型常量全部定义且唯一 P1-GAP18: 事件日志原子轮转 - emit 计数器每 128 次检查轮转，避免每次 emit 读文件 - 清除未使用的 _emit_with_completion/_pending_merge_complete - 原子轮转: tempfile+os.replace 保证不损坏 eng 极端接管: 强制调用全部专家插件 (Dbg/XDB/NDB/SDB/Rvr) commands/do.md: 更新为全专家插件路由文档 全量测试: 69 通过, 0 失败 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
44 lines
1.4 KiB
Markdown
Executable File
44 lines
1.4 KiB
Markdown
Executable File
---
|
||
description: "AirPlan xdb mode - GUI validator with DRM/KMS native screenshot and headless CI"
|
||
argument-hint: "[capture]"
|
||
allowed-tools: "[Read, Glob, Grep, Bash, Write, Edit]"
|
||
---
|
||
|
||
# /xdb
|
||
|
||
AirXDB 是 GUI 验证器。支持 DRM/KMS 原生截图（kmsgrab）、Xvfb headless 截图、多后端自动降级。
|
||
|
||
## 截图后端
|
||
|
||
| 后端 | --prefer 值 | 适用场景 |
|
||
|------|------------|---------|
|
||
| KMS grab | `kms` | 嵌入式 DRM/KMS 显示 |
|
||
| Xvfb | `xvfb` | CI headless 环境 |
|
||
| fallback | `fallback` | 通用桌面环境 |
|
||
| auto | `auto` | 自动检测（默认，按 kms → xvfb → fallback 尝试） |
|
||
|
||
## 子命令
|
||
|
||
### 截图采集
|
||
|
||
```bash
|
||
python scripts/airplan.py --mode xdb --project . --prefer auto --output screenshot.png
|
||
```
|
||
|
||
参数：
|
||
- `--prefer`：截图后端偏好（默认 `auto`）
|
||
- `--output`：输出文件名（默认 `screenshot.png`）
|
||
|
||
返回 `{success, method, output, error}`。
|
||
|
||
## 集成路径
|
||
|
||
**Dbg 取证**：Dbg 在 `confirm_symptoms` 步骤调 xdb 获取截图证据：
|
||
```bash
|
||
python scripts/airplan.py --mode xdb --project . --prefer auto --output debug-screenshot.png
|
||
```
|
||
|
||
**Do Worker GUI 任务验证**：涉及 GUI/UI/Render 的任务，finish 前必须有截图证据。Worker 调 xdb 采集后，将截图路径写入 result.json 的 validations 字段。
|
||
|
||
**证据门控**：`EvidenceGatePolicy` 检测到任务含 GUI 关键词时，自动要求 xdb 截图证据。
|