前言¶
在 DeepSeek Harness（dsh）的插件化思路下，web GUI 可以通過插件擴展頁面能力。使用 dsh web 時，DeepSeek API 的剩餘額度、今日與本月用量、當前會話費用通常不在同一視圖裏。
jiangli07/dsh-deepseek-quota-bar 是一個 web 插件，把這類信息做成右下角懸浮卡片，用血條顯示剩餘餘額與月初餘額比例，並展示今日與本月使用量、當前會話費用和峯谷時段提醒。
下面介紹它的定位、功能、安裝、配置和使用注意點。
這是什麼¶
dsh-deepseek-quota-bar 是 DeepSeek API 額度血條插件，面向 DeepSeek Harness (dsh) web GUI。維護者爲 jiangli07，許可證爲 MIT。
它解決的是在 dsh web 頁面內查看 DeepSeek API 額度與使用量的問題：右下角顯示餘額比例、今日/本月使用量、當前會話費用，並提供峯谷時段與界面顯示相關控制。
核心功能¶
額度血條¶
- 以血條顯示 DeepSeek API 剩餘餘額與月初餘額比例。
- 血條顏色閾值：
≥50%顯示綠色≥20%顯示橙色<20%顯示紅色
今日與本月使用量¶
- 配置
DEEPSEEK_PLATFORM_TOKEN後，使用官方精確數據。 - 未配置時，使用餘額差值估算。
- 估算與月初餘額快照等狀態持久化在：
~/.dsh/storages/deepseek-quota-bar.json
當前會話費用¶
- 按官方價格表對當前會話日誌計價。
- 包含安裝前歷史。
峯谷時段提醒¶
- 顯示高峯徽標。
- 顯示距下一時段切換的倒計時。
- 顯示當前模型單價。
- 支持
Flash/Pro點擊切換。
界面控制¶
- 卡片可拖動，位置持久化到
localStorage。 - 可摺疊爲只顯示血條的迷你卡。
- 可調透明度範圍爲
0-100%，並持久化。 - 跟隨淺色/深色主題。
- 餘額每
60秒自動刷新，也支持手動刷新。
安裝與啓用¶
包名安裝¶
執行：
dsh plugin --profile web add dsh-deepseek-quota-bar
安裝後重啓 dsh web：
dsh web
打開頁面後強刷：
Ctrl+Shift+R
右下角出現卡片。
本地開發安裝¶
git clone https://github.com/jiangli07/dsh-deepseek-quota-bar.git
cd dsh-deepseek-quota-bar
dsh plugin --profile web add .
如果修改了客戶端實現：
lib/client.js
需要重啓 dsh web，等待 bundle 引導哈希重新生成後再強刷頁面。
典型用法¶
配置憑證¶
必需憑證：
DEEPSEEK_API_KEY
可選憑證，用於官方精確用量：
DEEPSEEK_PLATFORM_TOKEN
將憑證配置到：
~/.dsh/.credentials.yaml
配置後無需重啓，下一次刷新即生效。
查看額度與用量¶
安裝並配置後，打開 dsh web 頁面，卡片會顯示：
- 剩餘餘額與月初餘額比例對應的血條。
- 今日與本月使用量。
- 當前會話費用。
- 峯谷時段提醒。
- 透明度、拖動、摺疊等界面控制。
適用場景與注意¶
- 適合在 dsh web GUI 中使用 DeepSeek API，並希望在頁面內查看額度、用量和會話費用的開發者。
- 如果只需要大致用量，可以不配置
DEEPSEEK_PLATFORM_TOKEN；此時今日/本月使用量會使用餘額差值估算。 - 該倉庫位於 GitHub，許可證爲 MIT；不要把它理解爲 DeepSeek 官方應用商店。
- 插件以當前 dsh 進程權限運行。安裝前建議檢查源碼、依賴與許可證。
- 許可證信息：MIT。Fork 自
yingjunnan/dsh-deepseek-quota（MIT）；定價引擎參考dsh-web-billing（MIT）。
結尾¶
dsh-deepseek-quota-bar 將 DeepSeek API 額度、用量與當前會話費用集中到 dsh web 頁面中，適合作爲開發過程中的輕量監控組件。
倉庫地址：
https://github.com/jiangli07/dsh-deepseek-quota-bar
