chore: push all design docs, V2 plan specs, and current working state

Includes AirPlan design documents, AircOding-alpha1-plan, AirPlanV2,
AirPlan-ParaV2, AirPlan-Para V1 reference docs, and all working code
changes across packages.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

AirPlan/docs/spec/AirPlan-Para_V1.0.0_官网发布页版_参考.md

@@ -0,0 +1,142 @@
+# 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 在真实项目里更稳定、更快速、更可协作地持续交付”。