Token 用量仪表盘 asun-labs/dsh-plugin-token-dashboard

DeepSeek Harness 的 Token 仪表盘

@asun-labs/dsh-plugin-token-dashboard 是一个 DeepSeek Harness 捆绑插件，它读取宿主经过验证的实时和持久化会话语料库，并生成一个自包含的离线 HTML token 仪表盘。

功能特性

- 精确的提供商报告的输入、输出、缓存读取和缓存写入 token 统计
- 每日用量、24 小时活动、模型占比和 KPI 视图
- 工作区 → 会话 → 请求的下钻
- 可交互的 1/7/30 天和全部历史时间窗口
- 仅存储在浏览器中的浅色/深色主题
- 单个本地 HTML 文件，无外部脚本、字体、请求或遥测
- 感知分叉的统计，排除继承的事件前缀

要求

- Node.js ^22.19.0 或 >=24.0.0
- DeepSeek Harness 0.1.7 预发布系列

安装

将公共 npm 包安装到 Harness 配置文件中：

dsh plugin --profile token-dashboard add @asun-labs/dsh-plugin-token-dashboard
dsh --profile token-dashboard --dump-config
dsh --profile token-dashboard --no-open

如果配置文件尚不存在，请在安装插件之前先初始化一次：

dsh --profile token-dashboard --from-default-profile web --dump-config | Out-Null

在 Web UI 中，向 agent 发出请求：

Use the token_dashboard tool to generate my token usage dashboard.

该工具会将 token-dashboard.html 写入活动会话的工作区，并报告其绝对路径。

从本地检出进行验证

从 DeepSeek Harness 检出目录：

corepack pnpm run build
corepack pnpm dsh --profile token-dashboard --from-default-profile web --dump-config | Out-Null
corepack pnpm dsh plugin --profile token-dashboard add D:\git-workspace\AI\DSH\dsh-plugin-token-dashboard
corepack pnpm dsh --profile token-dashboard --dump-config
corepack pnpm dsh --profile token-dashboard --no-open

第一条命令必须成功完成，因为源代码检出需要其官方的 Host、Client 和 Typert 产物才能启动 Web。配置文件初始化命令只需执行一次；配置文件存在后，请省略 --from-default-profile web。

本地源代码覆盖

为了在不安装配置文件捆绑包的情况下快速迭代，请创建一个绝对路径覆盖：

- insert:
- id: dsh-token-dashboard
name: 'D:/git-workspace/AI/DSH/dsh-plugin-token-dashboard/src/index.ts'
config:
fileName: token-dashboard.html
readConcurrency: 4

然后从 Harness 检出目录运行：

corepack pnpm run build
corepack pnpm dsh web --patch D:\git-workspace\AI\DSH\dsh-plugin-token-dashboard\local.cordis.patch.yml

配置

config:
fileName: token-dashboard.html
readConcurrency: 4

- fileName 必须是纯 .html 文件名。该插件绝不会写入活动工作区之外的位置。
- readConcurrency 是 1 到 32 之间的整数。

隐私该插件通过公开的 sessionQuery 服务读取会话快照。它不会扫描存储内部、上传日志或发起网络请求。生成的 HTML 包含使用元数据、工作区路径、会话标题和模型名称；分享前请先审阅。

署名与许可

该产品创意受 fuyi-git/token-dashboard 启发。在本实现创建时，该仓库未包含再分发许可，因此本项目是一个独立的 TypeScript 实现，未复制其 Python 或 HTML 源代码。

本项目依据 MIT 许可证授权。