在使用 DeepSeek Harness (DSH) 進行開發或日常對話時，缺乏可視化的用量統計容易導致成本失控。這個插件通過後臺靜默採集，解決了從會話日誌回填數據以及實時監控費用的問題。
插件簡介¶
dsh-usage-guard 是 DSH Web GUI 的用量統計面板。由 hb-degithub 維護，專注於後臺靜默採集、按模型分析、費用估算及每日超限守衛。
核心功能¶
- 靜默採集：掛鉤會話事件，按天、提供商、模型維度摺疊 token 用量。支持重啓不丟數據，首次運行自動從會話日誌回填。
- 儀表盤：包含六張統計卡（tokens、會話數、消息數、活躍天數、連續天數、最常用模型）、GitHub 風格活躍熱力圖（年度視圖、星期/月份標註、逐日懸浮詳情）、多序列趨勢圖（輸入/輸出/緩存命中/緩存創建/成本，雙軸，7/30 天切換）、模型用量環形圖。
- 費用估算：支持按模型配置價格（每 1M tokens 的 輸入/輸出/緩存讀/緩存寫）。內置 DeepSeek 刊例價。未配置價格的模型不計費，不會進行猜測。
- 每日超限守衛：可選每日 token 或費用上限。
warn模式顯示全局橫幅提醒，block模式在請求發出前攔截。 - 中英雙語：跟隨 DSH 主題令牌，無外部運行時依賴。
安裝與啓用¶
通過命令行安裝：
dsh plugin --profile web add dsh-usage-guard
安裝完成後重啓 dsh web，在設置菜單中打開 使用統計 即可查看面板。
典型用法¶
安裝完成後，訪問 設置 → 使用統計。插件支持從插件市場（設置 → 插件市場）或 GitHub 一鍵安裝。
適用場景與注意¶
- 適用場景：需要精細化控制 token 消耗和預算的開發者。
- 權限注意：插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。
結語¶
dsh-usage-guard 提供了一個輕量級的用量監控方案，內置 DeepSeek 刊例價，避免盲目猜測成本。該項目採用 MIT 許可證。
