前言¶
在 DSH 裏調用 DeepSeek API 時，賬戶餘額、峯谷計價時段、當前會話大概花費了多少費用，通常會分散在接口、控制檯和計價規則裏。dsh-balance-monitor 是 Rainronin 維護的一個 DSH 插件，目標是把這些信息放進 dsh 會話和側邊欄。
它是社區目錄裏的 DSH 插件，不是 DeepSeek 或幻方的官方應用商店產品。DSH 的理念是「一切皆插件」，這個插件也按社區插件的方式安裝和組合到 profile 中。
插件定位¶
dsh-balance-monitor 是一個 DeepSeek API 餘額即時監測插件，許可證爲 MIT。
它提供以下能力：
- 官方
/user/balance接口餘額快照 ds_balance會話內查詢工具- 北京時間峯谷計價狀態
- 單會話費用估算
- dsh 原生風格側邊欄徽章
核心能力¶
餘額快照與會話內查詢¶
插件使用官方 /user/balance 接口獲取餘額快照，並提供 ds_balance 工具，讓 agent 在會話內查詢餘額。
ds_balance 支持穿透緩存：
force: true
側邊欄徽章¶
插件提供 dsh 原生風格的側邊欄徽章：
- 徽章位於側欄底部 Settings 旁
- 支持刷新按鈕，點擊後強制穿透緩存
- 默認 30s 自動輪詢
- 摺疊態顯示狀態燈
- 支持多幣種顯示，CNY/USD 全列且 CNY 優先
狀態燈含義：
- 綠色：連接正常
- 黃色：降級
峯谷計價狀態¶
插件會顯示北京時間峯谷計價狀態：
- 高峯：顯示
高峯 HH:MM:SS，並可倒計時到空閒階段 - 空閒：顯示
空閒
官方峯谷計價自 2026-08-17 00:00 北京時間生效，此前爲預覽。
單會話費用估算¶
插件會基於 DeepSeek V4 峯谷計價進行單會話費用估算。
密鑰與請求策略¶
插件複用 DEEPSEEK_API_KEY，不需要單獨配置密鑰。相關資料宣稱其不落盤、不打印、不緩存。
請求策略包括：
- 30s TTL 緩存
- 請求串行
- 5s 超時
插件還支持可選的每輪注入：把餘額注入到模型上下文中。該能力默認關閉，開啓後只讀緩存，且宣稱不阻塞對話。
安裝與啓用¶
在 web profile 中安裝：
dsh plugin --profile web add @rainronin/dsh-balance-monitor
安裝後，插件會自動加入 dsh.profile.bundles。可以查看組合配置：
dsh --profile web --dump-config
從 GitHub 安裝時，如果 pnpm 阻止 prepare 構建腳本，需要按提示在 $DSH_HOME/profiles/<profile>/pnpm-workspace.yaml 中添加 allowBuilds 並重試。
典型用法¶
在會話裏查詢餘額¶
可以直接對 agent 提問：
查一下 DeepSeek 餘額
或者：
check my DeepSeek balance
查看側邊欄徽章¶
側邊欄徽章會顯示餘額和狀態。
- 點擊刷新按鈕，可以強制穿透緩存
- 摺疊態顯示單個狀態燈：綠色表示連接正常，黃色表示降級
- 高峯狀態顯示
高峯 HH:MM:SS，並倒計時到空閒階段 - 空閒狀態顯示
空閒
覆蓋配置¶
可以在 profile 的 cordis.patch.yml 中覆蓋配置，例如 cacheTtlMs 和 pollIntervalMs：
- id: balance-monitor
config:
cacheTtlMs: 10000
pollIntervalMs: 10000
上面示例把緩存 TTL 和輪詢間隔都設爲 10000 ms。
異常狀態¶
未配置密鑰時：
- 工具返回中文提示
- 徽章顯示未配置密鑰
API 失敗且有舊緩存時：
- 返回上次快照
- 標記爲過期
API 失敗且無緩存時：
- 展示真實失敗原因
- 徽章顯示無信號
適用場景與注意¶
這個插件適合在 DSH 中調用 DeepSeek API，並希望查看餘額、峯谷計價狀態和單會話費用估算的人。
使用前注意：
- 插件以當前 dsh 進程權限運行
- 安裝前應檢查源碼與許可證；當前資料顯示許可證爲 MIT
- 未配置
DEEPSEEK_API_KEY時，無法獲得真實餘額 - 每輪注入默認關閉，默認主要通過徽章和
ds_balance工具查詢 - DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係
相關鏈接¶
- GitHub：https://github.com/Rainronin/dsh-balance-monitor
- 目錄頁：https://www.skillhub.cn/plugins/Rainronin/dsh-balance-monitor，來自插件線索。
