最新小米_MiMo_Code开源AI编程助手安装教程(附带图文测评)

MiMo Code：将编程 Agent 扩展到长程任务

2026 年 6 月 10 日 · 小米 MiMo 团队发布并开源 · MIT 协议

一、MiMo Code 是什么？

MiMo Code 是小米 MiMo 团队基于 OpenCode 构建的终端 AI 编程 Agent，MIT 协议开源。它针对长程自动化编程任务设计，核心关注点：如何在几十甚至上百步的持续执行中保持决策质量和状态连续性。

核心设计围绕三个主题展开：

主题要解决的问题关键机制**计算 (Compute)长程任务中每一步错误累积放大Max Mode、Goal 停止条件、Dynamic Workflow记忆 (Memory)上下文窗口有界，会话无法无限延伸Checkpoint/Rebuild、Writer subagent、四层记忆体系进化 (Evolution)**跨 session 经验无法积累Dream、Distill、项目记忆

技术栈： Bun + TypeScript + Effect + SolidJS（TUI）+ Tauri（桌面端）

二、核心技术设计

一个编程 Agent 的基本结构是将语言模型放入运行时中循环调用：模型负责推理和决策，运行时负责管理工具、持久化状态、组装每一轮输入。模型本身是无状态的——每次调用从空白开始，所有连续性由运行时提供。

短任务（10 轮以内）工作良好：完整对话历史传给模型即可。但随着任务轮次增加，两个问题显现：计算量放大和上下文窗口耗尽。

2.1 计算：扩展单轮推理的质量

Max Mode：多采样提高决策质量

在每个决策点生成多个候选方案，通过 majority voting 和 best-of-N self-verification 选择最优路径。在 SWE-Bench Pro 上，Max Mode 相比单次采样提升 10-20%，代价约 4-5 倍 token 消耗。

Goal：独立裁判防过早终止

长任务中常见失败模式：Agent 看到已有进展就提前宣称"完成"。MiMo Code 的解决方式是用户设定自然语言停止条件（如"所有测试通过且代码已提交"），Agent 每次尝试终止时，系统用独立模型调用审查完整对话历史，判断条件是否真正满足。

验证者不参与实际工作，对 Agent 已完成部分无认同偏差。它每次获得与 Agent 完全相同的上下文（含工具实际输出）。如果未满足，将具体差距反馈给 Agent 并让它继续；如果确认无法完成，则判定为不可能。

Dynamic Workflow：编排并行子 Agent

当任务规模大到需要协调几十个并行工作单元时，逐轮工具调用不够用。Dynamic Workflow 把编排逻辑从 prompt 变成代码——主 Agent 生成 JavaScript 脚本，在隔离沙箱中确定性执行。脚本通过 agent() 派出子 Agent，通过 barrier() 等待并行任务完成。循环不会提前退出，barrier 不会漏掉子 Agent。模型的判断力只用在理解代码和生成代码上，不浪费在流程控制。

2.2 记忆：维持多轮任务的状态连续性

扩展单轮计算量可以降低每一步错误率，但不解决核心问题：上下文终会耗尽。关键设计：让一个逻辑会话无限延伸，而每个物理窗口保持有界。

Checkpoint & Rebuild

运行时在到达上限之前的几个固定位置介入，称为 checkpoint。每个 checkpoint 处，运行时派出独立的 writer subagent：读取迄今对话，将结构化状态写入磁盘。主 Agent 继续工作，writer 并发执行，互不干扰。

当窗口接近真正上限，运行时执行一次 rebuild：切断当前窗口，开启新窗口，用已持久化的文件作为种子重建上下文。主 Agent 在新窗口中醒来，状态已摆在面前，继续工作。从模型视角看，对话从未中断。

Checkpoint 在远低于上限处触发——大致在已配置预算的 20%、45%、70%。每一次触发都是对前一次的增量更新，没有任何一次是孤注一掷的总结。最末尾接近上限的那次 rebuild，不是一次仓促的压缩，而是将一路记下来的结构化记录变现的时刻。

