anze225-max/dsh-mimo-connect

DSH MiMo Connect

License: MIT
npm
Node
DSH

将 MiMo 桌面 App 包含的模型自动接入 DeepSeek Harness，在 DSH 对话窗口里零配置使用。

用的是你在 MiMo 客户端里已经登录、已经充值的那份额度——不需要单独申请 API Key，也不需要额外装常驻程序。

模型选择器中的 MiMo 分组

会话切到 MiMo 时，输入框下方会直接显示剩余额度；用别的模型时它不出现。

剩余额度与统计行同排

悬停可看到重置日。

悬停显示重置日

为什么需要它

MiMo 客户端的额度本来只能在客户端里用。想在 DSH 里用上它，通常只有两条路：

| 做法 | 代价 |
|---|---|
| 单独申请平台 API Key | 走的是平台计费，与客户端额度是两套账，等于重新花钱 |
| 用第三方反代工具 | 需要额外装一个常驻程序，还要配开机自启 |

这个插件是第三条路：直接复用客户端已经登录的凭证，把客户端那份额度接进 DSH。不额外申请 Key、不额外装程序、不写开机自启。

特性

- 零配置：客户端已登录，插件装上就能用，不弹任何提示。
- 复用客户端额度：用的是你在 MiMo 客户端里的那份额度，不是平台计费。
- 无常驻进程：不启动代理、不注入进程、不写注册表自启项。关掉 DSH 就什么都不剩。
- 剩余额度就地可见：会话切到 MiMo 时，输入框下方直接显示剩余额度与重置日；用别的模型时它不出现。
- 可脱离客户端使用：没装客户端也能让插件单独登录一次，之后与客户端无关。
- 跟随账号：客户端换账号或退出登录，插件自动跟随。
- 支持图片输入：模型支持时可直接粘贴图片。
- 思考过程可见：思维链以流式事件呈现。

安装

dsh plugin --profile desktop add dsh-mimo-connect
dsh --profile desktop

（把 desktop 换成你实际使用的 profile：web / desktop / dsh-tui）

装好后在模型选择器里选择 MiMo 分组下的模型即可。

也可以从源码安装：

dsh plugin --profile desktop add github:anze225-max/dsh-mimo-connect

凭证来源

插件按下面的顺序解析凭证，前者存在就不打扰你：

| 顺序 | 来源 | 说明 |
|---|---|---|
| 1 | $DSH_HOME/.mimo-connect-auth.json | 插件自己登录后保存 |
| 2 | MiMo 客户端的 cookie | 只读复用，不修改客户端任何文件 |
| 3 | 都没有 | 提示运行 login 命令 |

客户端的 cookie 读取位置：

%APPDATA%\Xiaomi MiMo\Partitions\xiaomi-account\Network\Cookies

该文件是 Chromium 的标准 SQLite cookie 库，插件复制到临时文件后只读查询，避免与运行中的客户端争锁。MiMo 的 cookie 值是明文存储的（value 有值、encrypted_value 为空），因此不需要 DPAPI 解密。

命令行

dsh plugin --profile desktop exec dsh-mimo-connect status    # 查看登录状态
dsh plugin --profile desktop exec dsh-mimo-connect verify     # 真实调用一次模型
dsh plugin --profile desktop exec dsh-mimo-connect doctor     # 本地诊断
dsh plugin --profile desktop exec dsh-mimo-connect login      # 单独登录（不用客户端）
dsh plugin --profile desktop exec dsh-mimo-connect logout     # 删除插件自己的凭证

关于 login

小米 passport 不接受第三方回调地址（返回「Callback连接不合法」），且 passToken 是 HttpOnly，浏览器 JS 读不到。因此无法做成「点一下自动登录」。

login 会给出逐步指引：打开登录页 → 从开发者工具的 Application → Cookies 里复制三个值粘贴回来。插件会立即验证凭证可用后才保存。

如果你已经装了 MiMo 客户端，就不需要 login —— 直接复用即可。

工作原理

