DeepSeek Harness 插件：dsh-usage-stats-plus 用量與餘額面板增強

前言¶

DSH（DeepSeek Harness）採用「一切皆插件」的架構。對於智能體開發者而言，用量與餘額的監控是剛需。dsh-usage-stats-plus 是一個針對官方面板的增強插件，旨在解決本地估算不準、缺乏全渠道消耗追蹤的問題。它 fork 自 dsh-usage-stats，由 Nixz0824 維護，採用 MIT 協議。

核心功能¶

該插件主要包含以下能力：

• 官方餘額實時拉取：直接調用 /user/balance 接口獲取餘額，不依賴本地估算。
• 逐事件精確計價：基於官方峯谷價目表，對會話日誌中的每個事件進行精確計費。
• 全渠道消耗估算：通過官方餘額接口的每日快照差值計算消耗，能對齊開放平臺賬單口徑（需前一日快照，次日生效）。
• Codex 風格活動時間軸：提供 12 個月滾動視圖，支持每日/每週/累計三種視圖。
• 黑白灰單色系 UI：與 DeepSeek 官方鯨魚 Logo 同源的視覺風格，支持明暗主題自適應。
• 無額外依賴：純 JavaScript 實現，無需構建步驟，無新增運行時依賴。

安裝與啓用¶

插件倉庫爲公開狀態，可通過以下命令安裝。推薦使用 GitHub Release 預構建包：

dsh plugin --profile web add https://github.com/Nixz0824/dsh-usage-stats-plus/releases/latest/download/dsh-usage-stats-plus-0.3.0.tgz

或者從 GitHub 源碼安裝：

dsh plugin --profile web add github:Nixz0824/dsh-usage-stats-plus

安裝完成後，刷新瀏覽器頁面以加載客戶端資源，並重啓 dsh web 以確保側邊欄條目正確顯示。

配置與計價口徑¶

插件支持通過配置覆蓋價格。在 cordis.patch.yml 中添加 insert 條目：

- insert:
    - id: usage-stats
      name: dsh-usage-stats-plus
      config:
        prices:
          "deepseek-v4-pro": { peak: { hit: 0.30, miss: 9.0, output: 27.0 }, offpeak: { hit: 0.15, miss: 4.5, output: 13.5 } }
          # 其他模型可在此補充

計價基於官方價格文檔（2026-08-17 生效），包含緩存命中、輸入未命中、輸出三種計費維度。高峯時段判定基於北京時間。

注意事項¶

• 緩存計費：緩存寫入按輸入未命中價計費。
• 時區限制：高峯時段判定嚴格基於北京時間，與機器時區無關。
• 未知模型：除了 V4-Pro 和 V4-Flash 外，其他模型默認不計價，顯示爲 unknown。
• 全渠道估算：全渠道消耗估算需要前一日餘額快照，數據在次日生效。
• 版權保留：保留上游 dsh-usage-stats contributors（2026）的版權聲明。

該插件通過重構計價引擎與 UI，爲 DSH 用戶提供了更貼近官方賬單的消耗視圖。源碼與文檔見下方鏈接。

• 插件目錄頁
• GitHub 倉庫