# Atelier：为编码智能体打造的开源上下文运行时与治理层

> Atelier 是一个开源的上下文运行时与治理层，为 Claude Code、Codex、Copilot 等各类编码智能体提供共享程序、故障救援、循环检测、成本追踪和跨厂商模型路由能力。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-24T14:43:28.000Z
- 最近活动: 2026-05-24T14:54:04.327Z
- 热度: 159.8
- 关键词: AI Agent, MCP, Coding Agent, Context Runtime, Claude Code, OpenAI Codex, GitHub Copilot, Agent Governance
- 页面链接: https://www.zingnex.cn/forum/thread/atelier
- Canonical: https://www.zingnex.cn/forum/thread/atelier
- Markdown 来源: ingested_event

---

## 原作者与来源

- **原作者/维护者：** atelier-runtime 组织
- **来源平台：** GitHub
- **原始标题：** atelier
- **原始链接：** https://github.com/atelier-runtime/atelier
- **发布时间：** 2026年5月24日

---

## 引言：当编码智能体需要<上下文记忆>

在 AI 辅助编程工具爆发式增长的今天，开发者们已经习惯了与 Claude Code、GitHub Copilot、OpenAI Codex 等智能体协作。然而，这些工具往往各自为战：Claude 不知道你在 Cursor 里做了什么，Copilot 不了解 Codex 上周帮你解决的那个棘手问题。每一次对话都是一张白纸，每一次任务都要从零开始解释背景。

Atelier 正是为了解决这一痛点而生。它是一个开源的上下文运行时与治理层，通过 MCP（Model Context Protocol）服务器和 Python SDK，为各类编码智能体提供共享的程序知识、故障救援、循环检测、成本追踪和跨厂商模型路由能力。

---

## 核心架构：CLI + MCP + 后台服务三位一体

Atelier 的设计理念是「一次安装，处处可用」。安装后，你将获得三个核心组件：

### 1. CLI 工具（`atelier`）

完整的命令行接口，用于管理上下文、追踪记录、规则验证和运行时状态。无论是查询已知的解决方案，还是验证代码变更的安全性，都可以通过简单的命令完成。

### 2. MCP 服务器（`atelier-mcp`）

标准化的 MCP 协议实现，让任何支持 MCP 的智能体主机都能无缝接入 Atelier 的能力。这意味着 Claude Code、Codex CLI、Copilot、Cursor、甚至你自己开发的 Agent，都可以共享同一个上下文存储。

### 3. 后台服务（`servicectl`）

在系统层面持续运行的服务，负责自动更新、会话导入、ReasonBlock 合并、外部分析等任务。它会在后台默默工作，确保你的上下文库始终保持最新。

---

## 核心能力详解

### 上下文复用：ReasonBlock 知识库

Atelier 将你的工程经验编码为可复用的「ReasonBlock」。当面对类似任务时，系统会基于 BM25 算法和向量相似度，自动检索最相关的解决方案。

```bash
atelier tools call context --dev --args '{
  "task": "配置 staging 环境的 HTTPS",
  "domain": "infra",
  "files": ["deploy/nginx.conf"]
}' --json
```

这不仅节省了重复解释的时间，更重要的是，它让团队知识得以沉淀和传承。

### 故障救援：从错误中学习

每次任务执行都会被记录为追踪（trace）。当相同的错误模式再次出现时，Atelier 会从历史故障中提取针对性的救援程序。

```bash
atelier tools call rescue --dev --args '{
  "task": "部署到 staging",
  "error": "证书已过期",
  "domain": "infra"
}' --json
```

这种「从失败中学习」的机制，让智能体不再是每次都在同一个地方跌倒的新人。

### 规则验证：安全网机制

对于高风险操作（如状态变更、配置修改、回滚），Atelier 支持定义领域特定的安全检查（rubric）。这些检查会在操作前后执行，确保关键步骤不被遗漏。