Writer：独立于主 Agent 的提取者

让主 Agent 自己维护笔记在长任务面前撑不住——要求正在调棘手 bug 的模型同时维护结构化日志，往往在两件事上各做差一件。

主 Agent 不维护自己的记忆。 提取完全移出主循环，由运行时触发，由独立的 writer subagent 完成——它不与主 Agent 共享注意力或 token 预算。

Writer 写入一份固定结构的 checkpoint 文件，包含 11 个字段：

字段说明当前意图Agent 正在做什么下一步动作计划接下来做什么工作约束当前遵循的限制条件任务树T1, T1.1, T1.2… 层级任务状态当前工作正在处理的文件/代码涉及文件本轮涉及的文件列表跨任务发现与当前任务无关但值得记录的发现错误与修复已遇到的错误和修复方式运行时状态环境状态（分支、测试结果等）设计决策架构选择的理由杂项笔记其他需要记录的信息

对每个结构化文件，只有恰好一个 actor 被允许写入——single-writer 是防止并发写入产生不一致状态的最简不变量。

四层记忆体系

Writer 维护一个分层的记忆体系，每一层有不同的生命周期：

层级文件生命周期内容Session 记忆checkpoint.md当前逻辑会话会话完整工作状态快照Project 记忆MEMORY.md跨 session架构决定、规则、技术事实Scratchpadnotes.md会话级自由写入主 Agent 唯一写入通道，writer 消费后清空Global 记忆SQLite 轨迹永久存档每条消息、每次工具调用原文存储

主 Agent 对结构化文件只有读权限，但有一个例外：notes.md，一个会话级的自由格式 scratchpad。主 Agent 可随时 append 零散发现，writer 在每次 checkpoint 时读取它、将内容路由到对应结构化字段，然后清空。

Rebuild 时，持久化文件被组装为分层 prompt 注入新窗口，每段有独立 token 上限。大致顺序为：任务清单 → session checkpoint → 最近用户消息逐字切片 → 项目记忆 → 全局记忆索引 → notes → 文件路径索引 → tail reminder。即使每段都顶满上限，注入总量控制在 约 65K token 以内。Agent 从这些信息中恢复状态后直接继续工作，不需要重新确认目标，不需要重读已处理的文件。

2.3 进化：从经验中持续改进

用户与同一项目交互几十次甚至上百次。如果每次 session 结束后所有经验都丢失，Agent 永远无法从过去的工作中积累。

项目记忆

MiMo Code 维护一个 Markdown 格式的项目级记忆文件（MEMORY.md），持久保存跨 session 的知识：项目背景、用户明确要求的规则、架构决定及其理由、反复验证过的技术事实。

选择文件而非纯向量数据库，核心原因是可审查性——记忆一旦影响 Agent 行为，用户需要能看到、能删除记错的条目、能修改过时的知识。文件可以被标准读写工具直接操作，全文索引在文件之上提供快速检索。

Dream：知识收敛

每 7 天自动触发

由独立 Agent 读取历史 session 对话和现有记忆文件，执行 合并、去重、验证路径有效性、压缩。将分散记忆收敛为一份紧凑的当前状态，并更新全局记忆。实现"越用越顺手、越用越懂你"。

Distill：流程固化

每 30 天自动触发

同样由独立 Agent 读取历史 session，但关注点不是知识而是流程——识别反复出现的工作模式，将其固化为可复用的 Skill、CLI 命令、自定义 Agent 或 SOP 文档。

三、安装与配置

3.1 环境要求

• 一款现代终端模拟器（推荐：WezTerm / Alacritty / Ghostty / Kitty，macOS 用户推荐 iTerm 或 VSCode Terminal）+ LLM 提供商的 API 密钥

3.2 安装方式

Mac / Linux（推荐）：

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

Windows / npm：

npm install -g @mimo-ai/cli

安装脚本自动检测操作系统和 CPU 架构（x64 / arm64），下载对应预编译二进制。

