用量仪表盘 weibaohui/dsh-dashboard

@weibaohui/dsh-dashboard

使用量仪表盘：离线扫描本机全部 dsh 会话日志，把每天/每周/每月的 token 用量、估算费用、模型/工具/技能/命令榜、输出速度、工作时段与质量错误做成可编排的 Dashboard——gridstack 拖拽卡片 + ECharts 图表 + GitHub 同款日历热力图，支持自定义公式、AI 编排整页配置，不监听任何运行时事件、全部统计在本地完成。

效果演示

demo：七个预设页巡游 + 会话下钻（17s 循环）

| 概览 | Token 与费用 | 模型与质量 |
| 概览：四统计卡 + 热力图 + 趋势 + 模型榜 | Token 与费用：趋势/构成/命中率/明细 | 模型与质量：速度/错误率/明细/重试榜 |
| 命令与技能 | 工作时段与会话 | 错误分析 |
| 命令与技能：四类调用榜 | 工作时段热力图 + 会话明细 | 洞察卡 + 错误码分类 + 聚簇 |
| 输入与时长 | 会话下钻 | |
| 输入与时长：次数/长度/运行时长 | 会话下钻：单会话完整画像 | |

核心功能

- 八个出厂预设页：概览（四统计卡 + 52 周热力图 + token 趋势 + 模型榜）、Token 与费用、模型与质量、命令与技能、工作时段与会话、错误分析、输入与时长、上下文与效率——装上即有完整 Dashboard
- 上下文与效率统计（口径对齐 dsh-context）：上下文构成趋势（单会话逐请求六类堆叠——系统提示/工具 Schema/用户输入/注入/Skill/助手/工具结果，压缩事件 ✂ 锚点，可切会话）、注入上下文来源榜（「上下文税」按插件/Skill 归因）、缓存命中率与缓存写占比、压缩回收 tokens、首响应延迟 TTFT 分布（按模型箱线）、思考时间占比（reasoning/text/toolarg 解码分桶）、人的时间（审批与问答等待分钟数）、文件活动（读写搜索次数、代码行增删、无效搜索率）、DeepSeek 峰谷分时成本（off 系数价格）
- 深度错误分析：供应商 × 错误码分类表（限流/配额、服务端 5xx、超时、空响应、传输——宿主重试策略自带分类学）、错误聚簇 Top（归一化计数，如「429 请求频率过高」×162）、错误样本表、异常日排行（回合错误率）、工具报错榜
- 洞察卡（7 张独立卡，一类洞察一张最合身的图型）：异常日错误率（横向条形 + 中位参照虚线，点条下钻当日）、Token 异常日（×中位数倍数条形，×1 基线）、重试风暴（供应商 × 重试码堆叠条）、慢工具耗时榜、命令失败率（绿→黄→红严重度条形）、错误聚簇矩形树图（面积 ∝ 次数，按错误类别着色）、会话榜单合并表（费用/失败/输入/时长/压缩五榜合一可排序，行点击下钻会话）；旧版 11 区合一 insights 卡保留兼容，卡片编辑器与 AI 编排目录同步收录新卡型
- 三级下钻：热力图点某天 → 当日明细（会话/工具/技能/命令/错误/小时热度）；模型榜点某模型 → 模型画像（逐日趋势/速度/重试/费用/Top 会话）；会话行点某行 → 会话画像（按天分解/模型分布/工具统计/错误样本）
- 输出速度精确计量：每条 assistant 消息内嵌流式 chunk 时序（delta 时间戳数组），解码窗口首尾相减得 tokens/s——按模型/按日出 p50 级精度，而非粗糙估算
- 估算费用：内置常见模型占位价格表，按模型 × in/out/缓存读写单价换算，UI 明示「估算」并列出未定价模型；价格表可视化编辑
- 可编排：gridstack 拖拽/缩放、加卡片、建页/改名/删页，布局与卡片配置即 JSON 自动持久化
- 22 种图类：堆叠柱、矩形树图（项目→模型构成）、旭日图、桑基流向图、主题河流、雷达（模型质量五维）、平行坐标（会话多维）、箱线图（速度分布）、K 线（每日速度区间）、直方图（输入长度分布）、费用预算仪表盘
- 自定义公式：卡片支持安全表达式（Pratt 解析器，禁 eval）——pct(cacheReadTok, cacheReadTok + inTok)、perSec(decodeTok, decodeMs)，序列函数 ma(x,n) 移动平均、delta(x) 环比
- AI 编排：描述需求 → 生成带指标目录与 JSON Schema 的提示词 → 交给任意 agent 会话 → 返回 JSON 一键导入，宿主按 Schema + 指标白名单双校验，坏配置进不来
- 入口可选：默认左侧栏 Global panels 最上方（完整主面板形态）；⚙ 设置里可切换为设置页内 / 两者都显示
- 明暗主题跟随：按官方约定读取 body[data-ds-dark-theme] / html[data-ds-theme-source] 主题属性，MutationObserver 属性监听即时跟随 dsh 切换主题（纯事件驱动，无轮询；matchMedia 兜住系统深浅），整套 UI 与全部图表实时重着色，无需刷新、无设置项
- 性能自律：多帧 zstd 逐帧解压（结构化扫帧，不用一次性解压 API 防静默截断）、mtime 增量扫描日常秒级、事实表内存缓存 + storage 持久化、零 npm 运行时依赖

