iHuman Proto2API Spec 将 或 protobuf 接口定义转换为标准 API 字段路径文档，并先生成 Markdown，再转换出对应 HTML。 何时读取引用 - 需要字段路径、数组标注、枚举、通用数据结构展开规则时，读取 DATA SPEC.md。 - 需要生成完整 、目录锚点、接口模板或保存路径时，读取 API DOC SPEC.md。 输入 - 原始 文件 - protobuf message 片段 - 能还原 Req/Resp message 的 protobuf 接口定义 核心流程 1. 读取 proto/protobuf 定义。 2. 识别接口消息，尤其是 和 。 3. 将请求字段按 proto 字段结构展开。 4. 将响应字段按 、 、 三层结构展开。 5. 对所有嵌套对象、数组和枚举应用 DATA SPEC.md。 6. 按 API DOC SPEC.md 输出 Markdown 表格或完整 API 文档。 7. 以 Markdown 为源文档生成对应 HTML，HTML 结构和内容应跟随 Markdown 文档。 HTML 生成规则 - 始终先生成 Markdown，再由 Markdown 转换 HTML。 - 优先使用 将 Markdown 转换为 HTML；如果当前项目已有 依赖或相关脚本，直接复用。 - 找不到 时，再使用当前项目或系统…