前言¶
在 DeepSeek Harness (DSH) 中開發智能體時，精確追蹤每輪對話的真實成本以及訂閱資源的剩餘情況是必要的。dsh-turn-cost 是一款 Web 插件，它能在 DSH 界面中直接顯示每輪對話的花費（人民幣，官方峯谷價）、緩存命中佔比，以及訂閱路由（如 Kimi 7天周額度、阿里 Token Plan）的實時額度讀數。
核心功能¶
該插件提供以下核心能力：
- 按對話實際用的路由分流顯示：區分官方按量模型與訂閱路由，分別展示金額或額度信息。
- 顯示官方按量金額（人民幣，峯谷價）：基於 DeepSeek 官方定價計算，支持峯谷價檔位。
- 顯示訂閱路由的 token 與額度讀數：針對 Kimi 7天周額度、阿里 Token Plan 等訂閱制模型顯示剩餘 Token 和額度比例。
- 計算緩存命中佔比：顯示緩存讀 token 佔比，用於評估長對話的緩存效果。
- 會話級累計：在輸入框下方彙總整個會話的消耗數據。
- 支持自定義費率表：允許用戶覆蓋內置的官方定價。
安裝與啓用¶
通過 npm 安裝插件：
dsh plugin --profile web add dsh-turn-cost
安裝後重啓 DSH Web 服務並刷新頁面即可生效。
典型用法¶
在使用過程中，關注界面中的兩個區域：
- 每條回覆下方：顯示該輪的詳細數據。
例如：本輪 ¥0.67 · 332萬 token · 緩存讀 100% - 輸入框下方（官方統計條同一帶）：顯示本會話的累計數據。
例如：本會話 ¥15.42 · 3280萬 token · 緩存讀 99%
對於訂閱路由（如 Kimi），下方會額外顯示官方實時額度讀數：
例如：本輪 12.3萬 token · 7 天還剩 47 次 · 餘額 ¥28.79
配置說明¶
若需自定義費率表，可在配置文件中指定路徑。插件會讀取 dsh.profile.bundles 中的配置項來定位費率文件。
注意事項¶
- 數據安全：只讀取本機數據，不接觸模型 API Key。
- 金額性質：金額僅爲 provider 上報 usage × 費率表的估計值，不構成官方賬單。
- 訂閱顯示：訂閱路由顯示 token 與額度讀數，不編造消耗百分比。
- 未定價模型：未在費率表裏的模型顯示
unpriced。 - 許可證：MIT 許可證。
總結¶
該插件解決了 DSH 用戶對成本透明度和訂閱額度可視化的需求。通過在本地讀取會話日誌並計算，它爲開發者提供了直觀的成本與資源監控。