安装

dsh plugin --profile web add @weibaohui/dsh-dashboard -w

装完重启 dsh web 即生效，启动后自动增量扫描 ~/.dsh/sessions。入口：左侧栏最上方 📊 仪表盘（⚙ 设置里可切换为设置页内 / 两者）。

使用

1. 装上即有八个出厂预设页：概览 / Token 与费用 / 模型与质量 / 命令与技能 / 工作时段与会话 / 错误分析 / 输入与时长 / 上下文与效率，页签直接切换
2. 编辑布局：进入编辑模式拖拽/缩放卡片、加卡片、新建页/改名/删页，改动自动保存
3. 下钻：热力图点某一天、模型榜点某个模型、会话表点某一行、洞察条目点击——逐级从总览定位到单个会话
4. AI 编排：设置 → AI 编排新页面 → 描述需求生成提示词 → 交给任意 dsh agent 会话 → 把返回 JSON 粘回导入
5. 费用：默认按内置价格表估算；设置 → 编辑价格表按模型调整单价（每 M token，含缓存读写）；⚙ 设置里可设月预算，Token 与费用页的预算仪表盘实时显示达成率
6. 扫描：启动自动增量扫描（按文件 mtime 跳过）；设置里可手动增量重扫 / 全量重扫
7. 自定义公式：卡片编辑器填公式（优先于指标），支持 pct(a,b)、perSec(tokens,ms)、序列级 ma(x,n)、delta(x)
8. 输入与时长分析：输入次数/字符量趋势、平均输入长度、会话运行时长排行、子代理调用量

页面 → 板块

| 预设页 | 卡片 |
| 概览 | 今日费用/tokens/活跃会话/平均速度四卡 · GitHub 同款热力图 · 每日 token 趋势 · 模型榜 |
| Token 与费用 | 每日费用趋势 · 费用构成饼图 · 缓存命中率（公式卡） · 按模型明细表 |
| 模型与质量 | 输出速度趋势（按模型） · 回合错误率 · 模型质量明细 · 重试榜 |
| 命令与技能 | shell 命令榜 · skill 调用榜 · 工具调用榜 · 斜杠命令榜 |
| 工作时段与会话 | 星期 × 小时热力图 · 最近会话表 · 回合与错误趋势 · 项目榜 |
| 错误分析 | 洞察卡 · 错误趋势 · 供应商 × 错误码 · 错误样本与聚簇 · 工具报错榜 |
| 输入与时长 | 输入次数/运行时长统计卡 · 输入趋势 · 平均输入长度 · 直方图 · 会话明细 |
| 上下文与效率 | 上下文构成趋势（可切会话） · 缓存命中率（按模型） · TTFT 箱线 · 思考占比 · 注入来源榜 · 等待/审批/回收/提问四统计卡 · 代码行增删 · 文件写入榜 · 会话规模直方图 |

卡片配置 schema（页面 JSON）

页面配置即 JSON（gridstack 布局 + 卡片定义），存宿主 storageDomain；手排、AI 排都是改这份 JSON。

