接入 MiMo Code
MiMo Code 是小米推出的 AI 编程助手。
建议先执行 mimo upgrade 升级到最新版本,再安装插件。
方式一 · 让 MiMo Code 自己配置(推荐)
把下面的提示复制给 MiMo Code:
text
帮我配置知言家 AI Coding 伴侣的 MiMo Code 插件。读取 https://zyhome.run/docs/integrations/mimo-code.txt 并按步骤执行。保留已有配置,发现冲突时先问我,不要创建重复插件。完成后告诉我改了什么、是否需要重启 MiMo Code。方式二 · 手动安装
MiMo Code 通过全局 JS 插件同步任务状态。
1. 检查重复插件
检查全局配置目录(默认 %USERPROFILE%\.config\mimocode;设置 MIMOCODE_HOME 时为其 config 目录;以存在 mimocode.jsonc / mimocode.json 的目录为准)下的 plugin 与 plugins 目录、当前项目的 .mimocode\plugin 与 .mimocode\plugins,以及 mimocode.json / mimocode.jsonc 的 plugin 数组。发现同名插件时先保留现状,只启用一份。
2. 下载插件
在 PowerShell 中执行:
powershell
# 确定全局配置目录:MIMOCODE_HOME 优先,否则 XDG(~/.config/mimocode),以存在 mimocode.json(c) 为准
$Candidates = @()
if ($env:MIMOCODE_HOME) { $Candidates += (Join-Path $env:MIMOCODE_HOME 'config') }
$Xdg = if ($env:XDG_CONFIG_HOME) { Join-Path $env:XDG_CONFIG_HOME 'mimocode' } else { Join-Path $env:USERPROFILE '.config\mimocode' }
$Candidates += $Xdg
$ConfigDir = $Candidates | Where-Object {
(Test-Path (Join-Path $_ 'mimocode.jsonc')) -or (Test-Path (Join-Path $_ 'mimocode.json'))
} | Select-Object -First 1
if (-not $ConfigDir) {
Write-Host '未找到 MiMo Code 全局配置(mimocode.jsonc / mimocode.json)。请先运行一次 MiMo Code 再重试,或手动设置 $ConfigDir。'
exit 1
}
Write-Host "全局配置目录: $ConfigDir"
$PluginDir = Join-Path $ConfigDir 'plugins'
$PluginPath = Join-Path $PluginDir 'mimo-code-plugin.js'
New-Item -ItemType Directory -Path $PluginDir -Force | Out-Null
Invoke-WebRequest `
-Uri 'https://zyhome.run/docs/integrations/mimo-code-plugin.js' `
-OutFile $PluginPath
Get-Item -LiteralPath $PluginPath | Select-Object FullName, Length
$Content = Get-Content -LiteralPath $PluginPath -Raw
if ($Content -notmatch "SOURCE = 'mimo-code'") {
Write-Host "下载内容异常(未包含 SOURCE = 'mimo-code'),请检查网络后重试。"
exit 1
}
if (Get-Command node -ErrorAction SilentlyContinue) {
node --check $PluginPath
} else {
Write-Host '未找到独立 Node.js,跳过 node --check;请在 MiMo Code 重启后检查插件加载日志。'
}MiMo Code 会自动发现全局 plugin / plugins 目录中的插件,正常情况下不需要修改 mimocode.json 或 mimocode.jsonc 的 plugin 数组。
3. 重启 MiMo Code
完全退出当前 MiMo Code 进程,再从原项目目录重新打开。插件在新的运行实例中加载。
验证
- 确认驱动托盘图标存在,设备已连接。
- 完全重启 MiMo Code,新建会话并发送一条普通消息。
- 确认驱动控制台出现来源为 mimo-code 的任务,设备进入处理中。
- 任务结束后,确认设备进入完成、失败或取消对应的灯语。
- 再用真实、低风险的授权或补充提问,确认设备进入等待状态,并在处理后恢复。
如果没有反应,按顺序排查:
- 确认驱动托盘在运行,且
%LOCALAPPDATA%\zy_home_vibe_coding_driver\service.json存在并包含baseUrl——插件靠它找到本地驱动服务,文件缺失或地址非法时事件会被静默丢弃。 - 确认插件在实际生效的全局配置目录(默认
%USERPROFILE%\.config\mimocode)下且只有一份,再看 MiMo Code 日志是否出现failed to load plugin。 - 设置环境变量
ZY_VIBE_MIMO_CODE_DEBUG=1后完全重启 MiMo Code,插件会在终端输出[zy-vibe-mimo-code ...]调试日志,事件投递失败时可见原因。 - 查看驱动日志
%LOCALAPPDATA%\zy_home_vibe_coding_driver\service.log是否出现"source":"mimo-code"的事件,确认事件是否送达驱动。
注意事项
- 全局目录、项目目录和
plugin数组中只保留一份知言家插件,避免同一任务重复出现。 - MiMo Code 会自动发现
plugin/plugins目录,通常不需要修改配置文件。 - 自动允许的操作不会进入等待授权状态;请用真实会弹出授权确认的操作验证。
- 回合被中断(如按 ESC)时灯语可能显示失败或取消,属预期行为,不代表插件故障。
- 修改插件后需要完全重启 MiMo Code。
速查
| 项目 | 路径或动作 |
|---|---|
| 插件来源 | mimo-code-plugin.js |
| 插件位置 | 全局配置目录(默认 %USERPROFILE%\.config\mimocode)下的 plugins\mimo-code-plugin.js |
| 更新插件 | 重新运行方式二脚本,自动覆盖为官网最新版 |
| 配置文件 | 不需要修改 |
| 完成后 | 完全退出并重新打开 MiMo Code |
