前言¶
如果你在使用 dsh 的 Web 側欄工作，經常需要確認某個 AI 平臺的餘額、今日消費和今日 Token，手動查看平臺後臺會比較分散。dsh-deepseek-balance-widget 解決的問題比較具體：把 DeepSeek 和可添加的 MiMo（小米）餘額信息放到 dsh Web 側邊欄，並每 30 秒自動刷新。
下面按功能、安裝、配置、更新的順序介紹這個插件。
這是什麼¶
dsh-deepseek-balance-widget 是 crazy-L118 維護的一個 dsh 插件，用於在 dsh Web 側邊欄顯示 AI 餘額。它內置 DeepSeek，可添加 MiMo（小米），許可證爲 MIT。
從 package.json 可以看到：
- 要求 Node.js
>=18 - 聲明 dsh client platform 爲
web - 注入
@deepseek-ai/dsh-client-runtime - 可選 peerDependency 爲
@deepseek-ai/cordis ^4.0.1
核心功能¶
側邊欄入口¶
側邊欄入口會即時顯示當前平臺的信息：
- 餘額
- 今日消費
- 今日 Token
數值會隨詳情彈窗內切換的平臺聯動，並且每 30 秒自動刷新。
詳情彈窗¶
詳情彈窗可以管理已添加的平臺：
- 顯示當前平臺
- 支持更換已添加平臺
- 支持移除已添加平臺
- 支持添加 MiMo 或 DeepSeek
DeepSeek 詳情¶
DeepSeek 詳情會顯示：
- 餘額
- 累計消費
- 今日消費
- 今日 Token
- 本月消耗
- 時段徽章：GMT+8 工作日 09-12 / 14-18 爲繁忙時段，週末全天空閒
MiMo 詳情¶
MiMo 詳情會顯示：
- 餘額
- 累計消費
- 今日消費 / 今日 Token
- 本月消耗
- 每日消耗表
用量統計¶
DeepSeek 的用量統計可以配置 DEEPSEEK_PLATFORM_TOKEN。未配置時，僅顯示餘額。
MiMo 的餘額與用量使用登錄 Cookie 查詢，並按官方單價自動推算消費金額。
AI 引導配置¶
彈窗內提供「AI 幫我配置」入口，可以一鍵複製提示語，由 AI 引導獲取憑證並寫入插件。
MiMo 支持兩種方式：
- AI 引導向導
- 手動粘貼 Cookie / cURL，並自動提取 Cookie
數據存儲¶
憑據保存在本機：
~/.dsh/ai-balances.json
數據僅存本機，不隨插件分發、不上傳。
版本與更新¶
彈窗底部顯示當前版本，支持一鍵自動更新。更新失敗時會顯示錯誤詳情面板，並引導前往 GitHub 自行安裝。
界面語言隨 dsh 設置自動切換中 / EN。
安裝與啓用¶
先確認已安裝 dsh，並且 dsh web 可用。插件要求 Node.js >=18。
執行下面命令安裝：
dsh plugin --profile web add dsh-deepseek-balance-widget@2.4.2
這條命令會從 npm 拉取安裝，dsh 會自動註冊到 dsh.profile.bundles。
安裝完成後，需要徹底重啓 dsh web。僅刷新瀏覽器頁面無效。
安裝命令中建議寫死版本號 @2.4.2，不要使用 @latest，避免本地 pnpm/npm 緩存或鏡像源解析成舊版本。
典型用法¶
使用內置 DeepSeek¶
插件首次使用會自動創建 DeepSeek 條目，並讀取本機的 DEEPSEEK_API_KEY。
添加 MiMo¶
打開餘額彈窗，點「+ 添加」，再點「AI 幫我配置」，把提示語發給智能體。
也可以直接對 AI 說：
幫我配置 dsh-deepseek-balance-widget
MiMo 也可以手動粘貼 Cookie / cURL，插件會自動提取 Cookie。
配置 DeepSeek 用量統計¶
DeepSeek 用量統計可配置 DEEPSEEK_PLATFORM_TOKEN。未配置時，僅顯示餘額。
也可以對 AI 說：
幫我配置用量統計
更新插件¶
已安裝用戶可以在餘額彈窗底部點擊「更新」，插件會自動從 npm 拉取並安裝最高版本。彈窗更新會跳過 latest tag，直接安裝 npm 上 semver 最高版本。
命令行強制更新可執行：
dsh plugin --profile web add dsh-deepseek-balance-widget@2.4.2
手動更新可進入插件目錄：
cd ~/.dsh/profiles/web
npm install dsh-deepseek-balance-widget@2.4.2
如果環境提示使用 pnpm，可按提示執行 pnpm add。
若 Agent 主機通過 NODE_OPTIONS 注入文件刪除攔截導致更新失敗，可在普通終端執行更新命令，或先執行：
set NODE_OPTIONS=
再重試。
卸載插件¶
dsh plugin --profile web rm dsh-deepseek-balance-widget
適用場景與注意¶
這個插件適合已經使用 dsh 和 dsh web，並且需要查看 DeepSeek 或 MiMo（小米）餘額、消費、Token 的場景。
使用前需要注意：
- DeepSeek 必填憑據爲
DEEPSEEK_API_KEY - DeepSeek 用量統計可選配置
DEEPSEEK_PLATFORM_TOKEN - MiMo 需要登錄 Cookie，可由 AI 引導獲取
- 憑據保存在本機
~/.dsh/ai-balances.json，不隨插件分發、不上傳 - 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證
- 安裝或更新後必須徹底重啓
dsh web，僅刷新瀏覽器頁面無效 - 目錄頁是獨立站點，不代表 DeepSeek / 幻方官方應用商店
鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/crazy-L118/dsh-deepseek-balance-widget
- GitHub：https://github.com/crazy-L118/dsh-deepseek-balance-widget
