前言¶
DeepSeek Harness（DSH）的日常使用會產生大量會話日誌，開發者往往需要了解不同模型在一段時間內的 token 消耗分佈與活躍度。已有的做法要麼依賴外部統計平臺，要麼需要自行編寫腳本解析本地日誌。DSH 0.2.x 引入了 sessionQuery 服務，用於在宿主層讀取會話數據。利用這一能力，可以在 DSH 的設置面板中直接展示統計視圖，避免將日誌上傳到第三方。
下面介紹 dsh-strength-meter，一個 DSH Web 插件，用於在設置頁按模型統計 token 用量，並展示環形圖、熱力圖與趨勢。
是什麼¶
dsh-strength-meter 是一個 DSH 插件（dsh-strength-meter 2.0.0），爲 DeepSeek Harness 0.2.1-rc.2（Desktop 或 dsh web）提供本地 token 用量統計視圖。它通過 sessionQuery 服務從當前進程的本地會話日誌中摺疊數據，不進行任何上傳。視圖包含指標卡片、按模型的環形圖、15 周活動熱力圖以及每日 token 趨勢。插件層爲宿主路由 + 設置客戶端視圖。
核心功能¶
- 本地摺疊：從本地會話日誌摺疊 token 用量，不依賴投影，不向外上傳數據。
- 指標卡片：顯示總 token、會話數、消息數、活躍天數與連續天數。
- 按模型環形圖：展示各模型的 token 佔比。
- 15 周活動熱力圖：以周爲單位，展示會話/消息的活躍度。
- 每日 token 趨勢：按天展示 token 消耗趨勢。
- 時間範圍選擇：支持“最近 7 天”或“最近 30 天”。
- 刷新機制：首次摺疊會話時併發度爲 4，後續請求在持久化版本未變化時複用摺疊結果；點擊刷新按鈕可繞過 15 秒響應緩存。
安裝與啓用¶
插件需要以宿主權限運行，安裝前請檢查源碼與許可證（MIT）。
插件管理器（桌面）¶
將此文件夾作爲 bundle 安裝，並在插件列表中啓用 dsh-strength-meter。
CLI¶
dsh plugin --profile <profile> add /absolute/path/to/dsh-strength-meter
手動安裝¶
- 將包鏈接到 profile 的
node_modules。 - 在
cordis.patch.yml中添加：
- insert:
- id: dsh-strength-meter
name: 'dsh-strength-meter'
- 重載頁面。不修改 Harness 文件。
典型用法¶
安裝完成後，在 DSH 界面中打開 Settings → Usage stats（該部分位於內置設置之後）。默認展示最近 7 天的數據，可切換到最近 30 天。點擊刷新按鈕可繞過 15 秒響應緩存。首次加載會對整個語料庫進行摺疊，後續加載會複用已摺疊結果。
API 路由¶
插件提供以下宿主路由：
GET /plugins/dsh-strength-meter/usage.json?days=7|30&force=1
返回負載包含：
total：總 token 數models[]：各模型數據sessions：會話數messages：消息數activeDays：活躍天數streak：連續天數topModel：消耗最高的模型byDay[]：每日 token 趨勢heatmap[][]：15 周活動熱力圖debug：調試信息（corpus/folded/cached/errors）
適用場景與注意¶
- 適合需要快速瞭解本地模型使用情況的 DSH 0.2.x 用戶。
- 插件以當前 DSH 進程權限運行，建議在確認源碼與許可證後再安裝。
- 一次請求最多摺疊 400 個會話，超過時僅處理前 400 個。
- 響應緩存爲 15 秒，點擊刷新可強制更新。
短結尾¶
dsh-strength-meter 在 DSH 設置面板中提供本地、可視化的模型用量統計，無需外部依賴與數據上傳，適合 0.2.x 版本的用戶在桌面端或 Web 端使用。
- 目錄頁：https://www.skillhub.cn/plugins/chou109/dsh-strength-meter
- GitHub：https://github.com/chou109/dsh-strength-meter
