iHuman OC2API Spec 将 protobuf 生成的 Objective-C 类,尤其是 ,转换为标准 API 字段路径文档,并交付 Markdown 与对应 HTML。 何时读取引用 - 需要字段路径、数组标注、枚举、通用数据结构展开规则时,读取 DATA SPEC.md。 - 需要 OC 属性到文档字段的映射细节时,读取 OC MAPPING.md。 - 需要生成完整 、目录锚点、OC 访问路径或保存路径时,读取 API DOC SPEC.md。 - 需要生成或优化 HTML 展示样式时,读取 HTML STYLE SPEC.md。 输入 - protobuf 生成的 Objective-C header: - Objective-C protobuf 类片段 - 包含 、 、 的 OC 代码 核心流程 1. 读取 OC header 或类定义。 2. 识别 、 和 。 3. 将 OC 属性名映射为标准 API 字段路径。 4. 识别以 结尾的数组属性,并补充 。 5. 对所有嵌套对象、数组和枚举应用 DATA SPEC.md。 6. 先生成 Markdown 字段表或完整 Markdown 文档;生成完整文档时按 API DOC SPEC.md 输出目录、枚举说明、HTTP 网关表、OC 访问路径、请求字段和响应字段。 7. 再将 Markdown 转换为同名…