hashdiana/dsh-token-usage

dsh-token-usage

为 DeepSeek Harness 网页界面打造的更清晰、更美观的 token 用量条。

GitHub stars
License: MIT
DSH Plugin

🌐  · English

DeepSeek Harness 自带的网页界面把 token 用量挤在输入框下方一行局促的文字里。dsh-token-usage 将其替换为一个一目了然的芯片条，外加一个展示完整明细的详情面板——并且它会跟随你的主题，浅色或深色皆可。

🎯 Token 用量不该需要费力解读——它应该一眼就能读懂。

截图

输入框下方的 token 用量条。

详情面板——点击用量条即可打开。

目录

- 截图
- 亮点
- 它展示什么
- 安装
- 卸载 / 禁用
- 构建与开发
- 工作原理
- 许可证

亮点

- 上下文一目了然——一条细长的占用条，随着上下文窗口被填满，颜色从绿色 → 琥珀色 → 红色变化。
- 输入、输出与缓存分开呈现——计费输入拆分为缓存读取 / 缓存写入 / 未缓存，并优先展示缓存命中率。
- 速度信息触手可及——解码吞吐量（tok/s）和平均首 token 延迟（TTFT）直接显示在用量条上。
- 点击即现的详情面板——上下文构成（系统 / 工具 / 消息）、堆叠式输入拆分，以及会话轮次 / 步骤 / 模型 / 工具耗时。
- 自然的边缘渐隐——当面板还有更多内容可滚动时，其顶部和底部边缘会渐隐并模糊，滚动到两端时则消失。
- 适配主题且支持双语——仅使用 --dsw-* 令牌进行样式设计（浅色/深色），内置中文和英文。

它展示什么

输入框下方的用量条从左到右显示以下芯片：

| 芯片 | 含义 |
|---|---|
| Context | 已用 / 窗口 token 数，带有颜色编码的占用条 |
| Input | 计费输入总量（缓存读取 + 缓存写入 + 未缓存） |
| Output | 提供商报告的输出 token 数 |
| Hit rate | 缓存读取在计费输入中所占比例 |
| tok/s | 在报告用量的步骤上的解码吞吐量 |
| TTFT | 平均首 token 延迟 |
点击该条栏会打开一个面板，其中包含上下文占用 + 组成、输入拆分堆栈、吞吐量 / TTFT 以及会话计数。当尚无数据时，整行会隐藏自身。

安装

从 GitHub 安装（推荐）：

npx -p @deepseek-ai/dsh dsh plugin --profile web add github:hashdiana/dsh-token-usage

从本地检出安装：

npx -p @deepseek-ai/dsh dsh plugin --profile web add

然后重启该 profile：

dsh web

Git 路径会附带构建好的 lib/（参见构建与开发），因此安装时不会运行构建脚本。

卸载 / 禁用

临时禁用而不卸载——添加到 $DSH_HOME/profiles/web/cordis.patch.yml：

- id: dsh-token-usage
disabled: true

重启 dsh web；默认统计行会恢复。移除这些行即可重新启用。

构建与开发

pnpm install
pnpm typecheck   # tsc -b
pnpm build       # tsc -b + tsdown → lib/index.js (host) + lib/client.js (browser)
pnpm test        # vitest: folds, locale parity, jsdom render, slot registration/dispose

客户端 bundle 以 window.__ModuleLoader__.load({ id, factory }) 形式输出；CSS Modules 由 lightningcss 进行哈希处理，并作为  标签注入。提交 lib/ —— Git 安装使用的是构建输出，而不是 src/。

工作原理

- 纯客户端插件 —— 宿主部分是一个空的 apply()；浏览器部分通过 exports["./client"] 提供。
- 插槽 —— 注册到 conversation.composer.dock（单元格 id: "stats"，priority: -1），遮蔽随附的文本行；该注册会随插件 fiber 一起撤销。
- 数据 —— 读取持久化投影 tokenUsage、contextPressure、contextBreakdown 和 sessionStats；窗口折叠仅作为无投影时的回退。
- 语言环境 —— 拥有 tokenUsage 命名空间，中文和英文。

许可证

MIT