dsh-token-bar

给 DeepSeek Harness 的 Web 界面加一条单轮 token 用量条：放在每条回复自己的图标行里（复制 / 分支 / 用量 / 时间那一行），把这一轮的缓存结构画成灰 / 黄 / 绿三段条，配一条带百分比的完整图例。

极轻量：纯客户端展示，不联网、不落盘、不注册任何 Host 路由、不写会话日志、不改任何官方包。 零依赖：一个手写 bundle，只用平台提供的 React。

English | 中文

---

它解决什么

官方在每条回复末尾的用量气泡里，点开能看到「本轮用量」的精确数字。但数字是列表，要读；结构是形状，一眼就懂：

• 这一轮是不是全命中缓存？
• 有没有跑出大量未缓存输入（意味着前缀失效、成本变高）？
• 输出占比是否异常？

dsh-token-bar 把这三个数字变成一条可扫视的带状图，并且带图例——不需要悬停也知道每段是什么、占多少。

外观

项	值
段序 / 图例序	灰（未缓存输入）→ 黄（缓存读取）→ 绿（输出），条与图例完全同序
条宽	132px
最小段宽	只要有 token 就至少 6px，再小的占比也看得见，不会和图例对不上
图例	色点 + 名称 + 本轮占比百分比
字号	比正文小一号：calc(var(--dsh-content-font-size-secondary, 13px) - 1px)，跟随设置里的字号
配色	全部取自 --dsw-* 主题 token，浅色 / 深色自动跟随
对齐	图标行内垂直居中

悬停显示本轮完整明细：缓存命中率 + 每段精确 token 数与占比。

缓存写入未单独成段——当前路由上该值恒为 0。

数据来源

读本轮 turn-tail location data 里的 tokenUsage，即本轮的用量（和官方「本轮用量」弹窗同源），不是会话累计。

conversation.chat.assistant-actions 这个插槽只把消息 id 交给组件，所以 useChat 会从本轮数据反查一次：每条完成的 Turn 都会发布一份 turn-tail，里面既有收尾消息的 messageId，也有它自己的 tokenUsage——对上 id 就拿到了这一轮的账目。useChat 属于会话级插槽标配（dsh-client-ui-chat 的 slots.d.ts 把 useChat 挂在 SessionStandardProps 上），不需要额外注入。

感谢 dsh-token-counter 提供的实现参考。

安装

dsh plugin --profile web add dsh-token-bar

或从本地目录安装（开发时）：

dsh plugin --profile web add /path/to/dsh-token-bar

安装后重启 dsh web 生效。

卸载：

dsh plugin --profile web remove dsh-token-bar

兼容性

组件	支持
DSH	>=0.2.0-rc.1 <0.3.0-0，在 0.2.0-rc.2 上实测
Node.js	>=20
界面	DSH Web（依赖 conversation.chat.assistant-actions 插槽）
系统	macOS / Linux / Windows（纯 JavaScript）

开发

npm run check   # 语法检查
npm test        # 纯函数测试 + 渲染测试

npm test 默认测试源码 client.js。想验证浏览器实际收到的那份构建产物，从运行中的 dsh web 抽一份快照：

node scripts/snapshot-bundle.mjs "http://127.0.0.1:3080/?token=<启动时打印的 token>"
npm test        # 检测到 verify-module.js 后，自动改为测试服务端下发的产物

网络受限时推送

如果所在网络访问不了 github.com:443（git push 卡住超时）但 api.github.com 可以访问，用 REST API 推送：

node scripts/push-via-api.mjs <owner>/<repo> --dry-run   # 先看要推什么
node scripts/push-via-api.mjs <owner>/<repo>             # 真正推送

它会按 blobs → trees → commits 重放本地历史，并把分支指向远端生成的新 commit SHA（API 创建的 commit 与本地 SHA 不同，这点最容易踩坑）。

可调参数

都在 client.js 顶部：

常量	作用
BUCKETS	三段（顺序、名称、颜色）
MIN_SEGMENT_PX	最小段宽，默认 6
TRACK_PX	条宽，默认 132
FONT_SIZE	字号，默认比正文小一号

已知限制

• 只覆盖完成（turn/end）的轮次；正在流式输出的那一轮没有条。
• 图标行常驻：官方默认只让最新一条回复的图标行常驻，更早的回复要悬停才淡入。为了让条一直看得见，插件把助手那一行固定为可见——只动带 data-clock="end" 的行，用户气泡不受影响。代价是每条回复下方的图标行都常显。
• 位置受官方排列约束：那一行的顺序是硬编码的（复制 → 插件动作 → 分支 → 用量 → 时间），唯一可用的插件插槽在复制与分支之间。所以条落在用量左侧，而不是「用量和时间之间」——官方没有在那里留插槽。
• 依赖官方 turn-tail 的 location data 结构；DSH 若改动该结构，需要跟随适配。
• 没有设计器 / 配置界面，改样式需要编辑源码。

许可

MIT