前言¶
DeepSeek Harness (DSH) 生態強調插件化與靈活性。在智能體開發或日常使用中，精確掌握每輪對話的 Token 消耗、緩存命中率以及對應的費用是控制成本的關鍵。dsh-cost 插件由 zydg 維護，旨在解決這一痛點。它通過訂閱 DSH 的會話事件流，在每輪對話結束後自動在聊天記錄末尾追加統計行，並提供餘額查詢與數據導出功能。
核心能力¶
- 自動統計行：訂閱
uiConversation事件，在每輪助手回覆結束後自動追加一行統計信息，包含本輪 Token 消耗（輸入/緩存命中/輸出）、緩存命中率、費用估算及 DeepSeek API 餘額。 - 峯谷計價：基於 DeepSeek 官方 V4.1 Flash / V4 Pro 價格表，根據每次調用的實際時間自動判斷高峯/低谷時段進行計費。
- 餘額展示：通過
GET https://api.deepseek.com/user/balance查詢餘額，顯示在統計行末尾及輸入框上方。 - 模型與價格管理：支持在設置頁手動編輯模型、高峯時段及價格，或通過 API (
setPrices,resetPrices) 修改。 - 數據持久化與導出：調用記錄與餘額快照存儲在工作區
dsh-cost/data.json，支持導出爲 CSV 或 JSON。
安裝與啓用¶
通過 DSH 的包管理器安裝插件：
dsh plugin --profile web add github:zydg/dsh-cost
安裝後重啓 Web 應用並刷新頁面即可生效。也可以直接在對話中輸入以下命令，讓 AI 自動執行安裝並重啓：
幫我安裝一下這個dsh plugin --profile web add github:zydg/dsh-cost並重啓
使用與注意事項¶
- 費用與餘額：費用爲估算值，實際以 DeepSeek 官方賬單爲準。需配置
DEEPSEEK_API_KEY才能顯示餘額。 - 數據隱私：記錄僅包含 Token 元數據（不含消息內容或 API Key）。
- 衝突處理：如果其他插件佔用了
/dsh-cost/api路由，需先移除衝突插件。 - 適用範圍：未驗證其他模型/服務商的可用性，僅針對 DeepSeek 官方模型與價格體系設計。
總結¶
dsh-cost 爲 DeepSeek Harness 提供了可視化的成本監控能力，適合需要精細化控制 API 調用成本的開發者。項目開源，可通過 GitHub 訪問源碼：https://github.com/zydg/dsh-cost。
