DeepSeek Harness (DSH) 採用插件化架構，允許開發者通過擴展來增強功能。dsh-shanhai-stats 是一個用於用量統計的插件，它從 DSH 會話日誌中提取數據，提供總量彙總、每日走勢、GitHub 風格熱力圖以及按模型/提供商分組的明細。
安裝與啓用¶
使用官方插件命令安裝：
dsh plugin --profile web add github:cn-zhangpeng/dsh-shanhai-stats
安裝後，在 DSH 的設置 → 用量統計 中查看。
核心功能¶
數據來源與口徑¶
插件的數據來源於 DSH 會話日誌的 assistant/message 事件，包含 usage 和 message.source.provider/model 字段。插件自身不計算 token，僅做聚合與展示。其數據口徑與 DSH 一致：
* inputTokens：未命中緩存的輸入。
* cacheReadTokens：緩存命中輸入。
* cacheWriteTokens：緩存寫入。
* outputTokens：已包含 reasoningTokens。
時間維度與歷史回填¶
- 時間維度：提供全量
totals、按工作區 (perWorkspace)、按模型 (perModel) 三種聚合維度，且數據永不清零。 - 按天明細：保留 53 周滑動窗口。
- 歷史回填：插件激活時會掃描本地全部工作區會話。此後通過實時事件增量摺疊，利用
seq斷點續掃和 gap 檢測進行補讀。 - 子代理：支持子代理會話，隨事件自然計入。
視圖展示¶
插件提供四個板塊：
1. 總量彙總徽章：展示總花費 Token、緩存命中率、總使用次數、總請求次數、模型用量、連續使用天數。默認進入頁面即爲“當天”視圖。
2. 每日走勢折線圖：按天展示輸入 / 緩存命中 / 緩存寫入 / 輸出四段 Token 走勢。支持切換 當天 / 1 / 7 / 30 天視圖。
3. GitHub 風格熱力圖：展示近一年每日活動熱度，懸停可查看明細。
4. 用量明細表：支持“按供應商”或“按模型”兩個標籤頁切換，查看各供應商或各模型的 Token 用量、消息數、緩存命中情況。
使用說明¶
- 默認進入頁面即爲“當天”視圖，可通過下拉菜單切換 1 / 7 / 30 天或自定義範圍。
- 在用量明細表中，點擊“按供應商”或“按模型”標籤頁進行切換。
注意事項¶
- 首次啓用會掃描本地歷史會話，掃描完成後數字不再頻繁變化。
- 新增了按
provider × model的perModel聚合維度。 - 插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
生態背景¶
該插件是社區目錄中的一項資源，與 DeepSeek 或幻方無官方從屬關係。
