DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在使用 API 進行開發或調試時，開發者需要實時掌握賬戶餘額、當前會話的花費以及不同模型的價格差異。dsh-usage-monitor 插件將 DeepSeek API 的官方定價、會話用量花費、累計花費和賬戶餘額集成到了 DSH 界面中。
功能¶
本插件提供以下能力：
- 賬戶餘額：顯示總餘額、充值餘額和贈金，支持手動刷新。
- 本會話花費：按模型和時段增量計價，切換模型時數字不會跳變；若賬本尚未記錄該會話，則退回本地估算並標註「估算」。
- 模型明細：按模型分桶記錄 token 與金額，分別展示 Flash 與 V4-Pro 的詳情。
- 累計花費：本地賬本記錄跨會話用量，採用增量計價，跨高峯/空閒時段也能準確累計；不打開面板也會持續記錄。
- 自動定價：內置官方定價，自動區分高峯與空閒時段。
- 雙入口：在對話主視圖新增「用量」Tab 展示完整面板，在輸入框上方 dock 條常駐顯示餘額、本會話花費、當前模型單價和計價時段。
安裝¶
安裝前請確保已安裝 DSH，並使用 web profile。運行以下命令安裝：
dsh plugin --profile web add github:liyiersan/dsh-usage-monitor
也可以從本地目錄安裝：
dsh plugin --profile web add /path/to/dsh-usage-monitor
安裝後，重啓 DSH：
dsh web
使用¶
在打開的 Web 界面中，通過環境變量 DEEPSEEK_API_KEY 或配置文件 ~/.dsh/.credentials.yaml 設置 API Key。配置完成後，在對話主視圖頂部即可看到「用量」Tab，或在輸入框上方看到用量 dock 條。
定價與計費¶
插件內置官方定價，自動區分高峯與空閒時段。高峯時段爲北京時間週一至週五 09:00-12:00、14:00-18:00，空閒時段價格爲高峯的一半。計費單位爲元 / 百萬 tokens。
| 模型 | 時段 | 緩存命中 | 緩存未命中 | 輸出 |
|---|---|---|---|---|
| DeepSeek-V4.1-Flash | 空閒 | 0.02 | 1 | 4 |
| DeepSeek-V4.1-Flash | 高峯 | 0.04 | 2 | 8 |
| DeepSeek-V4-Pro | 空閒 | 0.15 | 4.5 | 13.5 |
| DeepSeek-V4-Pro | 高峯 | 0.3 | 9 | 27 |
計費規則：
* cacheRead（緩存命中輸入）按緩存命中單價；
* uncachedInput（緩存未命中輸入）按未命中單價；
* output 按輸出單價；
* cacheWrite（寫入緩存）按未命中單價保守計算；
* 無法識別的模型名按 Flash 兜底並在界面標註。
金額由本地賬本按增量計價得出，與官方賬單口徑一致。
隱私與安全¶
- 不收集數據：插件不收集、不上傳遙測數據。
- Key 安全：不保存 API key；key 僅由 DSH credentials 服務或進程環境變量提供。
- 餘額查詢：僅發生在宿主側，目標爲
api.deepseek.com。 - 本地賬本：保存在
$DSH_HOME/usage-monitor/ledger，只記錄會話 ID、token 用量及按模型分桶的金額，不會提交到倉庫。 - 建議：不要將本地賬本或憑據文件提交到 Git。
兼容性與維護¶
- 兼容 DSH
0.1.5-rc.1(web profile) 和0.1.1-rc.2。 - 價格調整需同時修改
lib/pricing.js和lib/client.js。
結語¶
該插件適合需要在調試過程中實時監控成本的開發者。更多細節可參考其 GitHub 倉庫。
