内容
# Babel
[](https://github.com/gthgomez/Babel/releases/latest)
[](./LICENSE)
[](https://github.com/gthgomez/Babel/actions)
**开源代码代理，适用于实际软件工作。**
Babel 在您的本地工作空间中规划、审查和实施工程任务。
对于每个任务，它加载一个**小型、明确的指令栈**——行为规则、领域专业知识、技能、模型适配器和项目叠加层——这样您可以在代理编辑一行代码之前看到**它将如何工作**。
| | |
|---|---|
| **产品** | 本地代码代理 — TUI/REPL + 聊天 / 计划 / 深度 |
| **主要 UI** | 交互式终端会话 (`babel`) |
| **发布** | [**v0.1.0**](https://github.com/gthgomez/Babel/releases/tag/v0.1.0) · 预发布 1.0 |
| **真实来源** | 此仓库 — [`gthgomez/Babel`](https://github.com/gthgomez/Babel) |
| **边缘** | 可检查的栈、领域路由、计划 → 审查 → 执行 |
这是**规范的公共源**。Babel 的日常开发在这里进行。
使用**发布标签 + 提交 SHA** 来固定消费者。参见 [ADR-0001](./docs/adr/ADR-0001-canonical-public-source.md) 和 [docs/guides/RELEASE.md](./docs/guides/RELEASE.md)。
## Babel 的功能
| 您需要… | Babel |
|--------------|--------|
| 交付功能或修复 | 计划工作，然后运行实现会话 |
| 在风险更改上保持安全 | 在执行前或执行期间需要更强的防护时，优先使用 **计划** 或 **深度** |
| 跨领域工作 | 将后端、前端、移动端等路由到正确的专业知识 — 而不是一个通用的提示 |
| 重用已获得的工作流程 | 用于测试、审查、治理、发布卫生等的技能 |
| 信任代理的“大脑” | 在模型运行前，从目录中预览确切的栈 |
| 集成其他工具 | 用于栈和清单检查的只读 MCP |
大多数代码代理都隐藏了系统。Babel 使代理的操作指令**模块化、可版本化和可测试**——工程软件，而不是临时拼凑。
## 快速入门
```powershell
cd .\babel-cli
npm install
npm run build
node .\dist\index.js doctor
```
验证公共表面（不需要模型）：
```powershell
cd ..
pwsh -File .\tools\validate-public-release.ps1
```
查看代理为后端任务加载的栈：
```powershell
pwsh -File .\tools\resolve-local-stack.ps1 `
-TaskCategory backend `
-Project example_saas_backend `
-Model codex `
-PipelineMode chat `
-Format json
```
黄金预览：[examples/manifest-previews/backend-verified.json](./examples/manifest-previews/backend-verified.json)
移动通道：
```powershell
pwsh -File .\tools\resolve-local-stack.ps1 `
-TaskCategory mobile `
-Project example_mobile_suite `
-Model codex `
-Format json
```
黄金：[examples/manifest-previews/mobile-direct.json](./examples/manifest-previews/mobile-direct.json)
配置本地提供商凭证：
```powershell
cd .\babel-cli
node .\dist\index.js # 交互式 TUI（聊天）
node .\dist\index.js plan "..." # 计划模式
node .\dist\index.js deep "..." # 受控深度路径
```
完整 onboarding：[START_HERE.md](./START_HERE.md) · CLI 参考：[docs/CLI_QUICKSTART.md](./docs/CLI_QUICKSTART.md)
## 代理的工作原理
在模型执行之前，Babel 从 `prompt_catalog.yaml` 解析有序栈：
1. **行为规则** — 代理如何计划、执行、验证和保持安全
2. **领域架构师** — 后端、前端、移动端、… 用于此类工作
3. **技能** — 任务所需的 reusable 工作流程
4. **模型适配器** — 为所选模型调整相同的代理
5. **叠加层** — 项目或任务特定的上下文
6. **清单** — 您 can 预览和测试的确切加载顺序
这是产品理念：**一个代码代理，其指令是工程化的，而不是临时的。**
### 产品模式
| 模式 | 使用时机 |
|------|-------------|
| `chat` | 默认对话代理（TUI 和一次性任务） |
| `chat-headless` | 用于脚本 / CI 的相同引擎 |
| `plan` | 计划后应用，需审批 |
| `deep` | 用于高风险工作的完整受控管道 |
旧别名（`verified`→`deep`，`manual`→`plan`，`direct`→`chat`）仍然有效，但有弃用警告。
### 检查 vs 执行
| 模式 | 目的 |
|------|---------|
| **检查** | 验证目录、预览栈、比较黄金、MCP — 不需要模型 |
| **执行** | `babel`（TUI）、`babel plan`、`babel deep` — 模型支持的会话 |
**预发布 1.0 诚实：** 模型支持的运行是真实且类型检查的，但需要本地凭证和工作空间设置。您仍然可以在没有 API 密钥的干净克隆上验证和预览栈。
## 仓库内容
| 路径 | 角色 |
|------|------|
| `00_`–`06_` 提示层 | 路由器、行为、领域、技能、适配器、叠加层 |
| `prompt_catalog.yaml` | 可路由栈合约 |
| `babel-cli/` | 代码代理运行时（TUI + 聊天 / 计划 / 深度） |
| `examples/` | 黄金栈预览和首次成功演练 |
| `tools/` | 验证、清理、内容策略、发布门控 |
| `docs/` | 架构、愿景、CLI 指南 |
```
Babel/
├── START_HERE.md
├── BABEL_BIBLE.md # 代理 / 集成入口
├── prompt_catalog.yaml
├── 00_System_Router/
├── 01_Behavioral_OS/
├── 02_Domain_Architects/
├── 02_Skills/
├── 03_Model_Adapters/
├── 04_Meta_Tools/
├── 05_Project_Overlays/
├── 06_Task_Overlays/
├── babel-cli/
├── examples/
├── docs/
└── tools/
```
## 状态（v0.1.0）
- 规范的开源代码代理表面 — 克隆、验证、本地运行
- **公共发布门控** 在每个 PR 上：`security` → `public-content-policy` → `linux-validation` (+ `windows-portability`)
- `main` 仅限 PR；`v*` 标签受保护；秘密扫描 + 推送保护开启
- 可选的 pre-commit 钩子；**CI 是权威的** ([CONTRIBUTING.md](./CONTRIBUTING.md))
固定时：
```json
{
"babel": {
"tag": "v0.1.0",
"sha": "8184bbbbfa818001382fdeaf8e9d51ba8bf6003d"
}
}
```
代理合约和 CLI 界面在 `1.0.0` 之前可能会更改。
## 验证
```powershell
pwsh -File .\tools\validate-public-release.ps1
pwsh -File .\tools\check-public-content-policy.ps1
pwsh -File .\tools\check-canonical-independence.ps1
```
维护者可以使用存储在**此仓库外部**的机密补充策略：
```powershell
pwsh -File .\tools\validate-public-release.ps1 -Strict `
-RequireSupplementalPolicy `
-SupplementalPolicyPath $env:BABEL_PRIVATE_SCRUB_POLICY_PATH
```
MCP（只读）：
```powershell
cd .\babel-cli
npm run build
node .\dist\index.js mcp
```
## 文档
- [START_HERE.md](./START_HERE.md) — 首次成功
- [docs/CLI_QUICKSTART.md](./docs/CLI_QUICKSTART.md) — TUI、聊天 / 计划 / 深度、医生、MCP
- [docs/VISION.md](./docs/VISION.md) — 产品方向
- [docs/architecture/ARCHITECTURE.md](./docs/architecture/ARCHITECTURE.md) — 系统形状
- [BABEL_BIBLE.md](./BABEL_BIBLE.md) — 模型和包装器的调用合约
- [CONTRIBUTING.md](./CONTRIBUTING.md)
## 贡献
最有价值的工作：
- 更强的代理行为（技能、领域、适配器）
- 更清晰的计划/运行 UX 和诊断
- 端到端编码任务示例
- 更严格的栈选择和发布安全
保持不变：私有依赖指纹、凭证、机器路径、操作员专用注释。
## 许可证
MIT。随意使用、fork 和构建。
完整文本：[LICENSE](./LICENSE)
