在 DeepSeek Harness（DSH）生態中，管理智能體或對話的成本與資源消耗是一個常見需求。雖然 DeepSeek 開放平臺提供賬單，但往往存在延遲或不夠直觀。dsh-show-me-how-much 插件旨在填補這一空白，提供實時的本地估算與詳細統計。
核心功能¶
這個插件主要解決 Web 端的用量與費用追蹤問題，具備以下能力：
- 實時展示：在會話底欄最右側實時顯示估算費用和總 Token。
- 統計面板：進入「設置 → 費用統計」，可查看按日期、時間的統計，包含緩存命中率、按日趨勢及模型明細。
- 模型識別與自定義：自動區分 DeepSeek V4 Flash 與 V4 Pro，並支持自定義回退價格。
- 持久化與回放：利用 Harness 的 Projection 機制，重新打開歷史會話仍可重放統計。
- 計數邏輯：流式 usage 與最終 message 採用替換語義，不會重複累計。
安裝與啓用¶
使用官方提供的命令進行安裝：
dsh plugin --profile web add github:kam74515-boop/dsh-show-me-how-much#v0.1.0
安裝完成後，重啓 Harness Web 服務：
dsh web
價格與計費邏輯¶
插件默認使用 DeepSeek V4 人民幣官方價格表（2026-08-15）進行計算。費用計算公式如下：
(緩存命中輸入 × 命中價 + (未命中輸入 + 緩存寫入) × 未命中價 + 輸出 × 輸出價) / 1,000,000
默認價格配置如下：
| 模型 | 緩存命中輸入 | 未命中輸入 | 輸出 |
|---|---|---|---|
| DeepSeek V4 Flash | ¥0.02/M | ¥1/M | ¥2/M |
| DeepSeek V4 Pro | ¥0.025/M | ¥3/M | ¥6/M |
插件會識別 Harness 返回的 uncachedInputTokens、cacheReadTokens、cacheWriteTokens 和 outputTokens。如果 provider 報告了緩存寫入 Token，該部分將按未命中輸入計價。
本地開發¶
如果你需要查看源碼或進行本地調試，可按以下步驟操作：
git clone https://github.com/kam74515-boop/dsh-show-me-how-much.git
cd dsh-show-me-how-much
npm install
npm run check
dsh plugin --profile web add .
注意事項¶
- 估算值性質：金額是基於 provider 返回用量與當前價格表的估算值，不等同於 DeepSeek 開放平臺賬單。
- 第三方 Provider：贈送餘額、折扣、價格調整和第三方 provider 可能造成差異。
- 版本依賴：項目針對 DeepSeek Harness
0.1.0-rc.6開發。Harness 目前仍處於 Developer Preview，後續版本可能需要同步插件 API。
總結¶
dsh-show-me-how-much 是一個專注於實用性的統計插件，能夠幫助開發者快速掌握對話成本與 Token 消耗。插件基於 MIT 許可證開源，維護者爲 kam74515-boop。
