dsh-ui-cost：DeepSeek Harness Web UI 的實時 Token 使用量與成本預估插件

前言¶

DeepSeek Harness (DSH) 的 Web UI 提供了基礎的對話統計信息。dsh-ui-cost 插件接管了這一行數據，爲開發者提供實時的 Token 使用量統計和基於官方定價的預估成本。

插件介紹¶

這是一個由 uaapple 維護的純 DSH 瀏覽器插件，遵循 MIT 許可證。它不修改 ui-conversation 核心代碼，因此即便 DSH 或 DSH Desktop 進行升級並恢復默認核心，該插件仍能保持兼容。

插件註冊在 conversation.composer.dock 單元格中，作爲核心統計條目（id: 'stats'）的陰影條目存在，覆蓋了整行數據。

核心功能¶

插件接管了統計行中的以下所有數據：

• 會話信息：輪次（turn）和步驟（step）計數。
• 性能指標：LLM 和工具的運行時間（wall time），TTFT（首字延遲）與解碼吞吐量。
• 緩存狀態：緩存命中率（cache-hit share）。
• 計費數據：計費 token 數量以及基於官方定價的預估成本。

成本計算邏輯：
插件會根據會話當前的模型選擇，對耐久的 tokenUsage 投影進行定價。計算包含未緩存的輸入、緩存寫入（按緩存未命中輸入率）、緩存讀取（按緩存命中率）以及輸出 token。

定價與時段：
價格來源於官方 Models & Pricing 頁面（單位：CNY / 1M tokens）。費率會自動跟隨官方宣佈的峯/谷時段調度：高峯爲北京時間 09:00–12:00 和 14:00–18:00，非高峯時段費率減半。

安裝與啓用¶

通過 DSH 命令行安裝：

dsh plugin --profile web add github:uaapple/dsh-ui-cost

爲確保安裝的可重現性，建議將命令固定到完整的 commit SHA。

如果插件包聲明瞭 dsh.bundle，上述命令會自動掛載該行。若需手動掛載，可在配置中寫入：

- insert:
    - id: ui-cost
      name: dsh-ui-cost

注意事項¶

• 社區插件：該插件爲社區項目，與 DeepSeek AI 無官方隸屬關係。
• 穩定性：如果插件崩潰，陰影單元格會自動退役，恢復顯示默認的統計條。
• 卸載：若通過 cordis.yml 組合該插件，移除組合後默認統計條將恢復顯示。
• 運行環境：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。