前言¶

在 DeepSeek Harness（DSH）的 Web 界面中，開發者通常需要追蹤當前會話的 token 使用量和速率，但缺少一個直觀的、聚合的實時花費計算。dsh-ui-cost-meter 插件通過讀取 Harness 的 token 日誌，結合配置的費率，在 composer 下方展示當前會話的總花費。

是什麼¶

這是一個 Web GUI 客戶端插件，由用戶 yuu1111 維護。它的核心作用是在現有的統計信息旁，增加一個顯示當前 Session 總花費的“pill”組件。該數值基於 Harness 已記錄的 provider 使用量，乘以配置的每百萬 token 費率計算得出。

核心功能¶

1. 實時花費顯示：顯示當前會話已產生的花費。
2. Cost Pill：以膠囊形式顯示在 composer 下方，與系統自帶的步驟/令牌統計並列。
3. 基於費率定價：花費由 Harness 已記錄的 provider 使用量乘以配置的每百萬 token 費率計算得出。
4. 未定價 Token 追蹤：如果某個路由沒有配置費率，其 token 會被標記爲“未定價”（末尾帶 +），並在面板中列出。
5. 緩存追蹤：支持緩存命中、讀取和寫入的追蹤。

安裝與啓用¶

通過官方 CLI 安裝該插件：

dsh plugin --profile web add dsh-ui-cost-meter

配置¶

在插件配置中指定貨幣符號和費率。費率單位爲每百萬 token。每個路由（provider/model）只能配置一個費率。你需要將示例中的費率替換爲實際支付費率。

- id: cost-meter
  name: dsh-ui-cost-meter
  config:
    symbol: '$'
    rates:
      <provider>/<model>:
        input: 0.15
        output: 0.6
        cacheRead: 0.003
        cacheWrite: 0

注意事項¶

1. 非賬單記錄：顯示的數值是 Harness 的 token 統計乘以你配置的費率，不是提供商的正式賬單。費率配置錯誤會導致顯示錯誤。
2. 單路由單費率：每個路由只能有一個費率。如果會話中路由價格發生變化，需確保配置反映當前實際支付價格。
3. 貨幣自定義：通過 symbol 字段自定義貨幣符號，插件不進行跨貨幣轉換。

總結¶

dsh-ui-cost-meter 爲 DSH Web 界面增加了實時的成本追蹤能力。開發者可以根據實際支付費率配置插件，在開發過程中快速評估單次會話的開銷。更多細節可查看項目目錄或源碼倉庫。

• GitHub: https://github.com/yuu1111/dsh-ui-cost-meter