Files
AirPlan-V2/commands/xdb.md
AirPlan 6130478c96 feat: AirPlan V2 — 全专家插件强制路由 + 事件系统规范化
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>
2026-06-12 15:56:44 +08:00

1.4 KiB
Executable File
Raw Permalink Blame History

description, argument-hint, allowed-tools
description argument-hint allowed-tools
AirPlan xdb mode - GUI validator with DRM/KMS native screenshot and headless CI [capture] [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 尝试)

子命令

截图采集

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 获取截图证据:

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 截图证据。