Developer Docs

文档首页
API ReferenceAIOS 协议族InteractionHostRuntimeInterfacesManagementObject（Proposed）Control（Proposed）Events、Errors 与 SchemasCapability Discovery兼容矩阵Changelog

开发文档 · API 与协议参考

AIOS 协议族

Interaction、Host、Object、Control、Runtime、Interfaces、Management 七个协议模块的职责与成熟度。

AIOS Protocol Suite 将智能应用的交互、对象、控制、执行、宿主能力、外部适配和企业治理拆成七个独立模块。它不是一个 /aios 万能 API，也不是单一 SDK。

七个模块

模块唯一职责当前成熟度
InteractionThread / Run、监督、Consent 与流式结果Preview
Host受控宿主能力、参数校验与授权Experimental
RuntimeRun、作业、沙箱 workload 与 HARP 生命周期Experimental
InterfacesAG-UI、Channels、A2A、MCP 等边界适配Experimental
Management身份、凭证、Scope、策略、版本与审计Experimental
Object情境对象身份、状态、版本、事件与访问Proposed
Control基于对象期望态进行幂等协调和例外处理Proposed

成熟度是保守判定。“已有代码”不等于 Preview；机器可读契约、版本和错误语义、安全边界与一致性测试必须同时具备。

当前开发者入口

当前稳定程度最高的路径是 Interaction：

应用 / UI
   │
@fellow.work/client
   │
Thread / Run / Fellow StreamEvent SSE
   │
Gateway → Runtime → Sandbox / Host

@fellow.work/client 是 Interaction 在 TypeScript/Web/Node 环境中的参考实现，不覆盖 Object、Control、Runtime、Management、Connectors 或所有产品 API。

共同约束

  • 每个模块独立版本化；包版本不能替代协议版本。
  • Fellow StreamEvent SSE 是当前原生 wire，AG-UI 是 adapter。
  • 所有副作用操作在进入 Preview 前必须定义幂等语义。
  • API Key、用户 Token、Console Token 与 Host Consent 属于不同凭证域。
  • Host 能力默认拒绝，必须经过能力目录、结构化参数和授权边界。
  • Object 与 Control 在实现和 conformance 完成前不得宣称可用。

规范来源

完整的架构决策、依赖图、信任边界、成熟度和 Phase 0–5 路线见中央规范：