zcode-usage-stats：DSH 本地 Token 用量統計面板

DeepSeek Harness (DSH) 的設置頁目前缺乏對 Token 用量的可視化。zcode-usage-stats 是一個非官方插件，在設置頁增加了一個統計面板，用於查看全歷史會話的 Token 消耗情況。

插件定位¶

該插件由 Amer-CN 維護，屬於社區插件，與 DeepSeek / ZCode 無關聯。它採用純本地掃描與渲染，數據不出本機。

核心功能¶

1. 全歷史會話本地掃描與聚合：讀取本地會話文件，按天、按小時、按模型進行聚合。
2. 日曆點陣熱力圖：展示每日活躍度，支持每日/每週/累計分桶。
3. 多模型用量趨勢：折線圖展示各模型的用量趨勢，支持懸停查看分項。
4. 刻度環儀表盤：展示模型用量佔比。
5. 自定義時間範圍篩選：支持今天、昨天、近7天、近30天、本月、上月、全部及自定義區間。
6. 深淺雙主題支持：跟隨 DSH 的深淺主題，滿足 WCAG AA 對比度合規。
7. 統計指標：累計 Token、單日峯值、最長會話時長、連續天數。

安裝與啓用¶

前置要求：已安裝 @deepseek-ai/dsh（及 DSH 插件命令依賴的 pnpm）。

dsh plugin --profile web add zcode-usage-stats

安裝後重啓 DSH 進程，打開 設置 → 使用統計 即可看到統計頁面。

使用方式¶

1. 切換時間範圍：頂部切換時間範圍，’全部’選項顯示所有歷史數據。
2. 查看趨勢：趨勢圖懸停查看各模型分項，點擊圖例顯隱對應模型。
3. 刷新數據：點擊’刷新’按鈕強制重新掃描全部會話。

技術細節¶

• 零依賴圖表：使用手寫 SVG 繪製圖表，無運行時圖表庫依賴。
• 雙層緩存：採用內存 + 磁盤雙層緩存（SWR），首屏加載不卡頓。
• 安全機制：/api/usage-stats 通過宿主信任柵欄鑑權。

注意事項¶

• 非官方插件：與 DeepSeek / ZCode 無關聯。
• 數據安全：純本地掃描、本地聚合、本地渲染，數據不出本機。
• 依賴版本：鎖定 @deepseek-ai/dsh >= 0.1.0-rc.5。