docs: 全部 12 个命令文件完整化 — 消除 P0/P1 操作歧义

P0: 9 个存根命令文件从 11 行模板扩展为完整操作文档
- dbg: 7 步工作流表格 + 证据类型 + 子命令 + Dbg↔Do 集成路径
- ctx: 三级降级压缩 + 质量校验 + Token 估算 + 陈旧锁清理
- dep: SSH 部署流程 + MD5 校验 + systemd 管理
- tst: 5 种测试框架 + run 命令 + T-TEST 集成
- sec: advisory/blocking 双模式 + 文件/目录/Woker result 三种扫描
- rvr: 审查模式 + highRiskAudit + code-to-design + Eng merge 集成
- sdb: 6 种后端 + diff 模式 + Dbg 取证集成
- ndb: 网络抓包 + Dbg 取证集成
- xdb: kmsgrab/xvfb/fallback 三后端 + Dbg/Do GUI 验证集成

P1: 3 个有内容文件的歧义修复
- do: AirDbg 路由具体命令 + 证据采集(xdb/ndb/sdb/tst)命令
- arc: 三阶段→命令映射表 + phase 推进方式
- eng: monitor 轮询循环伪代码(Agent 无时钟概念,必须循环调 monitor)

全部命令统一使用 `python scripts/airplan.py` 路径(清除旧 $HOME/plugins 引用)

63 项功能测试全通过

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
AirLongDian
2026-06-11 15:57:12 +08:00
parent cda601a73a
commit 9ad232af38
12 changed files with 499 additions and 72 deletions

View File

@@ -1,11 +1,43 @@
---
description: "AirPlan xdb mode"
argument-hint: "[enter|status|...]"
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
Run AirPlan xdb mode.
AirXDB 是 GUI 验证器。支持 DRM/KMS 原生截图kmsgrab、Xvfb headless 截图、多后端自动降级。
python "$HOME/plugins/airplan/scripts/airplan.py" --mode xdb --project . [OPTIONS]
## 截图后端
| 后端 | --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 截图证据。