前言¶
在 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，提供的一鍵登錄功能降低了使用門檻。
