dsh-token-dashboard

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

dsh-token-dashboard

  让 DeepSeek Harness 的每一个 Token 都清晰可见。

  在 DSH Web 中集中查看会话用量、缓存效率、上下文压力、请求性能与跨会话对比。

  [图片: npm version]

  [图片: CI status]

  [图片: MIT license]

  [图片: Node.js 22.19+]

  [图片: DSH plugin]

  简体中文 · English

---

  [图片: dsh-token-dashboard 统计界面]

无需离开当前会话，即可理解 Token 消耗发生在哪里。

## 核心能力

|  | 能力 | 说明 |
| :---: | --- | --- |
| 📊 | **本会话分析** | 汇总计费输入、输出、缓存命中率与上下文占用，并展示 Token 构成。 |
| ⚡ | **请求效率** | 查看轮次、步骤、LLM / 工具耗时、首 Token 延迟与解码吞吐。 |
| 🔍 | **逐步骤明细** | 按步骤追踪模型、状态、输入输出、缓存读写、推理 Token、TTFT 与 tok/s。 |
| 🧭 | **跨会话对比** | 对全部会话进行排序和对比，并识别当前、运行中及子代理会话。 |
| 🔒 | **本地只读** | 直接读取 DSH 已有投影，不调用外部 API，不上传数据，也不发起模型请求。 |

## 快速开始

### 从 npm 安装（推荐）

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

> [!IMPORTANT]
> 安装完成后请重启 DSH Web。随后 **统计 / Statistics** 选项卡会出现在对话和轨迹选项卡旁边。

从 GitHub 安装或卸载

```sh
# 从 GitHub 安装
dsh plugin --profile web add github:tsja2001/dsh-token-dashboard

# 卸载
dsh plugin --profile web remove dsh-token-dashboard
```

## 你会看到什么

### 本会话

- **Token 概览：**计费输入、输出、缓存命中率、上下文占用。
- **Token 构成：**未缓存输入、缓存读取、缓存写入与输出的占比和明细。
- **请求效率：**轮次、步骤、LLM / 工具耗时、平均 TTFT 与解码吞吐。
- **逐步诊断：**定位高输入、低缓存命中或高延迟的具体请求步骤。

### 全部会话

- 汇总所有带用量投影的会话。
- 按轮次、计费输入、缓存命中、输出或更新时间排序。
- 查看所选会话的四类 Token 明细，并区分当前、运行中和子代理会话。

## 数据口径与隐私

> [!NOTE]
> 这是一个纯展示插件。所有数据都来自 DeepSeek Harness 已经计算的标准投影；插件本身没有服务端、数据库、遥测或网络请求。

- **计费输入** = 未缓存输入 + 缓存读取 + 缓存写入。
- 持久化总量覆盖完整会话日志；逐步骤明细只覆盖当前已加载窗口。
- 缺失的投影值显示为 `—`，不会被误认为 0。
- 本插件统计 Token 用量，不提供 API 余额或金额费用。

## 兼容性

- 需要可以正常运行的 DSH Web。
- 需要 Node.js `^22.19.0` 或 `>=24.0.0`。
- 不要与 `@deepseek-ai/dsh-client-usage-dashboard` 同时安装；两者提供的是同一个视图。

## License

[MIT](LICENSE) © [tsja2001](https://github.com/tsja2001)