前言¶
DeepSeek Harness (DSH) 採用了插件化架構，允許開發者根據需求靈活擴展功能。在本地調試或部署智能體時，實時掌握 DeepSeek API 的真實 token 消耗並控制成本是一個關鍵需求。lstalu/dsh-quota-meter-plus 是一個 DSH 會話額度監控增強版插件，旨在解決缺乏直觀計費反饋和預算控制的問題。
核心功能¶
該插件主要提供以下能力：
- 真實 token 計費：按模型 × 可配置價目表記賬，支持緩存命中、未命中及輸出分檔計費。
- 實時進度條：輸入框上方顯示消耗進度條，請求發起時左側有脈動效果，扣費瞬間彈出金額徽標。
- 額度耗盡攔截：達到預算上限時自動攔截新的模型調用。
- 峯谷定價：支持按時間段（高峯/空閒）調整價格，支持自定義時區。
- 週末優惠：支持週六/週日全天按空閒價計費。
- 會話獨立記賬：記賬按會話獨立，子代理消耗自動併入父會話額度，額度條顯示真實總花費。
- 餘額校準膠囊：右上角懸浮窗，顯示官方餘額、實測消耗及本會話已花/剩餘。
安裝與啓用¶
任意裝有 DSH 的機器均可通過以下命令安裝。Client 端（進度條/彈層 UI）刷新瀏覽器即生效，Host 端（記賬/攔截）需重啓 dsh web 進程。
dsh plugin --profile web add github:Lstalu/dsh-quota-meter-plus
使用與配置¶
安裝後，插件會在輸入框上方顯示消耗進度條，並在右上角顯示餘額校準膠囊。點擊膠囊內的刷新按鈕可手動更新數據。API Key 也通過膠囊保存，落盤至 ~/.dsh/storages/quota-meter/config.（僅本機）。
注意事項¶
- 升級注意：默認價目表隨版本更新，但本機
prices.json（如已存在）會覆蓋默認值。升級到含新價格的版本後，需在價格彈層點「重置」或刪除配置文件以更新默認價。 - 同源防護：帶 Origin 的請求要求其 host 與請求 Host 頭完全一致，跨源一律 403。
- 計價基準：官方 2026-08-21 頁面爲美元價，此處按當日人民幣兌美元中間價 6.78 折算。
