MiMoCode（小米 MiMo Code）快速入门使用教程

1. MiMoCode 特点

MiMoCode 是小米 MiMo 团队基于 OpenCode 开发的终端原生 AI 编程助手（MIT 开源协议），专为长程、复杂编码任务设计，重点解决传统 Agent 在长对话中“上下文丢失”和“决策漂移”的问题。

主要特点：

• 持久化跨会话记忆系统（核心创新）：基于 SQLite FTS5 实现三重记忆（项目记忆、会话快照、临时笔记），支持上百轮对话不丢失关键信息。自动沉淀知识到 MEMORY.md，下次打开项目即继续。
• 无限上下文 + 智能管理：结合 Checkpoint 机制和上下文压缩，长任务状态连续。
• 多 Agent 协同 + Compose 模式：独创 Compose 工作流，自动编排规划、编码、TDD 测试、Code Review、验证等完整生命周期。支持 Build（执行）、Plan（分析）、Compose（编排）模式切换。
• 自我进化能力：/dream 自动提取知识、清理冗余；/distill 将重复流程打包成可复用 Skill/Subagent，实现“越用越聪明”。
• 终端原生 + 多模态：纯 CLI 轻量运行，全中文界面，支持图片输入、语音输入（MiMo 登录用户）。
• 强大工具集成：读写代码、执行 Shell、Git 管理、LSP、MCP 插件等。
• 模型灵活：内置限时免费 MiMo V2.5 多模态模型，支持 75+ 提供商（DeepSeek、Kimi、Claude 等），MiMo 模型专项优化。
• 其他亮点：/goal 机制防止过早停止；Max Mode 并行采样提升决策质量；支持 Web UI；轻量安装，开箱即用。

这些特点让 MiMoCode 在长程任务（如大型重构、完整功能开发）上表现突出，优于部分同类工具。

2. 安装

macOS/Linux：

curl -fsSL https://mimo.xiaomi.com/install | bash

Windows（Node.js 18+）：

npm install -g @mimo-ai/cli

验证：mimo --version

3. 配置模型

• MiMo Auto：免费开箱即用。
• 支持小米 MiMo 平台 OAuth、一键导入 Claude 等。
• 自定义：mimo providers login。

配置文件：~/.config/mimocode/mimocode.json 或项目 .mimocode/ 下。

4. 快速启动

cd your-project
mimo

TUI 操作：

• Enter 发送，Shift+Enter 换行。
• Tab 切换智能体模式（Build/Plan/Compose）。
• @文件 引用，!命令 执行 Shell，/ 斜杠命令。

5. 初始化项目

输入 /init 生成 AGENTS.md，提升后续理解质量。

6. 核心功能使用

• 持久记忆：自动维护 MEMORY.md、checkpoint.md 等。
• 自我优化：定期 /dream 和 /distill。
• 任务目标：/goal "具体目标" 设置停止条件。
• Compose 模式：适合端到端开发，从规格到交付全自动。

7. 高级特性

• Max Mode：并行采样，提升单步决策。
• 语音输入：/voice（需登录）。
• 自定义扩展：Skills、Plugins、Themes。
• Web UI：mimo web。

8. 最佳实践

• 大项目先 Plan/Compose 规划，再 Build 执行。
• 重要变更前 Git commit。
• 定期自我进化保持记忆清洁。

资源：

• GitHub：https://github.com/XiaomiMiMo/MiMo-Code
• 官网文档：https://mimo.xiaomi.com/zh/mimocode

这个版本已补充详细特点描述。如果需要进一步调整某个部分（如添加示例、截图描述或特定功能深入），随时告诉我！