mimo-first-bridge

一个用于 DeepSeek Harness (DSH) 的 Cordis 插件：把编码/构建/调试/排查等实际工作优先派发给本机的 mimo CLI（Xiaomi MiMo Desktop / MiMoCode），DSH 全程掌控 mimo（--dangerously-skip-permissions，mimo 全程无提示），并在 mimo 流量受限 / 网络不通 / 认证失败 时弹窗让用户选择是否回退到 DSH 本地 API 配置；同时在会话标题栏提供一个 实时状态灯，清晰显示 mimo 是否正在工作。

同构姊妹项目：agy-first-bridge、codebuddy-first-bridge。

这是什么

mimo-first-bridge 是 DeepSeek Harness (DSH) 的 Cordis 插件。它注册模型工具（mimo_run、mimo_continue、mimo_status 与 mimo_settings），把真实工作转交给本机 mimo CLI（MiMoCode）或 Xiaomi MiMo 桌面客户端 执行，并注入 mimo-first 策略，让模型在各种模式下优先使用 mimo。

四种形态

| 形态 | 位置 | 能力 | 状态灯 | 持久 | | --- | --- | --- | --- | --- | | Agent preset | preset/mimo-first/ | mimo_run / mimo_continue / mimo_status / mimo_settings + MiMo-First 策略 + 回退弹窗（双后端） | ❌（依赖家级） | ✅ | | 家级状态灯 | home-plugin/mimo-indicator/ | 所有会话自动显示实时状态灯 | ✅ | ✅ | | 动态 Cordis 插件 | dynamic/ | mimo_run / mimo_continue / mimo_status + mimocode 后端（沙箱无 fs/import，mimo-desktop 返回 DESKTOP_UNSUPPORTED）+ 推入家级状态灯 | ✅ | ❌ 进程内 | | MCP server | mcp/ | 任意 MCP 宿主自动发现四工具（含 mimo_settings 与双后端） | ❌ | ✅（客户端配置） |

推荐组合：preset + 家级状态灯（dsh plugin --profile web add mimo-first-bridge 一次装齐）。

模型工具 + 设置

设置：提前预选派发目标（backend）

用户可在设置中提前选择调用 MiMoCode 还是 小米桌面客户端，无需每次指定：

| 预选途径 | 示例 | | --- | --- | | settings 文件（推荐给最终用户） | %APPDATA%\mimo-first-bridge\settings.json → { "backend": "mimocode" \| "mimo-desktop" } | | 工具 | mimo_settings({ backend: "mimo-desktop" }) 读/写默认值 | | 插件 config（cordis 行 / DSH 插件配置） | config.backend: mimocode \| mimo-desktop | | 环境变量 | MIMO_BRIDGE_BACKEND=mimo-desktop | | 单次覆盖 | mimo_run(..., backend: "mimocode") |

优先级：工具参数 > 插件 config > 环境变量 > settings 文件 > 默认 mimocode。

| backend | 含义 | 调用方式 | | --- | --- | --- | | mimocode（默认） | 本机 mimo CLI（MiMoCode） | mimo run --format json --dangerously-skip-permissions | | mimo-desktop | 小米 MiMo 桌面客户端本地 API | Desktop 开启时经 desktop-api.json（Authorization: Bearer）POST /v1/sessions/:id/turns |

mimo-desktop 需 Xiaomi MiMo 桌面端在运行；未启动时返回 DESKTOP_UNAVAILABLE，可改回 mimocode。

mimo_run

mimo_run(prompt, backend?, mode?, model?, effort?, cwd?, timeoutSec?, background?, title?)

把任务派给预选 backend（或本次指定的 backend）。mimocode 强制 --format json --dangerously-skip-permissions，从不弹权限提示。

• backend：mimocode | mimo-desktop（默认用设置里的预选值）
• mode：auto（跟随 DSH plan）/ plan（只读）/ build（全工具）/ compose
• model：provider/model（mimocode）或桌面模型 id 如 mimo-auto（mimo-desktop）
• effort：low|medium|high → --variant minimal|high（仅 mimocode）
• background：默认 true（立即返回 jobId，用 job_output 收取；mimo_status 看进度）

mimo_continue

mimo_continue(prompt, sessionId?, latest?, backend?, ...)

续接既有会话（mimocode：--session / --continue；mimo-desktop：同 sessionId 投递 turn）。

mimo_status

mimo_status(cwd?)

实时观察 + 用量统计 + defaultBackend（当前预选）。

mimo_settings

mimo_settings(backend?, desktopModel?)

读/写预选 backend 与桌面模型，持久化到 settings 文件。无参调用返回当前生效配置（含 Desktop API 是否可用）。

安装

见 docs/INSTALL.md。快速路径：

dsh plugin --profile web add mimo-first-bridge

前提：本机 mimo --version 可用（Xiaomi MiMo Desktop / MiMoCode CLI）。

MCP（可选）

不需要 DSH 时，把 mcp/mimo-mcp-server.mjs 注册为 MCP 服务器，Claude Code / Codex / Cherry Studio 等宿主即可自动发现四个工具（mimo_run / mimo_continue / mimo_status / mimo_settings）：

node mcp/mimo-mcp-server.mjs --check
claude mcp add mimo -- node C:\path\to\mimo-mcp-server.mjs

开发

npm run build     # 同步 core → preset 副本
npm run check     # build --check + verify + MCP --check
npm test          # core + contracts + mcp-smoke

关键契约：client 模块 id 永远 === 主包名 mimo-first-bridge（scripts/verify.mjs 已锁死）。详见 docs/HANDOVER.md 与 docs/DEV-DISCIPLINE.md。

安全说明

--dangerously-skip-permissions 表示 mimo 会在不再询问的情况下改动文件、执行命令。这是「DSH 完全控制 mimo」的直接实现，请仅在你信任执行环境时使用。

License

MIT