3.3 模型提供商

MiMo Code 通过 AI SDK 和 Models.dev 支持 75+ LLM 提供商，并支持运行本地模型：

• MiMo Token Plan
  （推荐新手）— 小米官方 API，中文友好+ MiMo Auto（限时免费）— 匿名通道，零配置即用，性能对标 Claude Sonnet 4.6+ OpenAI、Anthropic、Google、DeepSeek、Kimi、GLM 等+ 任意 OpenAI 兼容 API

在 TUI 中运行 /connect 命令，选择提供商并粘贴 API 密钥即可。

3.4 首次启动

cd <项目目录>mimo

运行以下命令初始化项目上下文：

/init

MiMo Code 会分析项目结构并在根目录创建 AGENTS.md 文件。建议将此文件提交到 Git，帮助 AI 理解项目结构和编码规范。

四、工作模式

MiMo Code 自带三种内置模式（主 Agent），通过 Tab 键 切换：

4.1 Build 模式（默认）

拥有完整工具权限的标准开发模式：文件读写、代码编辑、Shell 命令执行、Git 操作。日常开发的主要工作模式。

4.2 Plan 模式

受限的只读分析模式，以下工具被禁用：

• write
   — 不能创建新文件+ edit — 不能修改现有文件+ patch — 不能应用补丁+ bash — 不能执行 Shell 命令

适用于：分析代码架构、设计方案、评审改动可行性，在动手前先对齐思路。

4.3 Compose 模式

通过精心策划的内置技能集合来编排任务执行。Compose 不依赖单一庞大 prompt，而是查阅一个包含 13 个聚焦技能的库，为工作流每一步选择合适的技能。

内置技能分类：

类别技能用途测试TDD测试驱动开发工作流调试Debug系统化调试方法论验证Verify完成前验证协作Brainstorm、Plan、Execute、Dispatch、Review、Receive头脑风暴、计划、执行、并行派发、审查反馈GitWorktree、FinishGit worktree 管理、分支收尾元开发Write Skill编写新技能

启用 Compose：Tab 键循环切换到 Compose，或通过 use compose 在消息中调用。技能包首次使用时解压到 .mimocode/skills/，各版本间保持更新。

五、核心操作

5.1 理解代码

让 MiMo Code 讲解代码库：

@packages/functions/src/api/index.tsHow is authentication handled in this file?

使用 @ 键可模糊搜索项目中的文件。

5.2 制定计划

Tab 切换到 Plan 模式，描述需求：

When a user deletes a note, flag it as deleted in the database.Then show all recently deleted notes with undelete/permanent-delete options.

可拖放图片到终端提供 UI 参考。对计划满意后 Tab 切回 Build 模式，说 “Go ahead and make the changes” 开始实施。

5.3 直接修改

简单修改无需先制定计划：

@packages/functions/src/settings.tsAdd authentication to the /settings route, following the pattern in @notes.ts

5.4 撤销与重做

• /undo
  （ctrl+x u）— 撤销最后一条消息及所有文件更改（需要 Git 仓库）+ /redo（ctrl+x r）— 重做之前撤销的操作+ 可多次 /undo 回退多步

六、会话管理

6.1 会话存储

每次对话被持久化为一个会话，数据保存在 MIMOCODE_HOME/├── config/    ← 全局配置文件├── data/      ← auth.json、会话数据库├── state/└── cache/

mimo              # 创建新会话mimo --continue   # 继续上一个会话mimo --session <id>  # 恢复指定会话

{  "$schema": "https://mimo.xiaomi.com//config.json",  "permission": {    "*": "ask",    "bash": "allow",    "edit": "deny"  }}

{  "permission": {    "bash": {      "*": "ask",      "git *": "allow",      "npm *": "allow"    }  }}

{  "mcp": {    "my-server": {      "type": "local",      "command": ["npx", "-y", "my-mcp-command"],      "enabled": true,      "environment": {        "API_KEY": "xxx"      }    }  }}