前言¶
在使用 DeepSeek Harness 進行對話實驗或調試時，控制 API 成本是常見需求。雖然 Harness 自身統計了 Token 用量和耗時，但缺乏直觀的費用展示，難以實時估算單輪對話或整個 Session 的支出。dsh-cost 插件通過讀取 Harness 的 Token 投影數據，爲 Web 會話提供了可視化的費用估算。
功能¶
該插件提供以下核心能力：
- 本輪費用與 Session 累計費用：每輪迴答結束後顯示本輪的花費，並累計整個 Session 的總花費。
- 明細麪板：點擊費用標籤可展開詳細計算過程，包含使用的模型、計價時段（峯/谷）以及各 Token 桶的用量與單價明細。
- 緩存命中率：顯示 Prompt 中被緩存命中的比例。
- DeepSeek 分時段計價：支持 DeepSeek 的峯/谷時段計價邏輯，自動識別週末和節假日。
- 只讀模式：插件僅讀取 Harness 的 token 投影，不發送請求，不修改會話，不觸碰模型 API。
- 可擴展價目表：基於數據驅動的價目表註冊機制，可輕鬆擴展支持其他廠商的計費。
安裝¶
安裝前請確保環境滿足要求：DeepSeek Harness 版本需大於等於 0.1.7-rc.1，且 Node.js 版本需大於等於 18。
執行以下命令進行安裝：
dsh plugin --profile web add @jackguo0310/dsh-cost
安裝後，如果 dsh web 正在運行，需要重啓一次該進程，刷新頁面即可生效。
用法¶
安裝完成後，啓動 Web 會話：
dsh web
在對話回覆的下方，費用膠囊會顯示在 DSH 自帶的 Token 和時間膠囊下方。格式通常爲：本輪 ¥x · 累計 ¥y · 緩存 z%。
點擊費用膠囊，可以查看具體的計價明細。
注意事項¶
- 估算性質：插件顯示的是估算值，並非官方賬單。DeepSeek 的官方計費爲準。緩存命中率、計價窗口邊界及法定節假日在計算上可能存在細微差異。
- 計價窗口邏輯：計價窗口由回合的完成時間決定。如果一輪對話跨越了峯/谷時段的邊界，該輪對話的計價會完全歸屬到一側（基於完成時間判定）。
- 跨模型切換：如果一輪對話中切換了模型（例如重試），該輪無法按模型拆分計價，將統一按首個模型的價格計算，並標記爲估算值。
- Session 總計範圍：Session 的累計費用僅覆蓋已加載的回合，未加載的歷史回合不計入總計。
- 環境依賴：插件依賴 DeepSeek Harness 的特定客戶端接口，若 Harness 版本更新導致接口變化，插件可能無法正常工作。
結語¶
dsh-cost 通過輕量級的方式解決了 DeepSeek Harness 用戶的成本追蹤痛點。它不僅展示了當前的消費情況，還提供了詳細的計算邏輯，方便開發者根據緩存命中率和分時段計價優化提示詞。如需修改價格表或添加其他廠商支持，可參考源碼中的配置。
