# dsh-token-dashboard

[English](README.md) | 中文

[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的只读 Token 用量仪表盘。它会在 DSH Web 中新增 **统计** 选项卡，用于查看会话总量、缓存与上下文指标、请求效率、逐步骤明细和跨会话对比。

![dsh-token-dashboard 界面截图](./统计数据.png)

## 功能

- **本会话：**计费输入、输出、缓存命中率、上下文占用、耗时、吞吐和逐步骤 Token 明细。
- **全部会话：**可排序的用量对比，并标记当前、运行中和子代理会话。
- **本地只读：**只读取 DSH 已有投影，不调用外部 API，不上传数据，不新增存储，也不发起模型请求。
- **中英双语：**界面语言跟随 DSH 当前语言。

## 安装

需要已经可以正常运行的 DSH Web，以及 Node.js 22.19 或更高版本。

```sh
dsh plugin --profile web add dsh-token-dashboard
```

安装后重启 DSH Web，**统计 / Statistics** 选项卡会出现在对话和轨迹选项卡旁边。

也可以直接从 GitHub 安装：

```sh
dsh plugin --profile web add github:tsja/deepseek-harness-token-dashboard
```

卸载：

```sh
dsh plugin --profile web remove dsh-token-dashboard
```

## 说明

- 持久总量覆盖完整会话日志；逐步骤明细只覆盖当前已加载窗口。
- 缺失的投影值显示为 `—`，不会误显示为 0。
- 本插件统计 Token 用量，不显示 API 余额或金额费用。
- 不要与 `@deepseek-ai/dsh-client-usage-dashboard` 同时安装；两者提供的是同一个视图。

## 许可

[MIT](LICENSE)