前言¶
在 DeepSeek Harness（DSH）中，會話與模型的用量信息分散在日誌與事件流裏，想要一個集中視圖並不容易。本插件在左側欄加入「模型用量」入口，打開一個按模型統計 Token 消耗與請求次數的面板，方便在開發或使用過程中評估各模型的調用成本與使用頻率。
這是什麼¶
dsh-model-usage 是一個 DSH 客戶端插件，由 HitMargin 維護。它通過讀取本地會話日誌中的 assistant/message 事件，按模型聚合 Token 與請求數據，並以面板形式展示在 Web 界面中。統計範圍僅限當前 DSH 進程的會話日誌，不涉及其它設備或已刪除會話。
核心功能¶
- 左側欄入口：在
sidebar.panellist新增條形圖圖標；摺疊時顯示 Tooltip，展開時顯示文字；按鈕、焦點、aria 與選中態由 shell 管理，插件只提供圖標與本地化標籤。 - 整頁面板：在
main註冊同一 id，點擊欄位切換到該頁。 - 頁面內容：顯示當前模型（provider / model / 推理強度）、按模型的用量表（請求數、輸入、輸出、緩存讀取、推理 Token、合計、最近使用時間）、統計進度（首次掃描歷史會話時）、已配置的 provider / model 目錄。
- 多語言：界面文案與元數據提供中文、英文兩套。
安裝與啓用¶
本倉庫是一個標準 DSH bundle（dsh.bundle.patch + dsh.client）。把本目錄作爲 bundle 裝進當前 profile：
plugin_manager action=install_bundle target=<本目錄絕對路徑>
安裝後刷新 DSH Web 頁面即可看到左側欄圖標。升級 / 卸載：在插件頁停用或移除 Model Usage，或對同一 bundle 執行 remove_bundle。
典型用法¶
- 安裝後刷新頁面，左側欄會出現條形圖圖標。
- 點擊圖標展開/摺疊，點擊展開後的文字可進入模型用量面板。
- 首次打開會掃描全部歷史會話（本機約 435 個會話 / 約 843MB 壓縮日誌，耗時約 1–2 分鐘，帶進度條），之後走緩存。
- 通過 Host 半提供的只讀同源接口
GET /api/model-usage（?action=scan觸發重掃）可手動重掃會話日誌。 - 新的 turn 通過
session/event實時增量累加到緩存中，重啓後只重讀變更過的會話。
適用場景與注意¶
適合需要按模型評估成本與調用頻率的開發者或使用者。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證（本項目基於 MIT 協議）。統計範圍僅限本機會話日誌，不含其它設備或已刪除的會話。
結尾¶
dsh-model-usage 通過集中展示按模型的 Token 與請求統計，幫助你在使用 DSH 時更直觀地掌握各模型的調用情況。
- 插件目錄頁：https://www.skillhub.cn/plugins/2228293026/dsh-model-usage
- GitHub 倉庫：https://github.com/2228293026/dsh-model-usage
