前言¶
DeepSeek Harness (DSH) 是一個基於插件化的智能體開發框架。在開發與調試過程中，開發者需要了解當前會話對模型 API 的調用頻次與 Token 消耗情況。官方 Web 界面目前未提供直接的用量統計視圖，手動查看日誌較爲繁瑣。
dsh-usage-info 插件填補了這一空白，它不依賴外部服務，直接在本地基於 DSH 的會話日誌生成統計報表。
功能定位¶
這是一個本地化的用量統計插件，由 shenzhantu 維護。它爲 DSH Web 界面在“設置 -> 插件”下方新增了一個“用量信息”導航項，用於展示今日及本月的 API 調用情況。
核心價值在於回答兩個問題：
1. 今天 / 這個月一共調用了多少次模型 API？
2. 每個模型（廠商/模型）各請求了多少次、用了多少 Tokens？
核心功能¶
- 本地統計與快照：純本地 JSON 持久化，無數據庫依賴。頁面接口直接返回內存快照，打開速度快，無需等待歷史掃描。
- 自動重建與增量同步：服務端啓動後自動從本機會話日誌全量重建歷史統計，之後僅進行增量同步，重啓不丟失數據。
- 分組與排序：按廠商/模型分組統計請求次數與 Tokens。同一廠商的模型排在一起，廠商內部模型按 A-Z 排序。
- 詳細數據維度：支持今日/本月時間視圖切換。包含 Tokens 輸入（區分緩存命中/未命中）及 Tokens 輸出統計。
- 隱私安全：原始數據只讀取 DSH 本機會話日誌，不修改、不上傳任何會話內容。頁面接口僅接受 GET，並校驗請求來自本機迴環地址。
安裝與啓用¶
安裝前請確保已安裝 DSH 的 web profile（版本 @deepseek-ai/dsh >= 0.1.0-rc.6）。
使用官方安裝命令添加插件：
dsh plugin --profile web add "github:<你的GitHub用戶名>/dsh-usage-info"
添加後重啓 dsh web，刷新瀏覽器即可生效。
使用方法¶
- 重啓
dsh web。 - 打開 Web 界面，進入 設置。
- 點擊左側導航中 插件 下方的 用量信息。
- 在頁面頂部切換 本月 或 今日 視圖。
統計口徑¶
插件通過解析 DSH 會話事件進行統計：
- 請求次數：
assistant/message：計 1 次compaction/summary：計 1 次session/title-llm-request：計 1 次（該事件 DSH 不持久化 usage，故 Tokens 爲 0）
- Tokens 計算：
- Tokens 輸入（緩存命中）：來自
cacheReadTokens - Tokens 輸入（緩存未命中）：
inputTokens + cacheWriteTokens - Tokens 輸出：
outputTokens
- Tokens 輸入（緩存命中）：來自
數據與隱私¶
- 存儲位置：統計結果緩存於
~/.dsh/storages/dsh-usage-info.json。刪除該文件後，下次啓動會自動重建。 - 數據來源：全部來自 DSH 本機會話日誌。
- 網絡請求：不計算價格、不查詢官方餘額/賬單、不發起任何上游網絡請求。
適用場景¶
適合需要在本地監控模型調用成本、驗證 API 調用邏輯以及查看緩存命中率的開發者。
結語¶
dsh-usage-info 提供了一種輕量級、隱私友好的方式來追蹤 DSH 的使用情況。所有計算均在本地完成，不涉及敏感數據上傳。
