附录 H — 自托管文档架构

docs.ionon.ai 是安全和治理架构的一部分，而不仅仅是一个营销网站。

H.1 文档权威来源

推荐的仓库包含：

/docs
  /concepts
  /architecture
  /identity
  /policy
  /wallet
  /interoperability
  /network
  /economics
  /genesis
  /governance
  /security
  /developers
  /trust
/data
  canonical-registry.json
  tokenomics.json
  chain-status.json
  release-manifest.json
/schemas
  agent-birth-certificate.schema.json
  policy-passport.schema.json
  order.schema.json
  evidence.schema.json
/assets

如果代币经济加总不等于 1 亿、规范合约字符串在页面之间不一致、某个实时状态缺少证据链接、链接失效，或版本化模式发生变更而没有变更日志，CI 应使构建失败。

H.2 公开文档导航

外部体验应表现为高级 GitBook 级产品，同时完全处于 IONON 控制之下：

Overview → Concepts → Architecture → Agent Identity → Policy Engine → Wallet → MCP/A2A → Network → Tokenomics → Genesis → Governance → Security → Developer → Trust Center → Changelog.

构建应以静态优先，并可部署在 IONON 控制的 DNS/CDN 基础设施之后。搜索可以从内容语料库本地生成，因此文档不需要外部 SaaS 搜索提供商。

H.3 机器可读的信任注册表

文档包应发布 /data/canonical-registry.json，并从 ionon.ai/verify 公开相同内容。每个条目携带链、地址、状态、用途、证据 URL、激活区块/版本和弃用状态。

参考文献

白皮书参考文献