公开 Contract Surface
参考
这个页面是 private 产品仓库与未来 public 仓库之间的稳定交接点。它首先聚焦 contract 可见性:OpenAPI、路径覆盖、schema 数量,以及构建者最常需要的下一层 docs surface。
13
已文档化路径
由 OpenAPI 驱动、从 v1 contract layer 暴露出来的公开 API 操作数量。
76
Schema 数量
未来 SDK 与公开文档可以复用的响应与资源结构。
7
标签
贯穿 docs、reference 与未来 public repo 打包方式的顶层能力分组。
能力标签
这些标签映射了 contract taxonomy,它可以脱离私有的计费、CMS 与运营工具单独发布。
AuthContextProfileCareer GraphAssessmentsWebhooksHealth
哪些内容应该进入 public repo
发布 contract layer、reference、docs 与面向 SDK 的产物;把支付、积分、CMS、管理后台与模型策略继续留在私有仓库。
下一层 surface
保持 docs、reference 与 OpenAPI 对齐
未来的 public repo 应该维护一份 contract source,并提供多种阅读 surface:docs 给人看,reference 用于精确检查,OpenAPI 给工具使用。
