前言¶
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 生成页面配置并导入。
- 费用管理：在设置中编辑价格表和月预算。
- 扫描控制：在设置中手动触发增量重扫或全量重扫。
- 公式编辑：在卡片编辑器中使用公式进行自定义计算。
