前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。當本地會話日誌積累到一定程度，從日誌中提取統計信息或編排可視化 Dashboard 需要額外工具。dsh-dashboard 插件通過離線掃描本機會話日誌，提供了一套統計分析方案。它基於 Gridstack 和 ECharts 構建了一個可編排的 Dashboard，支持自定義公式和 AI 編排。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add @weibaohui/dsh-dashboard -w
安裝後重啓 dsh web 即可生效。插件啓動後會自動增量掃描 ~/.dsh/sessions。默認入口位於左側欄 Global panels 的最上方。
核心功能¶
出廠預設與圖表¶
插件內置八個出廠預設頁，包括概覽、Token 與費用、模型與質量、命令與技能、工作時段與會話、錯誤分析、輸入與時長、上下文與效率。這些頁面直接提供完整的 Dashboard。支持 22 種圖類，包括堆疊柱、矩形樹圖、箱線圖、直方圖等。
可編排與交互¶
Dashboard 支持通過 Gridstack 進行拖拽和縮放。進入編輯模式後，用戶可以添加卡片、新建頁面、改名或刪除頁面，改動會自動保存。支持三級下鑽：從總覽的熱力圖點選某一天，定位到當日的模型榜或會話明細，最後點擊會話行查看單會話的完整畫像。
深度分析¶
插件提供多維度的統計分析能力：
* 上下文與效率：統計上下文構成（系統提示、工具 Schema 等）、緩存命中率、TTFT（首響應延遲）、思考時間佔比、文件活動等。
* 深度錯誤分析：按供應商和錯誤碼分類，展示錯誤聚簇 Top、錯誤樣本表和工具報錯榜。
* 輸出速度計量：基於流式 chunk 的時間戳計算精確的 tokens/s。
* 估算費用：基於內置價格表估算費用，支持可視化編輯價格表（含緩存讀寫單價）和設置月預算。
智能與公式¶
支持自定義公式，如 pct(a,b) 計算百分比，perSec(tokens, ms) 計算速率。支持 AI 編排：在設置中描述需求生成提示詞，交給任意 dsh agent 會話生成配置 JSON，導入即可生成新頁面。
性能說明¶
插件具備性能自律特性：使用多幀 zstd 逐幀解壓以避免 API 靜默截斷；使用 mtime 增量掃描，日常掃描速度可達秒級。
使用指南¶
- 查看預設：打開儀表盤，直接切換八個預設頁查看數據。
- 編輯佈局：進入編輯模式，拖拽縮放卡片，修改頁面結構。
- 下鑽分析：點擊熱力圖、模型榜或會話行，逐級查看明細。
- AI 編排：在設置中使用 AI 生成頁面配置並導入。
- 費用管理：在設置中編輯價格表和月預算。
- 掃描控制：在設置中手動觸發增量重掃或全量重掃。
- 公式編輯：在卡片編輯器中使用公式進行自定義計算。
