前言¶
在 DSH Web 中使用 DeepSeek API 時，查看剩餘額度、配置低餘額提醒、打開充值入口通常需要額外操作。dsh-balance-display 是一個 DSH 客戶端插件，把餘額展示放在 Web GUI 左側欄底部，並支持餘額趨勢、低餘額預警和一鍵充值。
這是什麼¶
dsh-balance-display 由 zhangjianyu1006156 維護，許可證爲 MIT，分類爲客戶端。它面向 DSH Web 場景，在左側欄底部顯示 DeepSeek API 的剩餘額度，並在設置頁提供「餘額顯示」配置入口。
核心功能¶
餘額膠囊¶
- 在左側欄底部顯示餘額。
- 點擊可刷新。
- 懸浮時顯示充值/贈送拆分。
低餘額預警¶
- 餘額低於閾值時，圓點變紅，並顯示懸浮警告。
- 可配置瀏覽器通知；使用瀏覽器通知需要授權通知權限。
- 默認低餘額預警閾值爲
¥5。
精度與趨勢¶
- 餘額小於
¥1時，顯示 4 位小數。 - 設置頁展示 sparkline 趨勢圖，並給出今日/近 7 天消耗統計。
- 餘額歷史與偏好存於瀏覽器
localStorage，鍵名前綴爲dsh.balanceDisplay.*；主機端不感知、不存儲。
充值與重試¶
- 膠囊和設置頁均可一鍵打開
platform.deepseek.com/usage。 - 連續失敗時，刷新間隔自動遞增。
- 切換標籤頁時暫停刷新，返回後立即刷新。
主題與協作¶
- 支持淺色、深色和跟隨系統。
- 中英文界面跟隨 dsh 語言設置即時切換。
- 可在系統提示中聲明插件，供智能體在餘額過低時提醒用戶充值。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add dsh-balance-display
本地開發模式可使用：
dsh plugin --profile web add link:/path/to/dsh-balance-display
安裝後重啓 dsh web。側邊欄底部會出現餘額膠囊，設置頁會出現「餘額顯示」tab。
典型配置¶
在設置頁「餘額顯示」tab 中，可配置：
- 側邊欄顯示餘額角標。
- 自動刷新間隔；默認爲 10 分鐘。
- 低餘額預警閾值；默認爲
¥5。 - 餘額不足時瀏覽器通知。
- Agent 協作，即在系統提示中聲明插件。
安全與運行邊界¶
- 密鑰全程只在主機端，瀏覽器端只從本機迴環路由拉取脫敏後的餘額 JSON。
dsh web默認僅綁定127.0.0.1，路由僅 GET（餘額）與 GET/POST（announce 配置），不加 CORS 頭。- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 瀏覽器通知需要瀏覽器授權通知權限。
兼容性與環境¶
- 兼容桌面打包版（內嵌 dsh
rc.5）與官網 npm 版dsh web（rc.6）。 package.json要求node >=22.19。
測試¶
主機端測試可運行：
node /tmp/test-balance-host.mjs
客戶端測試可運行：
node /tmp/test-balance-client3.mjs
適用場景¶
適合經常通過 DSH Web 使用 DeepSeek API，希望在不離開 Web 界面時查看餘額、配置低餘額預警、查看近期消耗並快速跳轉充值的開發者。
