前言¶
用 DeepSeek Harness(DSH)接小米 MiMo 时,套餐剩余、按量余额和本会话实际走了多少 MiMo,通常要另开控制台或自己记数。对话页模型选择器旁已有 codebuddy 等渠道的用量环,MiMo 却没有对等入口。下面介绍社区插件 dsh-mimo-extension(维护者 upcyan),它在 Web 客户端增加 额度环 和 MiMo 用量 详情页,把官方额度与会话内归属统计放进同一界面。
这是什么¶
dsh-mimo-extension 是 DSH 的 Web 客户端插件(@deepseek-ai/dsh-client-ui-conversation 注入),定位一句话:在模型选择器旁显示带 mi logo 的 套餐剩余百分比环,并提供 MiMo 用量 Tab,展示计费类型、套餐/余额、本会话 MiMo 用量、今日与历史趋势、费用估算等。
插件归属 GitHub 仓库 upcyan/dsh-mimo-extension,社区目录页:skillhub.cn/plugins/upcyan/dsh-mimo-extension。DSH 生态是「一切皆插件」;SkillHub 为独立社区目录,与 DeepSeek / 幻方无官方从属关系。
当前 package 版本 1.1.21,许可证 MIT,要求 Node ^22.19.0 || >=24.0.0。
核心功能¶
额度环与摘要卡¶
| 入口 | 显示内容 |
|---|---|
| 额度环 | mi logo 嵌在环内,环表示 套餐剩余百分比。按量计费无总量时只画空环,不显示误导性的 0% 或 100% |
| 点击额度环 | 用量摘要:计费类型、剩余额度或会话 tokens、本月已用百分比与 已用额度绝对值(Credits)、套餐总量、请求次数、当前模型;底部可进入详情页 |
环的尺寸与 dsh-codebuddy 用量环对齐(直径 26、线宽 3),并排时视觉一致;进度与边框使用平台主题变量,logo 使用小米品牌橙 #ff6900。
MiMo 用量详情页¶
详情页包括:当前模型、计费类型、本会话 MiMo 用量、今日与历史用量、费用估算、用量趋势与预测。页底表单可配置 Cookie、额度环位置、工具栏换行、视觉路由等。
只在 MiMo 通道上显示环¶
额度环绑定 MiMo 通道:仅当当前模型属于 MiMo 时渲染,机制与 dsh-codebuddy 的 codebuddyUsageVisible 类似。判定以 API 地址 为准(xiaomimimo.com 域名为 MiMo);读不到地址时退回 provider/模型名是否含 mimo / xiaomi*。使用 codebuddy 等其他 provider 时不渲染环,避免误报 MiMo 额度。详情页可在非 MiMo 模型下仍显示账号级套餐信息,并标注「当前模型不是 MiMo」;也可配置「非 MiMo 时隐藏」整个 Tab。
会话用量按渠道归属¶
会话若混用多个 provider,session.totalTokens 不等于 MiMo 用量。插件按 models[].provider 只汇总 MiMo 部分;混用时列出非 MiMo 渠道并标明「不计入上方汇总」;本会话完全未用 MiMo 时会说明会话用量为 0 属正常,下方套餐额度仍为账号级。
可选:MiMo 视觉路由(图像输入)¶
平台按模型的 inputModalities 拦截图片;开启「启用 MiMo 视觉路由」后,对 catalog 中已声明图像能力的小米模型(如 mimo-v2.5)把 llm-pi-ai 里对应模型的 input 写成 ["text","image"]。纯文本模型(如 mimo-v2.5-pro)默认不修改;子选项「同时为纯文本模型提供视觉能力」为越权声明,仅在你确认上游能读图时再开。
安装与启用¶
在 web profile 下安装(命令来自仓库 README):
# 从 GitHub 装
dsh plugin --profile web add github:upcyan/dsh-mimo-extension
# 或装 Release 里的预构建包
dsh plugin --profile web add \
https://github.com/upcyan/dsh-mimo-extension/releases/latest/download/dsh-mimo-extension.tgz
装完后重启 dsh web,刷新浏览器。确认安装位置:
P="$DSH_HOME/profiles/web"
grep '"dsh-mimo-extension"' "$P/package.json"
dsh --profile web --dump-config | grep -A2 mimo-extension # 应打印 id: mimo-extension
两点环境注意(与插件逻辑无关但常见踩坑):
- 显式设置
DSH_HOME。未设置时dsh回退到~/.dsh;在 root shell 安装会装进/root/.dsh/profiles/web,表现为装成功但界面不变。 - pnpm 11 可能需要
--config.minimumReleaseAge=0,否则 lockfile 含刚发布包时 install 可能被 24 小时最小发布年龄拦住。
profile 目录只读时,README 文末有手动安装说明。
典型用法¶
1. 配置控制台 Cookie(套餐用户推荐)¶
填 Cookie 后才能读官方 Token Plan 接口(tokenPlan/detail、tokenPlan/usage);按量用户填 Cookie 主要多读到 balance。
获取步骤:
- 登录 https://platform.xiaomimimo.com
- DevTools → Network → 任一
/api/v1请求 → Headers → 复制完整Cookie - 确认含
api-platform_serviceToken与userId,在「MiMo 用量」页底表单粘贴并保存
也可写入 $DSH_HOME/.credentials.yaml 的 refs.MIMO_CONSOLE_COOKIE,或编辑 cordis.patch.yml 的 mimo.cookie。Cookie 存本机 settings.yaml 的 dsh-mimo-extension 命名空间,不回传浏览器明文。
未配 Cookie 时,套餐剩余百分比读不到(tokenPlan/* 返回 401),界面退回 本地兜底套餐总量 等估算字段。
2. 调整额度环位置¶
在详情页表单选择 额度胶囊位置,保存即生效:
| 取值 | 位置 |
|---|---|
header |
标题行右侧动作区 |
toolbar(默认) |
输入框工具栏,模型选择器旁 |
above |
输入框上方独占一行 |
hidden |
不显示环,仅保留详情页 |
3. 查看用量¶
当前模型为 MiMo 时,在工具栏(或你配置的位置)看环上剩余比例;点击环看摘要卡,再进 MiMo 用量 Tab 看会话归属、历史与预测。移动端(宽度小于 640px)环上可隐藏文字只留数值,详情页改为单列布局。
适用场景与注意¶
适合谁:日常在 DSH Web 用小米 MiMo(按量或 Token Plan),希望在对话页直接看账号额度与会话内 MiMo 消耗,并与 codebuddy 用量环并列对照的开发者。
运行与信任:插件以当前 dsh 进程权限 运行;安装前请自行查看 源码与 MIT 许可证,Cookie 仅本机存储,但仍属敏感凭据,勿在不可信环境粘贴。
数据边界:官方数据依赖小米平台接口与有效 Cookie;接口失败或未配 Cookie 时为本地估算。视觉路由修改的是 llm-pi-ai 命名空间中的模型 input 声明,错误开启纯文本模型的图像能力可能导致上游静默丢图。
结尾¶
dsh-mimo-extension 把 MiMo 额度环、摘要卡与用量详情收进 DSH Web 客户端,并按 provider 区分会话统计,减少「切控制台 + 心算混模会话」的重复劳动。安装与配置以 README 为准。
- 社区目录:https://www.skillhub.cn/plugins/upcyan/dsh-mimo-extension
- GitHub:https://github.com/upcyan/dsh-mimo-extension