dsh-token-usage：DeepSeek Harness Token 用量儀表盤

DeepSeek Harness (DSH) 提供了插件擴展機制，開發者在使用模型進行對話或任務執行時，通常需要追蹤 token 消耗量與調用頻率。dsh-token-usage 插件通過聚合 session 日誌，在設置頁提供了一個可視化的用量統計界面，解決手動查日誌統計繁瑣的問題。

核心功能¶

該插件在設置頁提供以下統計視圖：

• 指標卡：展示總體使用量的概覽數據。
• 活躍熱力圖：可視化展示調用活躍時段。
• 按天趨勢：包含 Top 5 模型的堆疊柱狀圖與緩存命中率折線圖。
• 模型佔比環圖：展示各模型的使用比例分佈。
• 設置頁用量統計 UI：將上述視圖掛載至 DSH 的設置菜單中。

安裝與啓用¶

命令行安裝：

dsh plugin --profile <profile> add https://github.com/felixzhang-glitch/dsh-token-usage

本地開發安裝：
使用本地倉庫的絕對路徑安裝（例如 /Users/name/dsh-token-usage）。本地目錄安裝爲活鏈接，修改代碼後重啓 DSH 即可生效。

界面操作：
1. 打開 DSH 側邊欄「插件」→「添加插件」。
2. 輸入 GitHub 倉庫地址或本地絕對路徑。
3. 安裝完成後重啓 DSH。

典型用法¶

1. 數據來源確認：確保模型請求返回的數據中包含 usage 字段，否則統計結果將爲空。
2. 啓用與刷新：在插件頁確認該包已啓用，然後進行瀏覽器硬刷新（或重啓 DSH）。
3. 日誌排障：若頁面一直顯示加載中或條目爲空，檢查診斷日誌 ~/.dsh/profiles/<profile>/.plugin-manager/logs。

注意事項¶

• NPM 包區分：本插件不發佈 npm。npm 上的同名包（如 Tastelessor/dsh-usage-stats）爲第三方帶計價包，對話框輸入裸包名安裝的並非本插件。
• 版本要求：建議在 DSH 0.1.7-rc.2（桌面版）或 0.1.6-alpha.2（web）環境下使用。
• 生效方式：裝完必須重啓 DSH 才能生效（桌面版 profile 無 live 重載）。