前言¶
在 DSH（DeepSeek Harness）中，当同时使用多个 API 提供商时，查看各家的剩余量或余额通常需要切换设置或打开外部网页。dsh-musage-card 是一个本地分叉插件，它将多 Provider 的用量/余额视图整合到了 DSH 界面中。该卡片固定显示在侧边栏底部（“移动访问”按钮上方），会自动跟随当前会话选中的模型切换显示对应的额度信息。
核心功能¶
该插件主要提供以下能力：
- 多 Provider 支持：集成了 11 家 Provider 的用量查询接口。
- 自动跟随：根据当前会话选中的模型，自动切换显示对应 Provider 的余额。
- 可视化进度条：提供剩余量进度条，不同周期（如 5h、7d）使用不同颜色区分。
- 一键浏览器登录：针对 Cookie 型 Provider（如 MiMo、Claude、StepFun），提供自动注入登录态的功能（仅限 Windows）。
- 登出按钮：提供清除已保存 Cookie 登录态的入口。
支持的 Provider¶
插件支持以下 11 家 Provider，涵盖 API Key 和 Cookie 两种凭据模式：
| Provider 别名 | 显示类型 | 端点 | 凭据类型 |
|---|---|---|---|
minimax / minimax-cn / minimax-en |
5h / 7d 双窗口 | api.minimaxi.com/v1/api/openplatform/coding_plan/remains |
MINIMAX_CN_API_KEY |
deepseek / deepseek-official / deepseek-account |
余额（¥ / $） | api.deepseek.com/user/balance |
DEEPSEEK_API_KEY |
kimi / kimi-coding |
5h / 7d 双窗口 | api.kimi.com/coding/v1/usages |
KIMI_CODING_API_KEY |
zhipu / zai-coding-cn |
5h / 7d 双窗口 | open.bigmodel.cn/api/monitor/usage/quota/limit |
ZAI_CODING_CN_API_KEY |
openrouter |
余额（$） | openrouter.ai/api/v1/credits |
OPENROUTER_API_KEY |
stepfun / stepfun-plan |
余额（¥，细分） | api.stepfun.com/v1/accounts |
STEPFUN_API_KEY（支持网页登录态） |
siliconflow / siliconflow-cn |
余额（¥，细分） | api.siliconflow.cn/v1/user/info |
SILICONFLOW_API_KEY |
tavily |
已用 / 总量 credits | api.tavily.com/usage |
TAVILY_API_KEY |
zenmux |
PAYG 余额（$，细分） | zenmux.ai/api/v1/management/payg/balance |
ZENMUX_MANAGEMENT_API_KEY |
xiaomi-token-plan-* / xiaomi / mimo |
月总额 / 补偿 | platform.xiaomimimo.com/api/v1/tokenPlan/usage |
浏览器 Cookie |
claude / anthropic / claude-code |
5h / 7d 双窗口 | api.anthropic.com/api/oauth/usage |
sessionKey Cookie |
安装与启用¶
该插件已发布到 npm 与 dsh-plugin 插件市场，支持通过插件市场安装或本地挂载。
- 通过插件市场安装：
dsh plugin install dsh-musage-card
- 本地挂载（开发调试）：
支持使用file:协议挂载本地路径。
配置与使用¶
API Key 类配置¶
对于前 9 家使用 API Key 的 Provider，无需额外配置。插件会复用 DSH 模型设置里已配置的 Provider Key（遵循 DSH 规范，即 <PROVIDER 大写去特殊字符>_API_KEY）。
Cookie 型 Provider 配置（MiMo / Claude / StepFun）¶
对于小米 MiMo、Claude 和 StepFun 这类需要浏览器登录态的 Provider，推荐使用“一键登录”功能。
一键登录（推荐，仅限 Windows）：
1. 当卡片显示“⚠”或“🔑 点击卡片登录”时，点击卡片。
2. 插件会自动弹出一个专用浏览器窗口（基于 Edge 或 Chrome），并停留在官方登录页。
3. 在该窗口中完成登录。
4. 登录完成后，窗口自动关闭，卡片自动刷新并显示用量。
手动配置：
如果一键登录不可用（如未安装 Edge/Chrome 或处于非 Windows 环境），需手动配置。
- 登录对应的官方网页（如
platform.xiaomimimo.com或claude.ai）。 - 打开浏览器开发者工具（F12），查看网络请求（Network），复制 Cookie 或 sessionKey 的完整值。
- 编辑 DSH 的凭据文件
~/.dsh/.credentials.yaml，追加相应的 Key（需用引号包裹）：
# ~/.dsh/.credentials.yaml（示例）
XIAOMI_MIMO_COOKIE: "api-platform_serviceToken=...; userId=...; ..."
CLAUDE_SESSION_KEY: "sk-ant-sid01-..."
DSH 会观察该文件的变化并热生效，无需重启。
StepFun 特殊说明¶
StepFun 支持网页登录态，且可以通过一键登录获取。Cookie 过期后，卡片会提示失效，重新点击卡片触发登录流程即可刷新。
登出¶
对于支持登出的 Provider（如 StepFun、MiMo、Claude），卡片右上角会出现一个小的“登出”按钮。点击后会清除插件保存的 Cookie 登录态，但不会影响你自配的 API Key。清除后卡片将回到“点击卡片登录”的状态。
位置与样式¶
- 位置：插入点为
sidebar.footer.action（侧边栏底部，“移动访问”按钮上方，order -100）。 - 样式：采用半透明玻璃材质（backdrop-filter blur + 高光描边），适配明暗主题。
- 刷新：点击卡片可立即刷新，同时保留 60 秒定时刷新。
注意事项¶
- 平台限制：一键浏览器登录功能目前仅支持 Windows。
- Cookie 过期：
- Claude Cookie 约每 8 小时过期。
- MiMo Cookie 随登出失效。
- StepFun 登录态需要保持有效，否则卡片会提示探针失败。
- 环境依赖：需要 DSH 环境运行。
总结¶
dsh-musage-card 通过玻璃拟态卡片的形式，将多 Provider 的用量监控集中到了侧边栏，解决了频繁切换查看余额的痛点。特别是针对 Claude 和 MiMo 等难于配置的 Cookie 型 Provider，提供的一键登录功能降低了使用门槛。
