Files

AirCoding b6ab853a8c docs: 重写中英文 README，移除19种其他语言版本

- README.md (EN): AirCoding 完整介绍，含架构/权限/安装/约束铁律
- README.zh.md (ZH): 中文完整版
- 删除 ar/bn/br/bs/da/de/es/fr/gr/it/ja/ko/no/pl/ru/th/tr/uk/vi/zht 等 19 个语言版本
- 移除所有 opencode 外部链接（Discord/npm/GitHub Actions/opencode.ai）

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-06-16 09:51:58 +08:00

5.1 KiB

Raw Blame History

AirCoding

确定性优先、LLM 为辅的多 Agent 协作 AI 编程系统

English | 简体中文

概述

AirCoding 是一个确定性调度为主、LLM 为辅的多 Agent 协作编程框架，C++ 为首个深度支持语言。

核心设计原则：

工具白名单是硬阻断：每层 Agent 的能力由代码级权限控制，不依赖 Prompt 约束
确定性调度优先：正常流程走 DAG 状态机，异常和边界才调 LLM
两层审查：Worker 自验 + Reviewer Code-to-Design 审查
证据门控：cppcheck 强制（C++ 项目），取证后才能改代码（DEBUG 模式）
禁降级兜底：调度器和执行器严禁以「先这样」「先跑通」「以后再改」「for now」「temporary solution」等任何理由使用降级方案代替设计实现
审查器强制调用：审查器不可跳过、不可默认通过，必须逐行对照设计方案后，再经静态审查和测试验证，全部通过才能放行

架构

用户 → Main Agent (aircoding) → 协调派发
         │
         ├─→ Architect（架构规划器）
         │     产出：plan.md + task-graph.json + ADR + C4 文档
         │
         └─→ Scheduler（调度引擎）
               │  coordinator_tick 确定性 DAG 调度
               │
               ├─→ Worker（执行器 / 调试器）
               │     EXECUTE: 写代码 → 编译 → 测试 → cppcheck
               │     DEBUG:   取证 → 记录 → 修复 → 验证
               │
               └─→ Reviewer（代码审查器）
                     对照 plan.md 做 Code-to-Design 审查
                     三层强制流程：
                     1. Code-to-Design 逐行对照表
                     2. 静态审查（安全性 / 正确性 / 合规性）
                     3. 测试 / 构建验证

Agent 权限矩阵

Agent	可用工具	禁止工具
aircoding (Main)	read, glob, grep, task, question, web, coordinator_status, coordinator_tick	write, edit, bash
Scheduler	read, glob, grep, task, coordinator_*	write, edit, bash
Worker	read, write, edit, bash, glob, grep	task
Architect	read, glob, grep, task, edit/write (.air/shared/plan/**)	bash, 源代码文件写
Reviewer	read, glob, grep	write, edit, bash, task

安装

二进制（Linux x64）

# 下载发布包
wget http://git.airlongdian.fun/admin/AirCoding/releases/download/0.1.0/AirCoding-Alpha-0.1.0-linux-x64.tar.gz
tar xzf AirCoding-Alpha-0.1.0-linux-x64.tar.gz
cd AirCoding-Alpha-0.1.0 && ./install.sh

aircoding --version  # → 0.1.0

二进制安装到 ~/.aircoding/，与 opencode（~/.opencode/）互不冲突。

从源码构建

bun install          # 安装依赖
bun typecheck        # 类型检查（29 包，全部通过）
cd packages/opencode && OPENCODE_VERSION="0.1.0" OPENCODE_CHANNEL="aircoding" bun run script/build.ts --single --skip-embed-web-ui

目录约定

.air/shared/plan/plan.md               # 架构方案（Architect 产出）
.air/shared/plan/task-graph.json       # 任务图（Architect 产出，Scheduler 执行）
.air/shared/plan/docs/ADR-*.md         # 架构决策记录
.air/shared/plan/docs/c4/              # C4 模型文档
.air/local/state/scheduler-state.json  # 调度器状态（实时落盘）
.air/local/debug/debug-log.md          # 调试记录

设计文档

详细设计文档在 docs/ 目录：

约束铁律

详见 CLAUDE.md。摘要：

调度器：禁止降级兜底，必须完全遵循设计方案。设计未覆盖的场景先派 Architect 更新设计，不得在代码中自行裁决。
执行器：禁止以「先跑通」「以后再改」「以后补上」「for now」「fix later」等理由使用简化实现。编译→测试→cppcheck 三步不可跳过。输出含降级措辞直接 FAIL。
审查器：强制调用，不可跳过。「测试 pass」「函数存在」「build 通过」不得作为 PASS 依据。必须输出 Code-to-Design 逐行对照表。代码门确定性执行此规则。
防无限循环：Architect 里程碑审查设有每阶段2次 / 全局5次的派发预算 + milestone_satisfied 门控，防止 Scheduler 和 Architect 之间无限循环。

致谢

基于 OpenCode v1.17.4 fork。

5.1 KiB Raw Blame History Unescape Escape