客户端凭证（passToken / cUserId / userId）
↓  STS 换取（3 步重定向）
serviceToken
↓  作为 Cookie 请求头
mimo-server-cn.xiaomimimo.com/api/route/chat/completions
↓  标准 OpenAI 协议
DSH 的 LLM seam

真实端点是 OpenAI 兼容协议，没有协议翻译层。model.headers 把 cookie 直接注入 pi-ai 构造的请求，因此也不需要本地 shim。
附件服务

插件把宿主的 attachments 服务接入适配器。这不是可选项：dsh-llm-pi-ai 只要发现消息里含图片块而拿不到附件服务，就会抛 UNSUPPORTED_CONTENT——连纯文本轮次也会失败，只要该会话更早的工具结果里出现过图片。

从其他模型切换到 MiMo 时最容易触发，因为历史上下文会被带过来。相关回归测试见 tests/image-guard.mjs。

一个关键实现细节

网关按域校验身份：把 .xiaomi.com 与 .account.xiaomi.com 的 cookie 混在一个请求头里发送会导致会话被判失效，返回 EXPIRED 并踢回登录页。插件为此实现了按域隔离的 cookie jar，并且同名 cookie 只发送一次（取最具体域的值）。这条规则由 tests/cookie-jar.mjs 与 tests/session.mjs 中专门的回归测试守护。

剩余额度显示

会话当前用的是 MiMo 时，输入框下方的统计行右侧会出现一枚额度指示：

● MiMo 剩余 99.8%

悬停可看到重置日（例如 重置于 2026-09-30）。额度低于 20% 时指示点转为提醒色，低于 5% 转为告警色。

只有会话路由到 MiMo 时才显示。 用 DeepSeek 或别的模型时，这一行完全不出现，也不会发出任何额度请求——额度显示属于正在花这份额度的会话，不该出现在无关对话里。

数据来自客户端自己的用量接口：

GET mimo-server-cn.xiaomimimo.com/api/user/usage
→ {"code":0,"data":{"percent":99.8,"resetDate":"2026-09-30","resetAt":1790782334}}

percent 是剩余百分比。读取是只读的，不消耗任何额度；结果缓存 60 秒，读失败退避 15 秒，任何失败路径都只是「不显示」，不会影响推理。

实现上，node 半侧注册一条 /api/mimo.quota 路由（与其它 /api 路由共用同一道浏览器会话校验），浏览器半侧通过 conversation.composer.dock 插槽挂载一个组件读取它。宿主没有浏览器连接时（例如 CLI）该路由不注册，provider 照常工作。

配置

| 配置项 | 默认值 | 说明 |
|---|---|---|
| cookieDb | 空 | 显式指定客户端 cookie 库路径 |
| pollSeconds | 30 | 重新检查凭证的间隔（秒）；0 关闭轮询 |

环境变量 MIMO_COOKIE_DB 可覆盖 cookie 库位置。

模型

| ID | 显示名 | 倍率 |
|---|---|---|
| mimo-v2.6-flash | MiMo V2.6 Flash | x0.40 |
| mimo-v2.6-pro | MiMo V2.6 Pro | x1.00 |

倍率是客户端显示的点数消耗系数，仅作展示，不影响请求。

网关没有模型列表接口（/api/route/models 等均返回 404），所以这份清单是内置快照，取自客户端 model-catalog.json 的 TEXT 条目。

没有推理档位选择器

模型选择器里不会出现 Off / Minimal / Low / Medium / High 档位。这是有意为之。

这些模型确实会产出思维链（以 reasoning_content 返回，在 DSH 中表现为流式的思考过程），但网关忽略所有实测过的控制参数：

| 参数 | 推理 token 数 |
|---|---|
| 默认 | 176 / 211 |
| thinking: { type: 'disabled' } | 179 |
| thinking: { enabled: false } | 237 |
| reasoning_effort: 'none' | 181 |
| reasoning_effort: 'low' | 205 |
| enable_thinking: false | 210 |

全部无效。与其显示一个「调了没反应」的选择器，不如不显示。

关于响应速度

实测数据表明延迟来自上游网关，不是插件：

