27. 文档即基础设施

IONON 的文档由规范来源和机器可读的注册表生成，而不是在五个网站上手工重写。

docs.ionon.ai 应为自托管。仓库包含 Markdown/MDX、合约注册表、JSON 模式、发布清单和静态资源。CI 在发布前验证失效链接、合约地址不一致、代币经济求和、版本号和状态标签。

V4 增加了机器可验证的发布控制：每次文档发布都会生成一个清单，包含白皮书、注册表和模式的 SHA-256 哈希；如果代币经济总和不等于 100%、规范地址在页面之间不一致、VERIFIED-PUBLIC 声明缺少证据 URL，或已弃用地址未带弃用标签出现，CI 将拒绝发布。

自托管文档包应包括 /.well-known/security.txt、/.well-known/ionon.json、用于身份/策略/订单/证据的 JSON Schema 文件、公共接口发布时的 OpenAPI 合约、签名的发布说明、sitemap/robots，以及本地搜索索引，使文档可以在不依赖第三方文档 SaaS 的情况下运行。

公开文档应展示：

• 概念；
• 架构；
• 代理身份；
• 策略引擎；
• 钱包与资金路由器；
• MCP 和 A2A 集成；
• IONON Network；
• 代币经济；
• Genesis CCA；
• 治理；
• 安全；
• 开发者 API；
• 规范合约；
• 信任中心；
• 发布说明；
• 风险披露。

参考文献

白皮书参考文献