# AirPlan-Para V1.0.0
## 让 AI 开发从“能写代码”升级到“能稳定交付”

AirPlan-Para 是一套已经落地的 AI 工程插件套件。它面向 Claude Code / Codex 本地工作流，把规划、调度、执行、调试、GUI 证据、网络抓包、静态分析和长会话恢复整合成一个可恢复、可追溯、可验证的工程系统。其调度层 aireng 采用非占用式设计，开发者可随时介入调整约束与方向；同时以隔离并行执行替代串行等待，显著加快多任务交付速度。

## 当前版本已经实现的核心能力

### AirArc：规划 + 并行评审

- architecture-first planning
- `plan.md` / `todo.md` 驱动
- dependency edges
- parallel groups
- shared write-set conflicts
- serialization points
- execution plan 输出

### AirEng：调度 + 合并

作为公共调度层，aireng 有两个核心设计优势：一是派发 worker 后多数时候处于非占用状态，开发者可随时交流补充信息、调整约束或介入更正，调度不是黑盒；二是以 bounded concurrency 策略并行派发多个隔离 worker，将串行等待变为并发推进，大幅压缩交付周期。

- 读取 AirArc execution artifacts
- 生成 dispatch manifest
- bounded concurrency 调度多个隔离 AirDo worker
- 合并结构化结果
- 准备 repair dispatch 与 repair queue
- 同步 `plan.md`、`todo.md`、ADR、C4

### AirDo：单任务执行 + finalize

- task-local brief / handoff
- 结构化 `result.json`
- finalize 到 `AirPlan/state/airdo/results/`
- `worker-state.json` 记录 canonical result path
- GUI 任务自动接 AirXDB
- blocked / failed validation 自动接 AirDbg

### AirDbg：Debug-first repair

- reproduce
- root cause analysis
- minimal fix
- regression verification
- 联动 AirXDB / AirNDB / AirSDB
- 维护 AGENTS、ADR、C4、debug log

### AirXDB：GUI 证据

- Midscene GUI 调试
- 本地与远程截图
- Computer MCP smoke
- model-family 检查
- Windows 截图资产修复

### AirNDB：网络证据

- bounded local / remote tcpdump or WinDump
- Windows 自动下载官方 WinDump.exe
- BPF filter
- pcap 读取与摘要
- 远程 SSH 抓包辅助

### AirSDB：C/C++ 静态分析

- 本机与远程 cppcheck
- `--check-level=exhaustive`
- XML / JSON 报告
- `staticanalysis.md` AI-readable 摘要

### AirContext：上下文压缩 + 自动恢复

- 规则驱动的外部上下文压缩
- `aircontext` wrapper 自动恢复会话
- 在 `AirPlan/AirContext/` 维护每项目配置、规则和 snapshot
- 为 AirArc / AirEng / AirDbg / generic workflow 提供不同压缩模板

## 结果完整性保护

AirPlan-Para 不允许“看起来完成、实际上没做完”的空结果混进交付流。

当前版本已经实现：

- untouched 默认模板不能 finalize
- `done` 结果不能是逻辑空载荷
- `worker-state.json` 中的 `resultPath` 是 canonical 结果定位
- 无真实 blocker 时，worker 默认继续执行到 finalize

## 自动项目初始化

`airarc` 和 `aireng` 在首次启动时会自动检测并补齐缺失的 `AirPlan/` bootstrap 工件，无需先手动初始化一次项目。

使用 `aircontext` 时，套件还会在项目内维护：

- `AirPlan/AirContext/config.yaml`
- `AirPlan/AirContext/rules.md`
- `AirPlan/AirContext/active_rules.md`
- `AirPlan/AirContext/state.json`
- `AirPlan/AirContext/snapshots/`

## 插件组成

AirPlan-Para V1.0.0 当前包含 8 个插件：

- `airarc 0.3.1`
- `aireng 0.6.0`
- `airdo 0.5.0`
- `airdbg 0.1.4`
- `airxdb 0.2.2`
- `airndb 0.1.2`
- `airsdb 0.1.1`
- `aircontext 0.1.0`

## 部署方式

部署包名称：

- `AirPlan-Para.zip`

安装入口：

- `install_to_home.ps1`
- `install_to_home.cmd`
- `init_project_airplan.ps1`

仓库中同时包含 `AirContext/` 目录，用于套件里的 context continuity 插件。

## 适合什么场景

- 长周期项目
- 多会话恢复
- 任务级隔离执行
- 受控并发调度，以并行执行缩短交付周期
- 需要在 AI 执行过程中随时介入、调整方向的团队
- GUI、网络、静态分析参与交付验证
- C/C++、Qt、嵌入式、远程设备
- 需要工程证据和调试轨迹的团队
- 需要控制 compact 策略并自动恢复长会话的团队

## 一句话总结

如果普通 coding agent 解决的是“让 AI 开始写代码”，
那么 AirPlan-Para 解决的是“让 AI 在真实项目里更稳定、更快速、更可协作地持续交付”。