在日常开发中，你是否遇到过这样的困境：API接口已经更新，但文档却迟迟没有同步，导致团队成员间的沟通成本急剧攀升。MiMo Code正是为解决这一痛点而设计——它能够自动解析项目中的代码注释、路由配置以及OpenAPI文件，只需执行一条 /doc 命令，即可生成一份结构完整的API手册，包含概览、认证方式、错误码表以及每个接口的详细说明。更关键的是，它支持自定义风格、增量更新，并能与Git版本归档无缝衔接。

那么，MiMo Code是如何实现这一功能的呢？核心在于它能深入理解你的项目结构，自动识别接口定义——无论这些定义来自OpenAPI/Swagger注释、路由声明还是控制器逻辑。内置的文档生成Agent会主动编排这些信息，你完全无需手动书写Markdown，也不依赖任何外部工具链。

确保项目包含可识别的API定义

MiMo Code主要从三类来源提取接口信息：

• 代码注释：支持Swagger/OpenAPI 3.x风格的注释（例如Java中的@Api、@ApiOperation；TypeScript/Node.js中通过JSDoc配合@openapi插件的注释）。
• 路由配置：自动扫描Express、NestJS、Spring Boot等主流框架的路由注册逻辑（例如app.get('/users')或@Get('users')）。
• OpenAPI文件：如果项目根目录下存在openapi.yaml或swagger.json文件，MiMo Code会优先加载并校验其完整性。

使用 /doc 命令触发文档生成

在MiMo Code的终端界面（运行 mimo 进入）中，直接输入以下命令：

/doc generate --format=markdown --output=docs/api.md

它会自动完成以下一系列工作：

• 分析当前Git仓库的结构，精准定位后端服务模块。
• 提取所有HTTP方法、路径、请求参数（包括query、body、path参数）、响应状态码以及示例数据。
• 补全描述信息——基于函数名、注释上下文和类型定义进行智能推理。
• 按照RESTful规范对接口进行分组（例如“用户管理”“订单操作”），并添加目录和跳转锚点。

生成的 docs/api.md 默认包含：概述、认证方式、错误码表以及每个接口的详情（含curl示例和响应体Schema）。

定制手册风格与合规要求

如果你的团队拥有内部文档规范——比如必须包含“权限说明”“幂等性标识”“变更日志”——则可以在项目根目录放置一个 .mimo-docrc 配置文件：

{
  "title": "XX 系统 v2.3 API 手册",
  "includeAuthSection": true,
  "requireIdempotencyTag": true,
  "addChangelog": true,
  "responseExamples": {
    "application/json": true,
    "text/plain": false
  }
}

下次执行 /doc 命令时，MiMo Code会严格按照这个规则进行渲染，确保不会遗漏任何合规字段。

同步更新与版本归档

API手册并非一次性产物。MiMo Code提供了以下支持：

• 增量更新：当你修改某个接口后，运行 /doc update 只重新生成变更的部分，保留你之前手写补充的内容。
• Git集成：每次执行 /doc generate 都会自动提交到 docs/ 目录，并打上tag（例如 api-v1.2.0）。
• Web预览：运行 mimo web，点击“Docs”面板即可实时查看渲染效果，同时支持搜索和深链接。