前言¶
DeepSeek Harness（DSH）的理念之一是「一切皆插件」。在實際運行智能體時，一個常見問題是：多個模型、多個 provider、main 會話和 subagent 會話混在一起時，token 用量、緩存命中率和單次會話消耗分散在會話日誌裏，不容易一眼看清。
dsh-usage-panel 是一個 DSH 插件，在 web GUI 的設置頁「消耗統計」中提供 Token 用量面板，用於查看累計用量、時間趨勢、模型分佈、provider 分佈和高 token 會話。下面介紹它的功能、安裝方式和適用注意。
插件定位¶
dsh-usage-panel 的倉庫位於 AlfredChaos/dsh-usage-panel，許可證爲 MIT。
它面向使用 DSH web profile 的用戶，在設置頁展示 Token 用量 KPI、半年活躍貢獻熱力圖、按模型堆疊柱狀圖與模型環形圖。數據來自 Host 投影聚合與只讀重算會話日誌，插件不會向會話日誌寫回數據。
核心功能¶
累計用量與緩存命中率¶
累計總用量包括：
- 計費輸入 token；
- 計費輸出 token；
- 會話數；
- 最常用模型佔比。
緩存命中率按以下公式展示：
cache read ÷ (uncached input + cache read + cache write)
活躍熱力圖與每日趨勢¶
近六個月活躍熱力圖使用 GitHub 貢獻式佈局，按 UTC 天分桶。
按模型堆疊的每日柱狀圖可切換最近 7、14、30 天，用於觀察模型維度的 token 用量變化。
會話、provider 與模型分佈¶
面板會列出 Top 10 token 最多會話，並標註 main 或 subagent。
當存在多 provider 路由時，會顯示按 provider 的 token 橫向條形圖。
模型環形圖展示模型佔比，並列出 Top 5 模型，附帶每模型緩存命中率。
導出與刷新¶
插件支持導出：
- 完整 JSON；
- 每日 CSV；
- 按模型 CSV。
CSV 導出會做公式注入防護，並按 RFC 4180、UTF-8 BOM 輸出。
插件加載後開始首次掃描。payload 新鮮期爲 10 分鐘；過期 payload 會帶 stale 標誌並後臺刷新。瀏覽器會在 localStorage 中保留最後一次成功 payload。
安裝與啓用¶
先安裝插件，再重啓 DSH web profile，最後打開設置頁。
從 npm 安裝：
dsh plugin --profile web add dsh-usage-panel
也可以從 GitHub 或本地目錄安裝：
dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel
dsh plugin --profile web add ./dsh-usage-panel
安裝後重啓 DSH web profile：
dsh --profile web
然後打開 Settings → Usage，中文界面爲「消耗統計」。
npm 包提供預構建的 lib/ 文件，且無安裝腳本。該插件開發對應 DeepSeek Harness 0.1.0-rc.6，peerDependencies 包含：
"@deepseek-ai/cordis": "^4.0.1",
"react": "^18.3.1"
如果之後需要移除：
dsh plugin --profile web remove dsh-usage-panel
典型用法¶
1、安裝後打開「消耗統計」，先查看累計總用量、緩存命中率和最常用模型佔比。
2、在每日柱狀圖切換最近 7、14、30 天，觀察模型維度的 token 用量變化。
3、查看 Top 10 會話，確認高 token 會話是 main 還是 subagent。
4、如果使用了多個 provider，查看 provider 橫向條形圖，確認 token 分佈。
5、需要歸檔或離線分析時，導出完整 JSON、每日 CSV 和按模型 CSV。
適用場景與注意¶
適合：
- 使用 DSH web profile 的開發者；
- 需要觀察多模型、多 provider 路由下 token 消耗的用戶；
- 需要檢查緩存命中率、模型佔比和高消耗會話的運維或工程師。
注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 統計日桶與導出使用 UTC 日曆日。
- 插件是隻讀聚合，不向會話日誌寫回數據。
- payload 新鮮期爲 10 分鐘，過期會帶
stale標誌並後臺刷新。
結尾¶
dsh-usage-panel 的價值是把分散在會話日誌裏的 token 用量、緩存命中率和模型分佈整理成設置頁裏的可視化面板，便於在 DSH 智能體運行過程中快速定位高消耗會話和模型差異。
參考鏈接：
- GitHub：
https://github.com/AlfredChaos/dsh-usage-panel - 社區目錄頁（獨立站點，與 DeepSeek / 幻方無官方從屬關係）：
https://www.skillhub.cn/plugins/AlfredChaos/dsh-usage-panel
