mimofan v0.0.17 发布 —— 一个原生支持 MiMo 与 DeepSeek 的 Rust 终端 AI 编程助手。

本次发布亮点：

• 安全审计关卡：AUTO 权限分类器（失败即关闭）、提示词注入扫描、技能供应链溯源、命令注入模糊测试
• 记忆功能：混合检索（RRF + hybrid_bm25）、跨会话推理、用户画像、LongMemEval 评估框架
• 协议支持：浏览器自动化、反向 MCP 服务器、ACP 能力矩阵
• 子智能体：DAG 任务编排、多目标 GoalQueue、跨轮次持久化循环守卫
• 研究编排：/evolve /repro /artifact /reviewer + GitHub Co-Authored-By

764 个单元测试通过，零警告的发布构建。

XiaomingX/mimofan

源码：https://github.com/XiaomingX/mimofan

米谋 (mimofan)

终端 AI 编程助手 —— 与你并肩,谋定而后动

基于 Rust 实现,原生支持小米 MiMo 模型,兼容 DeepSeek、OpenAI、通义千问等主流大模型。

Rust (https://www.rust-lang.org/) 平台文档 支持 MCP

米谋是什么

米谋(mimofan)是一个跑在终端里的 AI 编程搭档:你用自然语言下指令,它调用大模型思考,再用工具(读文件、改代码、跑命令)把活干完,工作流是「模型决策 → 工具执行 → 结果回灌 → 再决策」的闭环。

基于 Rust 实现,原生支持小米 MiMo,兼容 DeepSeek、OpenAI、通义千问等主流大模型。对标 Claude Code / OpenCode,差异在:本地优先 · MIT 协议 · 默认 MiMo。

它能做什么:

• 读懂项目结构,理解模块关系
• 生成符合规范的代码与测试
• 写完自动跑验证,红了就修
• 给报错信息就能定位到具体代码行
• 不弹窗不打扰,只在需要你决策时才开口(每次危险操作都会先问「可以吗?」)
• Spec Freeze 冻结计划,防止 Agent 偏离
• Issue Monitor 监控 GitHub Issue,自动关联 PR

米谋不是一个替你写代码的工具,而是一个帮你把代码写好的搭档。谋定而后动,知止而有得。

30 秒极速上手(零配置开箱即用)

1. 安装

# 使用 cargo 编译安装
cargo install --path crates/tui --locked

# 或下载预编译二进制
# https://github.com/XiaomingX/mimofan/releases

2. 零配置直接启动

无需手动创建配置文件!直接设置环境变量即可一键启动:

# 使用 小米 MiMo (默认)
export XIAOMI_MIMO_API_KEY="你的_XIAOMI_MIMO_API_KEY"
mimofan

# DeepSeek / OpenAI / 通义千问 等非内置服务商,请使用自定义 provider:
# 在 ~/.mimofan/config.toml 中按下方「配置示例」填写后运行 mimofan

提示:若未设置环境变量,首次运行 mimofan 会自动启动交互式配置向导帮你完成配置。

常用调用方式

# 启动全屏 TUI 交互界面
mimofan

# 单次指令模式(不进入 TUI)
mimofan exec "帮我写一个正则表达式匹配邮箱"

# 自动运行系统诊断
mimofan doctor

高频实用场景

场景一:快速修复 Bug

> 这个函数报错了 "index out of bounds",帮我修复并添加测试

# AI 会自动:
# 1. 分析错误原因
# 2. 修复代码
# 3. 编写测试用例
# 4. 运行 cargo test 验证

场景二:代码重构

> 把这个 500 行的函数拆分成多个小函数,保持功能不变

# AI 会自动:
# 1. 分析函数逻辑
# 2. 提取公共部分
# 3. 重构代码结构
# 4. 运行测试确保无回归

场景三:生成单元测试

> 给 src/auth.rs 里的 login 函数写完整的单元测试,覆盖正常和异常情况

# AI 会自动:
# 1. 读取函数签名和逻辑
# 2. 生成测试用例
# 3. 添加 mock 和 fixture
# 4. 运行测试验证

场景四:代码审查

> 帮我审查这个 PR 的代码,重点关注安全性和性能问题

# AI 会自动:
# 1. 读取 diff 变更
# 2. 分析潜在问题
# 3. 给出改进建议

场景五:文档生成

> 给这个模块写 README 文档,包括使用示例和 API 说明

# AI 会自动:
# 1. 分析模块结构
# 2. 提取公开 API
# 3. 生成文档和示例

核心能力

AI 编程助手

• 自动读取代码上下文,理解项目结构
• 生成符合规范的代码和测试
• 自动运行验证命令确保正确性

多模型支持

模式只有三种:openai-compatible / anthropic-compatible / gemini-compatible(kebab-case 规范名,无历史别名)。

操作模式

• 交互模式: 全屏 TUI 终端界面
• 单次模式: mimofan exec 命令行调用
• Plan 模式: 先列计划,审核后再执行
• YOLO 模式: 全自动执行(信任仓库时使用)

TUI 操作指南

基础按键

安全授权

AI 执行命令时会弹出授权窗口:

• y: 允许执行
• n: 拒绝操作
• a: 本次会话全部允许

斜杠指令大全

基础指令

模式切换

代码管理

任务管理

上下文管理

/compact 后面可以直接跟自然语言,指定这次摘要要重点保留什么:

/compact 重点保留认证重构的决策,测试调试过程可以省略

如果每次压缩都想强调同样的重点,把它写进项目根目录 AGENTS.md 的 # Compact Instructions 小节,手动压缩与自动压缩都会遵循:

# Compact Instructions

保留数据库迁移相关的改动与报错原文,探索性的调试过程可以省略。

命令行上临时给出的指令,优先级高于 AGENTS.md 中的常驻配置。两种方式都是 追加约束:文件路径、报错、待办等连续性信息始终会被保留,不会因为自定义 指令而丢失。

其他

进阶功能

Spec Freeze(计划冻结)

防止 Agent 偏离既定计划:

> /freeze 只修复登录页面的 bug,不要改动其他模块

# Agent 将严格在冻结的范围内工作
# 任何越界操作都需要你确认

Issue Monitor(Issue 监控)

监控 GitHub Issue 并自动关联 PR:

> /monitor create fix-auth --issues 123,456 --repo owner/repo

# 监控指定 Issue 的状态变化
# 自动创建或更新关联的 PR

子智能体(Sub-agents)

并行处理复杂任务:

> 帮我同时重构 auth 模块和 database 模块

# AI 会启动多个子智能体并行工作
# 每个子智能体在独立的 worktree 中操作

配置示例

Anthropic (Messages API)

使用 Anthropic 原生 Messages API 协议,需要将 base_url 设置为以 /anthropic 结尾:

provider = "anthropic-compatible"
api_key = "你的_ANTHROPIC_API_KEY"
base_url = "https://api.xiaomimimo.com/anthropic"
default_text_model = "mimo-v2.5"

重要: base_url 必须以 /anthropic 结尾,mimofan 会自动检测并使用 Anthropic Messages API 协议。 如果 base_url 不以 /anthropic 结尾,将使用 OpenAI Chat Completions 协议。

OpenAI Chat Completions (MiMo 模型)

MiMo 模型兼容 OpenAI Chat Completions 接口:

provider = "openai-compatible"
api_key = "你的_XIAOMI_MIMO_API_KEY"
base_url = "https://api.xiaomimimo.com/v1"
default_text_model = "mimo-v2.5"

DeepSeek

provider = "openai-compatible"
api_key = "你的_DEEPSEEK_API_KEY"
base_url = "https://api.deepseek.com/v1"
default_text_model = "deepseek-chat"

通义千问

provider = "openai-compatible"
api_key = "你的_DASHSCOPE_API_KEY"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
default_text_model = "qwen-max"

常见问题

Q: 启动时提示 Config not found 或连接超时?

检查 ~/.mimofan/config.toml 文件路径和 api_key 是否正确。运行 mimofan doctor 自动诊断。

Q: 每次执行命令都要按 y 确认,如何关闭?

在配置中添加 approval_policy = "yolo" 开启全自动模式(仅在信任的仓库中使用)。

Q: 能让 AI 读取本地文档吗?

直接告诉 AI:“读取根目录下的 ARCHITECTURE.md 并回答我的问题”。

Q: 如何切换模型?

使用 /model 命令:/model deepseek-chat 或 /model gpt-4。

Q: 如何防止 AI 偏离计划?

使用 /freeze 命令冻结当前计划:/freeze 只修复这个 bug。

文档

• ARCHITECTURE.md – 系统架构设计
• docs/MCP.md – MCP 扩展服务
• docs/SUBAGENTS.md – 子智能体指南
• docs/MODES.md – 操作模式详解
• CLAUDE.md – 开发者指南

贡献

欢迎贡献代码!请查看 CONTRIBUTING.md 了解详情。

开源许可

本项目遵循 MIT License 开源协议。