Token 用量看板 my-dsh/dsh-token-usage-dashboard

dsh-token-usage-dashboard

DeepSeek Harness 的跨会话 Token 用量看板插件。

该插件从模型调用流中捕获每次请求的 Token 用量，持久化到 SQLite 数据库，并在 Web GUI 中渲染一个浮动看板面板，展示每日按 (provider, model) 分组的汇总数据：Token 桶、吞吐量、TTFT、LLM 步骤耗时和缓存命中率。

Token 消费看板：按供应商与模型分组的当日汇总，含 Token 桶、缓存命中率、TTFT 与耗时 KPI

架构

三个包组成完整功能：

| 包 | 名称 | 角色 |
| host/ | @deepseek-ai/dsh-token-usage | Session/event 监听器，捕获每次请求的用量记录，暴露基于 SQLite 的 TokenUsageStore Service Definition |
| client/ | @deepseek-ai/dsh-client-token-usage | 浏览器看板面板，注册到 shell.overlay——一个悬浮按钮打开每日汇总的模态面板 |
| bundle/ | @deepseek-ai/dsh-token-usage-dashboard | Profile bundle：一个 cordis.patch.yml 插入全部四行（SQLite provider + 捕获监听器 + Remote 服务 + 浏览器面板） |

数据流

模型调用 → session/event 监听器 → TokenUsageStore.append(record) ↓ SQLite 数据库 ↓
TokenUsageRemoteService.dailySummary(date, timeZone)
↓ (Typert Remote RPC)
浏览器面板 (shell.overlay 入口)

捕获监听器通过共享的 @deepseek-ai/dsh-step-timing 原语折叠步骤边界（step/start → 首 token → assistant/message），因此 TTFT 和 decode 时长与会话作用域投影一致。浏览器面板每次请求携带本地时区（browserTimeZone），宿主据此用同一时区界定当日边界。

安装

面板仅在 web 界面中渲染，因此目标 profile 必须是一个 web surface profile（已提供 client 运行时、连接和 shell.overlay 布局）。dsh web 使用的默认 profile 名是 web。需要 pnpm 在 PATH 上。

用一个已存在的 web surface profile 名替换 （缺省 web surface profile 就叫 web）
dsh plugin --profile web add https://github.com/my-dsh/dsh-token-usage-dashboard/releases/download/dist/dsh-token-usage-dashboard-dist.tgz

包声明了 dsh.bundle，安装后自动加入 profile 的 bundle 层栈，重启 DSH 生效。

SQLite 路径

默认数据库位置为 DSH 主目录下的 token-usage.sqlite。可通过配置覆盖：

- id: token-usage-sqlite
name: '@deepseek-ai/dsh-token-usage/sqlite-provider'
config:
path: /自定义路径/token-usage.sqlite

用法

采集在下次启动时开始，无需配置：每次成功的模型调用追加一条记录。从 shell 右下角的悬浮按钮打开看板，选择日期后刷新。

Store 从不自动删除；tokenUsage.purge(before?) 删除某个 epoch 毫秒时间戳之前的行，用于保留策略。

源码布局

dsh-token-usage-dashboard/
├── host/
│ ├── src/
│ │ ├── index.ts # Session/event 捕获监听器 │ │ ├── store.ts # TokenUsageStore Service Definition + SqliteTokenUsageStore │ │ ├── sqlite-provider.ts # 挂载 SQLite store 的 Cordis 插件 │ │ ├── remote.ts # Typert Remote 服务 (dailySummary, purge) │ │ ├── types.ts # UsageRecord, DailySummary 类型 │ │ ├── types.d.ts # 生成的类型声明 │ │ ├── invariant.ts # 包不变量伴随 │ │ └── ... │ └── package.json ├── client/ │ ├── src/ │ │ ├── index.ts # Host 加载入口（空 apply） │ │ ├── invariant.ts # 包不变量伴随 │ │ ├── client/ │ │ │ ├── index.ts # 浏览器插件：shell.overlay 注册 │ │ │ ├── slots.ts # Inject face + Remote API 调用 │ │ │ ├── TokenUsageDashboard.tsx # 看板面板组件 │ │ │ ├── format.ts # 数字/日期格式化 │ │ │ ├── locales.ts # 中文 locale 字典 │ │ │ └── ... │ │ └── ... │ └── package.json ├── bundle/ │ ├── cordis.patch.yml # 4 行插入：provider + 监听器 + remote + 面板 │ ├── src/ │ │ ├── index.ts # 空壳 carrier │ │ └── invariant.ts # Bundle 不变量伴随 │ └── package.json └── package.json # 根 workspace

依赖

该插件依赖以下 DSH 包（从 DSH monorepo 安装）：

- @deepseek-ai/cordis — Cordis 插件框架
- @deepseek-ai/dsh-session — Session 事件和类型
- @deepseek-ai/dsh-llm — LLM 消息工具
- @deepseek-ai/dsh-step-timing — 步骤边界计时原语
- @deepseek-ai/dsh-zoned-time — 时区日分桶
- @deepseek-ai/dsh-typert-protocol — Typert Remote 协议
- @deepseek-ai/dsh-api-remotes — Remote 客户端组装
- @deepseek-ai/dsh-client-ui-layout — shell.overlay slot 声明者
- @deepseek-ai/dsh-client-ui-renderer — Slot registry 服务
- @deepseek-ai/dsh-client-locale — Locale 服务

许可证

MIT