可插拔 AI 网关运行时。Core 经 hashicorp/go-plugin 将插件作为独立 gRPC 子进程加载，统一完成鉴权、账号调度、转发、计费；协议兼容与上游对接由插件承担。
本目录为 monorepo 工作区：各子目录是独立 Git 仓，经 go.work 协作开发，跨仓改动分仓提交。
| 仓 | 类型 | 职责 |
|---|---|---|
airgate-core/ |
运行时 | 用户/账号/计费/调度/任务/资产/后台 UI、插件生命周期 |
airgate-sdk/ |
契约层 | 插件接口、gRPC 协议（ABI）、运行时桥、devserver、前端主题 |
airgate-openai/ |
网关插件 | OpenAI 协议 + Anthropic 转换 |
airgate-claude/ |
网关插件 | Claude Messages API |
airgate-kiro/ |
网关插件 | Kiro（AWS CodeWhisperer） |
airgate-playground/ |
扩展插件 | Web 聊天 UI |
airgate-studio/ |
扩展插件 | 多模态内容创作 |
airgate-epay/ |
扩展插件 | 支付渠道 |
airgate-health/ |
扩展插件 | 提供商健康监控 |
cd airgate-core
make install # 安装全部依赖（Go + pnpm + 插件前端 + air）
make dev # 完整开发环境（后端热重载 + 前端 vite + 插件 watch）部署与配置详见 airgate-core/README.md。
| 想了解 | 看哪份 |
|---|---|
| 架构现状（权威，对得上代码） | core-dev skill：backend（后端分层）/ forwarding（转发·调度·计费）/ task（任务状态机）/ plugin-contract（契约·技术债）/ frontend |
| 生态边界与开发护栏 | 根 CLAUDE.md（职责速查表、红线）；各子仓 CLAUDE.md 叠加本仓规则 |
| core ↔ 插件契约细节 | plugin-contract.md（Metadata 约定表、Host.Invoke、Capability） |
| 已知架构差距 / 勿加深清单 | plugin-contract.md 「技术债」节 |
| 任务子系统设计 | task.md |
| 网关插件开发护栏 | develop-plugin skill（边界铁律、能力归属、构建流程） |
| SDK 包内边界规范 | airgate-sdk/docs/sdk-package-boundaries.md |
| 插件前端样式规范 | airgate-sdk/docs/plugin-style-guide.md |
| 类型 | 位置 | 规则 |
|---|---|---|
| 护栏（AI 开发指引） | 根/子仓 CLAUDE.md（AGENTS.md 为指针） |
只放红线与任务路由，细节下沉 skill |
| 权威规范（对得上代码） | .claude/skills/ |
单一事实源；改转发/契约/计费/调度/任务须同步更新（防漂移红线） |
| 门面 README | 各仓 README.md |
面向部署者/插件作者；core 中英双份由 verify-readme 强制结构同步 |
| 产品内文档 | airgate-core/web/src/content/*.md |
前端渲染给最终用户；当前硬编码插件路由，已登记越界待治理 |
| 研究笔记 | <仓>/docs/，文件名或文首带观测日期 |
文首声明「时点观测 / 非规范」；失效即删（仍有价值的结论先转移至 skill），历史经 git 追溯 |
| 审计快照 | 根 docs/audits/YYYY-MM-DD-<主题>.md |
时点产物用完即删：活性结论/待办先转移至对应 skill，再删除文件（历史经 git 追溯） |
| 运行时资源 | backend/resources/*.md 等 embed 资产 |
非文档（随代码走，改动即功能变更），文档审计排除 |
维护铁律：现状以代码 + core-dev / develop-plugin skill 为准，改架构须同步改对应 skill（防漂移红线，见根 CLAUDE.md）；同一信息只在一处权威维护，其余位置用链接引用，禁止复制第二份。
AI 辅助开发护栏见 CLAUDE.md（AGENTS.md 为其指针）。共享 skill 位于 .claude/skills/：core-dev / develop-plugin / airgate-ci-check。