在 DeepSeek Harness（DSH）的開發工作中，需要實時掌握賬戶餘額、瞭解峯谷計價時段，以及估算今日的 API 消耗。dsh-web-quota-meter 插件在 DSH Web 界面右下角提供了一個額度儀表盤，屬於可插拔組件。
核心功能¶
該插件提供以下功能：
- 顯示官方餘額：通過官方公開接口獲取當前賬戶餘額。
- 顯示今日已消耗：基於本地估算，即“當日基線餘額 − 當前餘額”。
- 顯示峯谷計價時段：按北京時間（UTC+8）顯示當前是峯時（9:00–12:00、14:00–18:00）還是谷時。
- 可配置重置時間：支持自定義每日重置時間，默認爲 05:00。
- 可插可卸：支持通過官方插件機制安裝、卸載和升級。
安裝與啓用¶
使用官方插件機制安裝，安裝後重啓 dsh web 即可自動加載。
dsh plugin --profile web add github:wangfujian762/dsh-web-quota-meter
安裝成功後，API Key 會自動存入官方憑證庫，重啓 dsh web 後免重填。以後每次啓動 DSH Web，該插件都會自動加載。
卸載與升級¶
卸載或升級插件使用以下命令：
# 卸載
dsh plugin --profile web remove dsh-web-quota-meter
# 升級
dsh plugin --profile web update dsh-web-quota-meter
插件配置文件位置通常在 ~/.dsh/profiles/web/cordis.patch.yml。
工作原理與注意事項¶
- 餘額來源：插件向官方接口
GET https://api.deepseek.com/user/balance發送請求，需攜帶Authorization: Bearer <你的 API Key>。API Key 僅存入官方憑證庫，代碼中不含任何密鑰，不會發送至 DeepSeek 之外的任何地址。 - 今日消耗：這是一個本地估算值。插件會在每日重置時間（默認 05:00）記一次餘額爲基線，之後用基線減當前餘額計算。如果在此期間充值，顯示的消耗數值會偏小。插件重啓後，“今日已消耗”的基線會重置。
- 重置時間：重置時間目前僅存內存，重啓 DSH 後會回到默認的 05:00。
- 峯谷時段：基於北京時間計算，對應 DeepSeek 的峯谷定價方案。
生態背景¶
DSH 理念是“一切皆插件”，該插件由社區開發者 wangfujian762 維護，遵循 MIT 許可證。更多細節可參考 GitHub 倉庫。
