内容
<div align="center">
# 服务列表
**将工作会话转化为任何人都可以使用的代理。**
发布一次 Codex 或 Claude Code 会话。团队成员、客户或他们自己的代理可以继续从已经学习的内容中继续——而无需看到或更改您原始的对话。
[](https://github.com/Equality-Machine/agent-as-a-service/actions/workflows/ci.yml)
[](LICENSE)
[](package.json)
[](https://aaas-agent-service.b4yesc4t.chatgpt.site)
[尝试网页应用](https://aaas-agent-service.b4yesc4t.chatgpt.site)
·
[安装](docs/INSTALL.md)
·
[架构](docs/ARCHITECTURE.md)
·
[贡献](CONTRIBUTING.md)
·
[中文](README.zh-CN.md)
</div>

## 为什么选择 AaaS
一个有用的代理很难的部分往往不是第一个提示。它是经过数十次对话所获得的上下文:什么重要,尝试过什么,什么看起来不错,以及工作如何完成。AaaS 使这个起点可重复使用。
| 从上下文开始 | 任意分享 | 保持对话隐私 |
| --- | --- | --- |
| 发布 Codex 或 Claude Code 会话已经学习的内容。 | 给某人一个链接或代理 ID,用于网页、Codex、Claude Code、MCP 或 HTTP。 | 每次使用都开始独立的对话。消费者消息永远不会写回发布者的源会话。 |
## 不同的起点
AaaS 不是另一个提示构建器。它从一个已经完成工作的会话开始,并将累积的理解转化为可重复使用的入口点。
| 您分享的内容 | 下一个人接收的内容 |
| --- | --- |
| 提示或代理配置 | 新对话的指令 |
| 分享聊天 | 过去的可读快照 |
| 工作流导出 | 要导入和重新连接的定义 |
| **AaaS 代理** | **经过验证的上下文的私有延续** |
## 一个链接,一个起点
1. 研究人员花费长时间的 Codex 会话来测试假设和完善方法。
2. 他们将其发布为 **市场研究代理** 并分享链接。
3. 产品负责人打开它并提出实际的下一个问题:
> 将证据转化为企业买家的发布简报。
4. 产品负责人获得私有的、连续的对话。研究人员的原始会话保持不变。
同样的模式适用于项目移交、可重复使用的编码和研究合作伙伴,以及面向客户的专家:保留辛苦获得的理解,然后让下一个人从结果开始。
## 快速开始
### 使用共享代理
最快的路径不需要安装:
1. 打开 [网页应用](https://aaas-agent-service.b4yesc4t.chatgpt.site)。
2. 粘贴代理 ID,例如 `agt_...`,或打开共享代理链接。
3. 开始工作。
要在 Codex 或 Claude Code 中使用共享代理:
```bash
npx -y Equality-Machine/agent-as-a-service
```
这安装了 AaaS 技能和 MCP 集成。它 **不** 安装运行器或启动后台服务。消费者不需要它。
重启客户端后,自然地询问:
```text
使用代理 agt_... 并要求它将这个想法转化为一个三步计划。
```
### 发布您自己的代理
如果这台机器将发布会话,请安装发布者角色:
```bash
npx -y Equality-Machine/agent-as-a-service publisher
```
然后,从您要分享的 Codex 或 Claude Code 会话中:
```text
将此对话发布为名为“研究合作伙伴”的代理。在我的本地机器上运行。
```
本地发布者使用发布者机器上的持久运行器。技能解释了系统更改并在安装前请求确认。发布返回代理 ID 和可分享的链接。
参见 [安装和角色](docs/INSTALL.md) 以获取 curl 备用方案、服务器运行器设置、支持的覆盖和手动配置。
## 工作原理
```mermaid
flowchart LR
S["私有源会话"] --> V["不可变代理版本"]
V --> A["稳定代理 ID"]
A --> C1["消费者对话 A"]
A --> C2["消费者对话 B"]
C1 --> F1["提供者原生分支 A"]
C2 --> F2["提供者原生分支 B"]
```
- **源会话** 在发布者或配对运行器上保持私密。
- **代理版本** 冻结该会话中的一个已完成点。
- **代理 ID** 是人们分享的稳定身份。
- 每个 **对话** 接收其自己的提供者原生分支,并且可以独立继续。
本地模式在发布者的机器上保留源材料和提供者登录。云模式将经过身份验证的 AES-256-GCM 加密源胶囊传输到配对的服务器运行器。在这两种模式下,控制平面协调公共元数据、对话、消息和作业租约。
阅读 [架构指南](docs/ARCHITECTURE.md) 以获取对象模型、运行器拓扑、隔离边界、作业生命周期和当前信任模型。
## 接口
| 接口 | 最适合 |
| --- | --- |
| [网页](https://aaas-agent-service.b4yesc4t.chatgpt.site) | 从任何浏览器使用代理 |
| 技能 + MCP | 从 Codex 或 Claude Code 进行自然使用和发布 |
| HTTP API | 产品集成和自动化 |
| 本地运行器 | 依赖私有文件、本地存储库或桌面凭证的代理 |
| 云运行器 | 在受控服务器上始终运行 |
MCP 接口包括:
```text
runner_status
install_local_runner
publish_current_agent
find_agent
agent_start
agent_continue
agent_end
```
消费者仅使用代理工具。运行器检查和安装仅在用户明确要求本地发布时发生。
## 项目状态
AaaS 是一个 **公开预览**。核心的 fork 安全生命周期、Codex 和 Claude Code 运行时、本地和云运行器、网页客户端、MCP 接口、作业租约、取消和加密云胶囊都已实现并受到自动化和真实提供者验收测试的覆盖。
公共控制平面尚不包括帐户、配额、计费或完整的多租户滥用预防层。启用写入的工具在面向不受信任的公共流量之前还需要每个对话的工作区、身份、机密和批准隔离。
参见 [路线图](docs/ROADMAP.md)、[验证证据](docs/VERIFICATION.md) 和 [安全策略](SECURITY.md),然后再进行生产采用。
## 仓库指南
| 路径 | 目的 |
| --- | --- |
| `src/` | 控制客户端、发布者、运行器、运行时、MCP 和本地服务代码 |
| `cloud/` | 托管控制平面、网页应用、D1/R2 集成和云测试 |
| `skills/aaas/` | 可安装的 Codex 和 Claude Code 技能 |
| `tests/` | 单元、契约、分发和封闭的真实运行时验收 |
| `docs/` | 架构、安装、开发、路线图和验证 |
从 [文档索引](docs/README.md) 或 [开发指南](docs/DEVELOPMENT.md) 开始。
## 贡献
欢迎提出问题、设计讨论、文档修复、运行时适配器和测试改进。请阅读:
- [贡献指南](CONTRIBUTING.md)
- [行为准则](CODE_OF_CONDUCT.md)
- [支持指南](SUPPORT.md)
- [治理](GOVERNANCE.md)
对于漏洞,请使用 GitHub 的私有安全咨询流程,如 [安全策略](SECURITY.md) 中所述。永远不要在公共问题中发布 API 密钥、运行器令牌、私有会话文件、记录或本地路径。
## 许可证
[MIT](LICENSE) © 2026 Efflora 贡献者。