C2AI2X 总览

C2AI2X 是 Zhen 生态面向多入口接入的统一协议层。

它要解决的不是某一个垂直站点怎么接 AI，而是：

• 不同站点、插件、partner app 如何用统一对象描述需求
• 平台如何用统一 admission、scope、entitlement、quota 规则接入这些需求
• brain 如何在不接管平台真相的前提下消费这些协议对象并执行

当前三层结构

1. 标准层

• 仓库：zhen-protocol-c2ai2x
• 负责 neutral schema、examples、conformance

2. 平台入口层

• 仓库：zhen-platform-core
• 当前 live route：POST /api/execute
• 负责 auth、API key、scope、entitlement、quota、sandbox、audit

3. 执行层

• 仓库：zhen-brain-core
• 只消费平台已经解释好的 payload
• 不面向业务前端或第三方直接开放

当前 phase 1 能力

当前对外冻结的是 execute 型协议入口，而不是全量生态能力。

phase 1 已公开的能力：

• 可执行 HTTP ingress：POST /api/execute
• 同步执行：execution_mode = "sync"，返回 output、usage_applications，以及可选 exact_bridge
• 异步执行：execution_mode = "async"，返回 accepted.workflow_id 与 follow-up URLs
• neutral protocol objects 可作为 structured_input 中的业务载荷随平台翻译链路进入执行面

phase 1 尚未公开冻结为独立协议能力的内容：

• protocol-specific webhook push
• partner-facing callback infrastructure
• protocol-native billing truth
• protocol-native org / workspace lifecycle

谁应该读这里

• 外部开发者
• 第三方入口接入方
• 插件或生态 partner
• 需要理解 C2AI2X 对外口径的产品 / 架构 / BD 团队

若你在做 platform 或 brain 内部实现，仍应回到对应仓库文档看实现契约。