AIOS Protocol Suite 将智能应用的交互、执行、宿主能力、外部适配和企业治理拆成多个独立模块。它不是一个 /aios 万能 API,也不是单一 SDK。
模块一览
| 模块 | 唯一职责 | 当前成熟度 |
|---|---|---|
| Interaction | Thread / Run、监督、Consent 与流式结果(Stable @ ≥ 0.6.0) | Stable |
| Host | host-results v2 wire(Stable @ ≥ 0.7.3;能力目录 waiver) | Stable |
| Runtime | Workload 查询与取消(Stable @ ≥ 0.6.5,opt-in runtime.v1) | Stable |
| Interfaces | AG-UI、Channels、MCP、Connectors 边界 adapter(Stable @ ≥ 0.7.1) | Stable |
| Management | Operator:/api/console/* + Platform /api/*(Stable @ ≥ 0.5.65) | Stable |
| Case | 轻量工作单实例与有限状态机 | Stable @ ≥ 0.6.4(opt-in,case.v1) |
成熟度是保守判定。“已有代码”不等于 Preview;机器可读契约、版本和错误语义、安全边界与一致性测试必须同时具备。
当前开发者入口
当前稳定程度最高的路径是 Interaction:
应用 / UI
│
@fellow.work/client
│
Thread / Run / Fellow StreamEvent SSE
│
Gateway → Runtime → Sandbox / Host
@fellow.work/client 是 Interaction 在 TypeScript/Web/Node 环境中的参考实现,不覆盖 Case、Runtime、Management、Connectors 或所有产品 API。
共同约束
- 每个模块独立版本化;包版本不能替代协议版本。
- Fellow
StreamEventSSE 是当前原生 wire,AG-UI 是 adapter。 - 所有副作用操作在进入 Preview 前必须定义幂等语义。
- API Key、用户 Token、Console Token 与 Host Consent 属于不同凭证域。
- Host 能力默认拒绝,必须经过能力目录、结构化参数和授权边界。
- Case / Runtime 为 Stable wire,但 仍默认关闭;不得假设无开关即挂载。
规范来源
完整的架构决策、依赖图、信任边界、成熟度和 Phase 0–5 路线见中央规范: