DeepSeek Harness (DSH) 採用插件化架構，在使用過程中，開發者往往需要追蹤 Token 消耗、模型調用頻率以及技能的使用模式。DSH 原生環境缺乏細粒度的可視化分析入口。dsh-usage-analytics 插件通過本地索引計算，在設置頁提供可視化的用量洞察，滿足個人或小團隊對使用數據的追蹤需求。
插件定位¶
這是一個本地優先的個人用量分析插件。作者爲 3361805598-gif，採用 MIT 許可證。它不依賴遠程服務，直接在本地生成 1/7/30 天的統計視圖，包括熱力圖、模型分佈和技能調用明細。
核心功能¶
- 設置頁集成：在 DSH 的設置頁新增「個人分析」分區，提供統一的入口查看數據。
- 多維度統計窗口：支持在 1 天、7 天、30 天三個時間窗口之間切換。
- 可視化圖表：
- 今日小時柱圖。
- 7 天小時熱力圖。
- 30 天可點擊日曆，點擊日期可查看當日用量明細。
- Token 構成分析：顯示 Token 構成條與分類佔比，推理用量作爲輸出子集單獨說明，不重複累加。
- 模型與技能分佈：
- 模型分佈：顯示提供方、調用次數、Token 與用量佔比。
- 技能調用：區分自動 / 顯式來源，顯示成功、失敗、未完成數量及成功率。
- 數據維護：提供「重建統計緩存」功能，用於重新歸集數據。
安裝與啓用¶
前置條件：Node 版本 ≥ 20，且 dsh web 可正常運行。
- 從 GitHub Releases 下載對應版本的
.tgz安裝包（每個 Release 說明中都附有該包的 SHA-256 校驗值）。 - 將下載的
dsh-usage-analytics-0.2.1.tgz放置到~/.dsh/profiles/web/vendor/目錄下。 - 執行以下命令添加插件：
dsh plugin --profile web add file:vendor/dsh-usage-analytics-0.2.1.tgz
- 安裝完成後重啓
dsh web，並在瀏覽器中硬刷新頁面。
典型用法¶
- 打開 DSH 設置頁，找到「個人分析」分區。
- 點擊時間窗口切換器，查看 1 天、7 天或 30 天的統計視圖。
- 在 30 天日曆視圖中，點擊具體的日期，查看當天的 Token 用量明細和技能調用情況。
適用場景與注意¶
- 適用平臺：僅支持 Web 平臺。
- 樣式適配：UI 樣式跟隨 DSH Appearance（Light / Dark / System），讀取官方
--dsw-alias-*token。 - 安全機制：API 受本機同源 trust-fence 保護；
POST /rebuild接口在 fence 之外無額外鑑權。 - 隱私保護：插件只寫入自己的派生索引（時間戳、數值型 Token 用量、模型標識、技能名、調用來源和結果）。它不會寫入提示詞、模型回覆、工具參數、工具結果、工作目錄或密鑰。Token 與技能明細按 90 天窗口清理。
- 語言支持：UI 爲全中文，無國際化層。
總結¶
dsh-usage-analytics 爲 DSH Web 平臺提供了一個輕量級、本地化的數據透視工具。它通過重建緩存的方式確保數據準確性，同時嚴格限制數據寫入範圍，在提供可視化洞察的同時保障隱私安全。
