ProfileClaw
公开 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 给工具使用。

认证

请求头、scope 与失败处理姿态。

错误

机器可读的错误类型与恢复策略。

Webhooks

增量同步与投递校验。