{
id: 'overview', title: '概览', cols: 12,
layout: [{ i: 'ov-today-cost', x: 0, y: 0, w: 3, h: 2 }, …],
cards: {
'ov-today-cost': {
type: 'stat', // stat|line|bar|pie|table|calendarHeatmap|punchcard|sessions
// errorSamples|retryCodes|insights|stack|treemap|sunburst
// sankey|themeRiver|radar|parallel|boxplot|candle|histogram|gauge
title: '今日估算费用',
query: {
measures: ['cost'], // 指标名（见 /api/catalog 指标目录）
granularity: 'day', // day | week | month
range: 'today', // today | 7 | 30 | 90 | 365 | all
groupBy: '', // model|tool|skill|cmd|slash|project|session|''
scope: 'all', // all 含子代理 | top 仅顶层会话 project: '', // 按项目名过滤 },
options: { unit: 'USD', top: 8, stack: true },
},
},
}

指标目录（measures）

msgs 模型响应数 · inTok/outTok/cacheReadTok/cacheWriteTok/totalTok · turns/turnsError 等 · retries/retryExhausted · toolCalls/toolErrors/toolMs · llmMs/decodeMs/decodeTok · speed 输出速度 · sessions/skills/cmds/slashCmds · cost 估算费用 · errorRate 回合错误率

公式

算子 + - * / % ( )，数字字面量，除零得 0 行级 pct(a,b) = a/b100 perSec(tokens, ms) = 每秒速率序列 delta(x) = 环比差 ma(x, n) = n 期移动平均示例 pct(cacheReadTok, cacheReadTok + inTok) 缓存命中率
perSec(decodeTok, decodeMs) 输出速度 tok/s
pct(turnsError, turns) 回合错误率 %

指标 → 数据源

| 指标 | 日志事件 | 说明 |
| token 用量 | assistant/message 的 usage | inputTokens 按请求累计，与账单同口径；部分 provider 另报 cacheRead/Write |
| 模型 / 速度 | 同上 message.source + stream[].dt | 逐 chunk delta 时序首尾相减得解码窗口；速度 = decodeTok/decodeMs |
| LLM 重试分类 | llm/retry | 宿主自带错误码：RATE_LIMIT/SERVER/TIMEOUT/EMPTY_RESPONSE/TRANSPORT + 原始 message + delayMs |
| 回合错误 | turn/end 的 reason.kind/error.message | completed/error/aborted/interrupted/max-tokens/user 七种 + 错误文本归类 |
| 工具 / 报错 | tool/call + tool/result（callId 配对） | 调用数、耗时、isError 分类（权限/不存在/命令失败/超时…） |
| skill 调用 | tool/call name=skill | arguments.name 计数 |
| shell 命令 | tool/call name=bash | arguments.command 首词分类，只存类别 + 计数不存原文 |
| 工作时段 | 全事件 time | 本地时区 星期 × 小时 168 格热度 |
| 会话 | session 头 + turn/、user/message | 每项目会话数/回合数；delegationDepth 区分子代理 |
| 上下文构成 | 全事件 surface 重放（system/message、request/header、五类消息 + compaction/ 的 shadowedSeqs） | 每次请求派发快照六类构成（~4 字符≈1 token 启发式 + 图片官方公式）；压缩按 shadowedSeqs 精确移除并记锚点 |
| 注入上下文 | user/message 的 source（kind≠user）+ developer/message + skill 加载 | 按来源（插件/Skill 名/developer）归因 tokens，累计口径 |
| TTFT / 解码分桶 | assistant/message 的 stream（首 token chunk + block-start 标记） | TTFT = step 开始→首 token；解码按 reasoning/text/tool-call 三桶计时 |
| 人的时间 | approval/asked+decided 配对、ask_user_question 调用窗口 | 审批决策与问答等待的墙钟时长与次数 |
| 文件活动 | 文件工具（read/write/edit/grep/glob/str_replace_editor）调用参数 + 结果 meta | 行增删读自参数（old/new string、content）；搜索按完整 meta 逐文件归账，零命中计入无效搜索率 |
| 峰谷成本 | usage + 事件时间 | DeepSeek 分时（工作日 UTC 01-04、06-10 全价，其余 ×off 系数），价格表条目配 off 启用 |

实现说明

离线扫描器（host） 查询层 展示层（client） ───────────────────── ──────────────── ───────────────── ~/.dsh/sessions//.zstd /api/catalog 指标目录 gridstack 拖拽网格 ↓ 结构化扫帧 + 逐帧 zstdDecompressSync /api/cube 立方体聚合 ECharts 八类 + 洞察卡系列事件流 ──fold──▶ 事实表(会话×日) /api/summary /sessions calendar 热力图 / punchcard │ └─▶ storage 域持久化 /api/errors /insights 公式求值器（Pratt 解析） ▼ mtime 增量 /api/day|model|session 下钻 settings.section + 侧边栏入口 FactsById 内存缓存 /api/pages /pricing /config 布局+卡片 JSON 持久化
- 扫描器：会话日志是「多帧 zstd 拼接容器」（宿主每批次 append 一帧），node:zlib 的一次性解压与解压流都只解第一帧——必须结构化扫帧（按帧格式跳步，不解压块）后逐帧 zstdDecompressSync；按文件 mtime 增量，130 个文件全量 4s
- 事实表：每行 = 会话 × 本地日，聚合出全部榜单与趋势；storageDomain（域 dsh_dashboard）持久化 + 内存缓存；存储域打开失败（如重启窗口期被占用）自动退化内存模式并在 /api/status 标注
- host：inject ['webServer','connection','storageDomain']，全部路由走 connection.requestRejection 信任栅栏；配置（页面/价格表/入口）与事实同域分表
- client：slots 双入口挂载——sidebar.panellist（order -100 置顶图标）+ main 主面板（variant:'panel'，JS 钉高使 wrap 自身滚动），settings.section（variant:'settings'，跟随弹窗滚动）；ECharts + gridstack 由 esbuild 构建期内联，React 是宿主平台模块
- 响应头：全部 API 带 Cache-Control: no-store，保证写后读一致

HTTP API（宿主）

| 路由 | 说明 |
| GET /dsh-dashboard/api/status | 扫描状态/进度/存储模式/usage 覆盖率 |
| POST /dsh-dashboard/api/scan | 触发扫描 { full?: bool } |
| GET /dsh-dashboard/api/catalog | 指标目录 + 卡片类型 + 公式说明 |
| GET /dsh-dashboard/api/cube | 立方体聚合 ?granularity&range&groupBy&scope&project |
| GET /dsh-dashboard/api/summary | 今日/7 天/30 天/累计汇总 |
| GET /dsh-dashboard/api/sessions | 会话明细行（按最近活动排序） |
| GET /dsh-dashboard/api/heat | 星期 × 小时热度（168 格） |
| GET /dsh-dashboard/api/errors | 错误分析：分类/聚簇/趋势/样本 |
| GET /dsh-dashboard/api/insights | 洞察卡（异常日/最贵会话/慢工具/命令失败率…） |
| GET /dsh-dashboard/api/day/:date | 单日下钻（会话/工具/错误/小时热度） |
| GET /dsh-dashboard/api/model/:model | 模型下钻（逐日趋势/错误码/Top 会话） |
| GET /dsh-dashboard/api/session/:id | 会话下钻（完整单会话画像） |
| GET /dsh-dashboard/api/projects | 项目列表 |
| GET|PUT /dsh-dashboard/api/pages | 页面配置 CRUD（Schema 校验） |
| POST /dsh-dashboard/api/pages/validate | 单页校验（AI 导入用） |
| POST /dsh-dashboard/api/pages/import | 校验 + 导入一个页面 |
| POST /dsh-dashboard/api/pages/reset | 恢复出厂预设页 |
| GET|PUT /dsh-dashboard/api/pricing | 模型价格表 |
| GET|PUT /dsh-dashboard/api/config | 界面配置（入口位置等） |
| GET /dsh-dashboard/api/ai/prompt | AI 编排提示词生成 |

开发

npm run check # 语法检查（src + client + formula）
npm test # 20 项离线测试（fold 分类/聚合/公式求值/下钻/校验）
npm run build:client # esbuild 打包 echarts + gridstack + formula → client/bundle.js

link 安装的实例改完源码：host 改动重启 dsh web，client 改动 npm run build:client 后刷新页面即生效。

隐私

全部统计在本地完成；bash 命令只保留「首词分类 + 计数」，不落命令原文；错误样本截断 200 字符且仅本地存储。

联系我 :飞书群

link

版本兼容性

本插件与 DeepSeek Harness（@deepseek-ai/dsh）的版本对应关系：

| 插件版本 | 适配 dsh 版本 | 备注 |
| 0.1.2 | 0.1.7-rc.2 | 布局编辑交互完善：8 向缩放手柄（边框/四角方向光标）、标题移动光标、保存布局按钮，当前验证版本 |
| 0.1.1 | 0.1.7-rc.2 | 新增输入/时长/子代理统计与 11 种新图类（堆叠柱/树图/桑基/河流/雷达/平行坐标/箱线/K线/直方/仪表） |
| 0.1.0 | 0.1.7-rc.2 | 首个版本 |

发版约定：每次发布新版本时，请在上表追加一行，记录该插件版本实际验证所用的 @deepseek-ai/dsh 版本。package.json 的 engines.dsh 声明最低支持版本；本表记录实际验证版本，二者配合使用。

License

MIT