dsh-stats-board

Readme

# @deepseek-ai/dsh-stats-board

统计看板（DeepSeek Harness Web / `dsh` 宿主）。在自带「对话 / 轨迹」之外新增第三个 **「统计」视图标签**：用浮动卡片、小表格与手写 SVG 图表可视化会话统计；同时压制自带 composer-dock 的统计行。

StatsBoard for DeepSeek Harness Web: suppress the shipped composer-dock stats line, add a third **「统计」view tab** beside 对话/轨迹 that visualizes session stats with floating cards, small tables, and hand-rolled SVG charts.

## 功能 Features

- **第三个视图标签** — 注册进 `conversation.view` slot（order 20，标签「统计」），与对话/轨迹并排切换
- **会话总览 KPI** — 总轮次 / 总步数 / LLM 耗时 / 工具耗时 / 平均 TTFT / 输出速度 / 输入输出 tokens / 缓存命中率 / 上下文占用
- **Token 构成环形图** — 系统 / 工具 / 消息（上下文构成投影）或未缓存输入 / 缓存读写 / 输出（计费桶）两种模式
- **每轮输入 / 输出柱状图** — 最近 16 轮，输入（蓝）/ 输出（紫）
- **累计输出折线图** — 输出 tokens 随轮次累计
- **每轮明细表** — 轮次 / 步数 / LLM 耗时 / 平均 TTFT / 速度 / 输出 / 工具数
- **工具调用表** — 按调用次数与总耗时排序
- **composer-dock 压制** — 在 `conversation.composer.dock` 注册空组件，隐藏自带统计行
- **免构建** — 手写 JS（`React.createElement` + 内联 SVG），`file:` 或 npm 安装均可直接使用

## 安装 Install

```sh
dsh plugin --profile web add @deepseek-ai/dsh-stats-board
```

未发布时可用本地目录：

```sh
dsh plugin --profile web add file:C:/path/to/dsh-stats-board
```

然后重启 DeepSeek Harness。安装后在对话视图右上出现「统计」标签，点击查看当前会话的统计看板。

卸载：

```sh
dsh plugin --profile web remove @deepseek-ai/dsh-stats-board
```

## 数据来源 Data sources

- 会话节点：`useSession((s) => s.chat.legacy.nodes)` 推导每轮步数 / LLM 耗时 / TTFT / tokens / 工具调用
- 投影：`useProjection('sessionStats')` / `'tokenUsage'` / `'contextPressure'` / `'contextBreakdown'`

## License

MIT