【黑湖智造3.0 open接口平台 AI 助手指南】 先读取总索引 /static/api-docs-md/api-index.json，递归搜索 categories 和 children 中的 apis。 /document/api 对应 apiEdition=1，/document/api2 对应 apiEdition=2。按用户指定的体系和接口名称匹配，再读取条目的 markdownPath。 2.0 独立索引也可从 /static/api-docs-md/v2/api-index.json 读取，其详情在 /static/api-docs-md/v2/{接口ID}.md。 若详情返回 HTML 或索引缺少接口，表示文档产物不可用，不能据此认定接口不存在或 ID 过期。