用途:在设计或审查 protobuf API 时应用随附的 Google AIP(API Improvement Proposals)。适合在新增或变更 .proto 资源、RPC、标准字段等场景中使用,帮助把 AIP 规范落实到接口设计与评审中。
主要能力:内置可检索的 AIP 目录与完整文档,支持按概念定位相关条款,并在结果中引用 AIP 编号。
使用方式:先查看请求与相关 API 定义;在 references/catalog.md 中按涉及的概念检索,尽量用 rg 等文本搜索而非加载整个目录;从 references/aips/{NUMBER}.md 读取匹配文档(四位数字,如 0132.md);应用完整 AIP 文本而非目录预览,并结合各 AIP 的状态区分规范性指引与示例;当既有 API 先例与较新指引冲突时,先读 AIP-0200 再建议偏离;在结果中引用 AIP 编号,并区分必须变更、建议变更与有意偏离。
资源:references/catalog.md 为可检索索引,含状态、标题与文字预览;references/aips/ 存放完整本地 AIP 文档;references/provenance.json 记录上游版本、转换与许可信息。
限制:资料未提供除上述工作流外的更多功能、平台、收费或价格信息;具体 AIP 条款内容需以随附文档为准。