dsh-usage-meter：DeepSeek Harness 模型用量儀表盤插件

前言¶

在使用 DSH（DeepSeek Harness）進行智能體開發時，需要直觀地掌握模型調用成本與效率。現有方案往往依賴手動統計或外部工具。dsh-usage-meter 插件通過在設置頁新增「用量」板塊，按服務商和模型聚合全部會話的 token 用量，並提供時間趨勢圖。

是什麼¶

該插件由 V-dev-388 維護，基於 MIT 協議。它利用官方 Cordis 服務被動監聽會話事件，將數據落盤在本地，不依賴任何第三方庫。其核心價值在於提供零外部依賴、本地化、可查詢的用量統計能力。

核心功能¶

1. 彙總指標：顯示請求數、總 Token、緩存命中率、輸入 Token、輸出 Token、緩存讀取 Token。
2. 時間維度：支持今日（24 根小時柱）、近 7 天、近 30 天（按天柱），並自動根據本地時區切日。
3. 多維度視圖：提供服務商表和模型表，分別展示各項指標。
4. 刷新機制：支持 60s 自動輪詢與手動刷新。
5. 數據覆蓋：統計全部會話（含子 agent 會話）。
6. cc-switch 同步：支持將用量數據同步到 cc-switch，實現統一統計。

安裝與啓用¶

使用官方 CLI 安裝：

dsh plugin --profile web add dsh-usage-meter

安裝後重啓 dsh web（或刷新頁面加載 client bundle），進入 設置 → 用量 即可查看。

典型用法¶

• 查看儀表盤：在設置頁的「用量」板塊查看彙總卡和趨勢圖。
• API 查詢彙總：

    GET /dsh-usage-meter/summary?range=today\|7d\|30d

• API 查詢會話明細：

    GET /dsh-usage-meter/sessions

• 關閉 cc-switch 同步：

    export DSH_CC_SWITCH_SYNC=0

適用場景與注意¶

• 適用場景：適合需要監控每日 token 消耗、評估緩存命中率、按模型維度分析調用情況的開發者。
• 注意：插件僅使用官方 Cordis 服務（sessions / fs / sessionQuery / webServer），無外部依賴。數據完全本地化，不聯網、無遙測。數據存儲於 $DSH_HOME/storages/usage-meter.json（原子寫入）。

結尾¶

該插件提供了一個輕量級的本地用量統計方案，適合對隱私敏感或希望集成到現有工作流中的用戶。源碼與文檔位於 GitHub。