协议入口（Protocol Docs）

这里是 docs.zhenrobot.com/protocols/c2ai2x/ 的公开协议文档入口，服务于产品、前端与集成团队。

它负责把协议能力翻译成可执行的接入路径，不替代上游标准，也不把运行时实现细节当作集成方需要承担的工作。

提示怎么开始读

1. 先选接入路径：Hosted Inbox / Widget Embed / Full API。
2. 需要写代码时：先跑通首次请求，再回到 API Reference 对照字段。
3. 上线前：按 Production Readiness 与 Conformance 做自检。

这套文档如何分工

• 协议标准：zhen-protocol-c2ai2x
• 对外请求入口：zhen-platform-core
• 执行与路由：zhen-brain-core
• 行业示例与页面映射：业务前端

本目录是面向外部集成方的正式解释层。

Fixed reminder:

• the protocol is not the only entry product
• no-code Hosted Inbox and low-code Widget Embed sit above the protocol as productized access surfaces
• demand-side action entry is already live through console /integrations
• supply-side registration and operating entries are already live through provider/onboarding and provider/workbench
• shared-layer provider settlement / payout / take-rate is not yet a frozen public contract
• most teams should choose an access path before reading the raw execute contract
• direct protocol execution still uses the live zhen-platform-core ingress contract

Recommended Reading Order

1. overview.md
2. entry-map.md
3. choose-path.md
4. hosted-inbox.md
5. hosted-inbox-starter.md
6. widget-embed.md
7. full-api.md
8. first-request.md
9. quickstart.md
10. execution-lifecycle.md
11. core-objects.md
12. auth-and-scopes.md
13. trust-boundary.md
14. error-model.md
15. api-reference.md
16. webhooks.md
17. provider-onboarding.md
18. provider-workbench.md
19. faq.md
20. production-readiness.md
21. conformance.md
22. examples.md
23. changelog.md

推荐阅读

常用入口

选择接入路径

三条路线的对照与建议顺序。

Widget Embed

把入口留在你的网站里。

首次请求

跑通一条最小请求，建立集成骨架。

上线检查

幂等、重试、告警与安全检查。

依据与更新边界

本目录持续与以下正式资料保持一致：

1. /www/wwwroot/zhen-protocol-c2ai2x/README.md
2. /www/wwwroot/zhen-protocol-c2ai2x/docs/architecture/ADR-001-protocol-standard-boundary.md
3. zhen-platform-core live ingress contract for POST /api/execute
4. /www/wwwroot/zhen-platform-core/spec/openapi.yaml
5. /www/wwwroot/zhen-brain-core/docs/c2ai2x-runtime-consumption.md

如果本目录与标准仓库或平台线上契约不一致，以标准仓库和平台入口契约为准。