API 文档生成，长期以来都是开发流程中最容易被搁置的环节。多数开发者并非不会撰写文档，而是不愿投入时间去维护那些“心里明白即可”的注释。不过，借助 MiMo Code，这一难题迎刃而解——这是一款完全运行在本地环境的 AI 文档生成工具，专为 Spring Boot、FastAPI、Express 等主流开发框架量身打造。其核心理念极为直接：通过 AST 解析技术，自动从你的 Controller 代码中提取信息，并生成带有中文说明的 API 文档。更值得一提的是，它具备记忆能力、支持增量更新、能与 Git 钩子无缝集成，甚至能在不同会话间保持统一的文档风格。
简而言之，MiMo Code 能够帮助开发者彻底告别“等代码写完再补文档”的传统工作流。当你刚完成接口编写，对应的文档便已自动生成。无需手动上传代码，不依赖任何外部云服务，所有操作均在本地环境中完成。更有价值的是，它并非一次性的工具——它能记住你的偏好设置，复用之前的逻辑，当下次修改接口时，它会智能地只更新发生变化的部分。
直接从 Controller 代码生成带中文说明的文档
你可能会好奇，它的工作原理究竟是怎样的？MiMo Code 内置了对 Spring Boot、FastAPI、Express 等主流开发框架的 AST 解析能力。你只需将光标停留在某个 @GetMapping 或 @app.post 方法上，按下快捷键 Ctrl+Shift+D（macOS 上是 Cmd+Shift+D），它便会自动执行一系列操作：
- 提取路径、HTTP 方法、参数来源（
@RequestParam/@PathVariable/ body） - 识别 DTO 类型，并递归解析字段名称与数据类型（包括泛型嵌套这类较为复杂的场景）
- 调用本机运行的 Qwen3-4B-Instruct 模型，为每个字段生成自然流畅的中文说明（例如
orderStatus会被解释为“订单当前状态，取值：created/paid/shipped/cancelled”） - 自动生成请求示例 JSON 和成功响应示例，并且这些示例值均为合理的默认数值，绝非随意填充
自动补全和更新已有注释
更令人省心的是，它不仅能够处理“新编写的接口”，更擅长修复“遗留的老项目”。当你后续修改了某个接口的参数或返回值结构时，MiMo Code 会在保存文件时自动触发轻量级的差异分析：
- 首先对比当前代码与上次生成的 JSDoc 或 Swagger 注解内容之间的差异
- 精确定位变更位置（例如你新增了一个
@RequestBody OrderCreateReq） - 然后仅重写受影响的参数说明段落，同时保留你手动添加的那些业务逻辑备注
- 最后，它会自动将更新记录追加到
docs/CHANGELOG-API.md文件中
对接 Git 提交流程，文档随代码一同上线
还有一个极为实用的设计——它与 Git 流程实现了深度绑定。你只需在项目根目录运行 mimo init --git-hook，它便会自动配置一个 pre-commit 钩子：
- 每次 git add 涉及
controller/或routes/目录下的文件时，它都会自动触发本地文档扫描 - 增量生成 Markdown 片段，并将其合并到
docs/api-reference.md文件中 - 最精妙的是，如果它检测到 breaking change（比如你删除了一个必填参数），它会直接中断提交操作，并给出明确的提示：“⚠️ 删除了 /api/users 的 name 字段，需同步更新前端调用方”
跨会话记忆让文档风格保持统一
这一点尤其值得单独拿出来强调。普通工具每次使用时都需要重新交代一遍背景信息，但 MiMo Code 截然不同。它将你的项目习惯记录在 SQLite FTS5 数据库中，这意味着：
- 第一次生成文档时你选择了“用‘用户’而非‘user’作为中文主语”，此后所有接口的说明都会自动沿用这一习惯
- 如果你曾经给
page参数标注过“从 1 开始计数”，那么之后所有涉及分页的接口都会自动附带这条说明 - 如果团队约定错误码
40001表示“参数校验失败”，它也会主动在响应示例的 error 字段里体现出来