前言¶

在 DeepSeek Harness (DSH) 的日常使用中，追蹤 Token 消耗和首字延遲對於成本控制和性能優化至關重要。DSH 自身不提供細粒度的統計面板，無法直觀看到按工作區或會話拆分的消耗情況。下面介紹 dsh-usage-stats 插件，它直接讀取本地會話日誌，提供這些數據。

插件介紹¶

dsh-usage-stats 是一個統計每日 token 消耗與平均首字延遲的插件，可按工作區與會話拆分。該插件由 iuuuuuuuu 維護，遵循 MIT 許可證。

核心功能¶

• 按天統計：統計每日的 token 消耗與平均首字延遲，支持按未緩存輸入、緩存讀取、輸出分列。
• 三層下鑽：支持從總覽 → 按工作區 → 按會話的三層明細下鑽。
• 時間篩選：支持時間篩選，包括今天、近 7 天、近 30 天以及自定義區間。
• 交互排序：支持對任意指標列進行排序。
• 默認窗口：默認保留 30 天的統計窗口。
• 訪問入口：設置裏顯示「用量統計」，側邊欄有可開關的柱狀圖圖標。
• 數據來源：只讀本地會話日誌，不修改、不刪除任何既有文件。

安裝與啓用¶

使用以下命令安裝插件：

dsh plugin --profile <profile> add "git+https://github.com/iuuuuuuuu/dsh-usage-stats.git"

安裝完成後刷新頁面，即可在「設置 → 用量統計」中看到統計數據，同時側邊欄也會多出一個柱狀圖圖標。

典型用法¶

進入「設置 → 用量統計」面板，默認顯示今天的數據。用戶可以通過側邊欄的圖標打開獨立全寬麪板，使用時間篩選器查看特定區間的數據，並點擊表頭對「未緩存輸入」、「緩存讀取」或「平均首字延遲」等指標進行排序。

適用場景與注意¶

該插件適合需要對成本進行精細化監控，或需要分析首字延遲表現的用戶。

安裝前應檢查源碼與許可證。插件以當前 DSH 進程權限運行，需注意以下限制：

• 僅支持 zstd 格式：僅支持 zstd 格式的會話日誌，不支持 compression: 'none' 的部署。
• 窗口固定：統計窗口固定 30 天，暫不可配置。
• 只讀權限：插件只讀會話日誌，不修改、不刪除任何既有文件。

結尾¶

dsh-usage-stats 提供了一個純本地、只讀的用量統計方案。通過它，開發者可以更清晰地掌握模型調用的成本構成與性能表現。