| 环节 | 耗时 |
|---|---|
| 会话缓存命中 | 0 ms |
| cookie 头构造 | < 0.01 ms |
| DNS 解析 | 9–28 ms |
| 网络往返（不含推理） | 37–169 ms |
| 一次完整对话 | 1–19 秒（波动极大） |

同一句「你好」，实测耗时从 1 秒到 19 秒都在出现。绕过插件的裸 fetch 请求分布与经插件的请求完全重合，说明插件没有引入可测量的开销。

由于网关忽略推理档位参数，目前没有插件层面的提速手段。

已知限制

- 依赖非公开接口。插件使用客户端自身的端点与凭证，非小米官方开放 API；上游变更后可能需要跟随调整。
- 响应速度受上游影响。延迟波动较大，插件无法控制。
- 额度显示依赖同一套非公开接口。/api/user/usage 变更或下线时，额度指示会静默消失，不影响模型调用。
- 凭证有效期。passToken 实测有效期 30 天；过期后需重新登录（客户端或 login）。
- serviceToken 需要短期续期。插件在会话内自动重换，遇到 401 会重试一次。
- 配额由小米控制。插件只转发请求，不改变额度、限流或账号权限。

开发

npm run build                 # 生成浏览器半侧 lib/client.js
node tests/run.mjs            # 全部套件
node tests/run.mjs client     # 仅客户端半侧
node tests/run.mjs layout     # 仅排版对照
node tests/run.mjs cookie     # 名称含 cookie 的套件

部分套件在检测到可用凭证时会执行真实网络调用，否则自动跳过。

渲染与排版测试需要几个只服务测试的依赖：

npm i --no-save js-yaml@^4 react@18.3.1 react-dom@18.3.1 jsdom

它们不进发布产物——浏览器半侧在 DSH 页面里只从平台基座取 React。
tools/ 存放本机部署辅助脚本（引用机器相关的 DSH profile 路径），不属于发布测试的一部分。npm run sync 会先构建再把插件同步到 desktop profile。

浏览器半侧

客户端 bundle 是手写的 __ModuleLoader__.load(...) 形式，没有打包器参与：src/client.js 就是产物形状，tools/build-client.mjs 补一份 source map 后写到 lib/client.js。宿主从 package.json 的 dsh.client 声明发现它，并把 exports["./client"] 指向的文件原样提供在 /plugins 下。

改完客户端代码必须重启 DSH：bundle 在进程启动时被快照，patchReload 不会重新读取它。

额度指示为什么能跟上宿主的排版

统计行的两个原生 pill 是同一个 flex 容器 [data-composer-stats] 的子项，靠容器自己的 display:flex; gap:12px 排列——没有绝对定位，也没有手算偏移。

本插件不能成为那个容器的子项：注册 conversation.composer.dock 时宿主没有声明 children，slot 注册表里没有子插槽可用。所以组件用 createPortal 把 pill 送进 [data-composer-stats]，让它成为同一容器的真正子项，排版权完全交给宿主自己的规则。插件只声明 pill 自身的几何。

tests/layout-parity.mjs 从 dsh-client-ui-chat 的产物里逐字提取宿主 CSS，把两边的 pill 放进同一容器比对计算样式，覆盖字号变化、变量缺失、窄容器与深色主题。找不到 DSH 安装目录时整支跳过（退出码 0）；用 DSH_APP_ROOT 可指定位置。

统计行会随会话状态挂载与卸载，宿主也可能整体替换它，所以组件在轮询发现之后改用 MutationObserver 盯住替换。

免责声明

- 本项目仅供个人学习和研究使用，仅驱动使用者自己的 MiMo 账号在本机调用，请勿用于商业用途或超出个人合理使用的场景。
- 使用者需遵守小米的服务条款；因使用本项目产生的任何后果（包括但不限于账号被限制、额度被清空、服务中断），由使用者自行承担。
- 本项目与小米、Xiaomi MiMo、DeepSeek 均无关联，未获其授权或认可；文中出现的名称仅用于描述兼容关系，其商标权利归各自所有。

致谢

- dsh-workbuddy-connect（MIT）—— 插件组织方式、provider 注册与 PiAiAdapter 组装的参照。

许可证

MIT