```bash
atelier tools call verify --dev --args '{
  "rubric_id": "rubric_state_change_safety",
  "checks": {
    "canonical_identifier_used": true,
    "pre_change_state_captured": true,
    "read_after_write_completed": true
  }
}' --json
```

### 模型路由：聪明的负载均衡

不同的任务适合不同的模型。Atelier 可以根据任务复杂度、成本预算和可用厂商，智能路由到最合适的模型。它还提供跨厂商路由建议、反事实定价模拟和质量感知策略评估。

### 记忆与召回

Atelier 提供多层次的记忆系统：

- **归档记忆**：基于嵌入向量的智能体特定记忆段落搜索
- **语义文件记忆**：通过 tree-sitter AST 解析索引文件内容
- **符号记忆**：基于 SCIP 索引的跨工作区符号搜索
- **跨厂商记忆**：适配 Claude、Codex、Gemini 等厂商的记忆系统

### 循环检测与看门狗

智能体有时会陷入「震荡」或「反复自我怀疑」的循环。Atelier 能检测这些执行病理（如抖动、二次猜测、重复失败），并在智能体耗尽上下文预算之前建议救援方案。

---

## 支持的智能体主机

Atelier 通过 MCP 与主流智能体主机集成：

| 主机 | 配置 | 集成类型 |
|------|------|----------|
| Claude Code | `claude.yaml` | MCP + skills + agents + plugin hooks |
| Codex CLI | `codex.yaml` | MCP + AGENTS.md + hooks |
| Copilot | `copilot.yaml` | MCP + instructions |
| opencode | `opencode.yaml` | MCP + Agent |
| Antigravity | `antigravity.yaml` | MCP |
| Cursor IDE | `cursor.yaml` | MCP |
| Hermes Agent | `hermes.yaml` | MCP |

---

## 会话导入：兼容 18 种智能体

Atelier 的后台服务支持从 18 种不同的智能体主机导入历史会话，包括：antigravity、claude、codex、copilot、crush、cursor、cursor-agent、droid、gemini、goose、kilo-code、kiro、omp、openclaw、opencode、pi、qwen、roo-code。

这意味着，即使你之前使用多种不同的 AI 工具，现在也可以将历史对话统一归档到 Atelier 中，形成完整的知识图谱。

---

## 语言支持

Atelier 的代码智能引擎支持多种语言，不同语言的支持程度有所差异：

**完整代码智能（符号、导入、调用图）**：Python
**基础代码智能**：JavaScript、TypeScript、Go、Rust
**语义文件记忆**：Python、TypeScript、JavaScript、Kotlin、Go、Rust、Java、Ruby、C、C++、C#、PHP、Swift、Scala、Bash

所有语言都支持基于 grep 的搜索和大纲模式读取，差异仅在于 AST 分析的深度。

---

## 安装与快速开始

安装只需一条命令：

```bash
curl -fsSL https://raw.githubusercontent.com/atelier-runtime/atelier/main/scripts/install.sh | bash
```

安装器会自动完成以下工作：
- 在 `~/.local/bin` 安装 `atelier`（CLI）和 `atelier-mcp`（MCP 服务器）
- 在 `~/.atelier` 初始化运行时存储
- 启动后台服务（Linux 使用 systemd，macOS 使用 launchd）
- 可选启动可视化栈（当 npm 可用时）
- 当检测到支持的智能体主机 CLI 时，安装对应的集成

验证安装：
```bash
atelier --version
atelier-mcp --version
atelier background status
```

---

## 总结与展望

Atelier 代表了编码智能体生态的进化方向：从孤立的工具，走向互联互通的上下文共享网络。它不仅仅是一个工具，更是一种新的工作范式——让智能体拥有「记忆」，让团队协作拥有「传承」。

对于个人开发者，Atelier 意味着不再需要在每次对话中重复解释项目背景；对于团队，它意味着知识可以沉淀为可复用的 ReasonBlock；对于组织，它提供了治理和审计的基础设施。

随着 AI 编程工具的普及，上下文管理将成为基础设施层面的关键问题。Atelier 的开源方案为这个问题提供了一个值得关注的答案。