DeepSeek Harness 費用實時統計插件 (dsh-cost-tracker)

在 DeepSeek Harness（DSH）的插件生態中，監控 API 調用的成本是精細化管理的重要一環。特別是面對不同模型的定價、緩存命中與未命中的差異，以及高峯/空閒時段的費率變化，手動統計往往難以做到實時與精準。az790871109/dsh-cost-tracker 旨在解決這一需求，它作爲 DSH 的一個 Profile 插件，提供實時的費用統計與後臺餘額管理功能。

功能特性¶

該插件通過監聽 llm/stream 事件實現實時計費，主要具備以下能力：

實時計費與精準累加：監聽模型調用流，即時累加 token 數量。
精確計價模型：支持按模型區分單價，區分緩存命中與未命中的 token，支持高峯與空閒檔位切換。
純人民幣展示：默認匯率 7.2，面板支持手動調整匯率。
後臺餘額管理：提供充值入口，實時顯示餘額、本週期消耗及剩餘額度。
項目與對話彙總：面板頂部展示當前對話所在項目的費用總和，下方顯示逐條對話的明細。
交互式懸浮面板：面板可拖拽、可摺疊，顏色跟隨 DSH 主題。
模型可查：註冊了 deepseek_cost 工具，可直接詢問模型查看費用。
跨進程持久化：統計狀態寫入本地文件，重啓後繼續累加。
零侵入自動啓動：作爲 profile 插件隨 DSH 啓動加載，無需額外激活。

安裝與啓用¶

安裝過程包含文件複製與配置修改，具體步驟如下：

    mkdir -p "$DSH_HOME/profiles/web/node_modules"
    cp -R . "$DSH_HOME/profiles/web/node_modules/dsh-cost-tracker"

修改配置文件以加載插件。在 $DSH_HOME/profiles/web/cordis.patch.yml 末尾追加以下內容：

    - insert:
        - id: cost-tracker
          name: dsh-cost-tracker

重啓 DSH Web 服務：

    pkill -f "dsh/lib/bin.js web"
    dsh web

重啓後打開頁面，右下角將出現費用懸浮面板。

使用方法¶

安裝完成後，可通過面板或對話直接操作：

查看費用：在對話中直接詢問模型「我花了多少錢」，或查看面板主讀數。
充值管理：在面板輸入框輸入金額並點擊「充值」。
切換檔位：點擊面板按鈕切換計費檔位（自動/空閒/高峯）。
修改匯率：在面板底部「匯率」輸入框調整數值。
清零統計：點擊面板「清零」按鈕重置所有數據。
面板交互：按住標題欄拖動面板，單擊標題欄摺疊或展開。

注意事項¶

使用前需注意以下幾點限制與依賴：

數據性質：這是本機估算值，並非官方賬單，與官方賬單可能存在偏差。
統計範圍：只統計插件加載後的調用，歷史消息不計入。
價格同步：價格表硬編碼在 lib/index.js 的 BASE_PRICES 中，官方調價後需手動更新源碼。
狀態文件：刪除 $DSH_HOME/storages/cost-tracker-state. 即可清零。
生效方式：修改 cordis.patch.yml 或源碼後，必須重啓 dsh web 才能生效。
React 依賴：Client 端必須使用 factory: function (require) + require("react") 獲取 React，不能用全局 React，否則渲染會報錯。
依賴環境：Host 端依賴 tools 和 webServer，Client 端依賴 slots（來自 @deepseek-ai/dsh-client-runtime）。

生態信息¶

維護者：az790871109
許可證：MIT
倉庫地址：https://github.com/az790871109/dsh-cost-tracker