前言¶

在 DeepSeek Harness（DSH）的 Web 界面里，官方会在每条助手回复末尾提供用量入口：点开气泡能看到「本轮用量」的精确数字。数字齐全，但要逐项对照才能判断这一轮缓存是否命中、未缓存输入是否偏高、输出占比是否异常。

下面介绍社区客户端插件 dsh-token-bar（维护者 LobotomyCorporation）：把本轮的未缓存输入、缓存读取、输出三类 token 画成一条分段条，并配上带百分比的图例，放在该条回复自己的图标行里（复制、分支、用量、时间那一行），便于扫视结构而不必先点开弹窗。

这是什么¶

dsh-token-bar 是面向 DSH Web 的纯客户端展示插件：在每条已完成轮次的助手回复图标行中插入一条 132px 宽的用量条，以及同色序的图例。数据来自与官方「本轮用量」弹窗同源的 turn-tail location data，展示的是单轮用量，不是会话累计。

插件已发布到 npm（当前包版本 0.2.2，MIT 许可），归类为 DSH 生态中的客户端插件；社区目录页见 skillhub.cn/plugins/LobotomyCorporation/dsh-token-bar，源码与说明见 GitHub。

核心功能¶

分段条与图例¶

段序与图例序一致：灰（未缓存输入）→ 黄（缓存读取）→ 绿（输出）。只要有对应 token，每段在条上至少占 6px，避免极小占比在视觉上消失。图例为色点、名称与本轮占比百分比；字号比正文小一号，跟随 DSH 内容字号设置；配色取自 --dsw-* 主题 token，浅色与深色模式自动跟随。条在图标行内垂直居中。

悬停用量条可查看本轮完整明细：缓存命中率，以及每段的精确 token 数与占比。README 说明：当前路由上缓存写入未单独成段，该值恒为 0。

实现边界¶

README 强调插件极轻量：纯客户端展示，不联网、不落盘、不注册 Host 路由、不写会话日志、不改任何官方包；零依赖，单文件 bundle，仅使用平台提供的 React。

数据通过 conversation.chat.assistant-actions 插槽拿到消息 id，组件借助会话级 useChat（dsh-client-ui-chat 插槽标配）从本轮 turn-tail 反查 tokenUsage。实现思路参考了 dsh-token-counter。

安装与启用¶

推荐从 npm 安装：

# 从 npm 安装（推荐）
dsh plugin --profile web add dsh-token-bar

# 或直接用 npm 装进项目
npm i dsh-token-bar

本地开发可从目录安装：

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

安装后需重启 dsh web 才会生效。

卸载：

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

典型用法¶

安装并重启 Web 后无需额外配置：每条已完成（turn/end）的助手回复，其图标行中会出现用量条与图例。正在流式输出的当前轮次不会显示条。

若需改外观或段定义，README 说明可调参数均在 client.js 顶部常量中：

插件未提供设计器或配置界面，改样式需编辑源码后重新安装或走本地目录安装。

适用场景与注意¶

适合谁：长期在 DSH Web 上调试智能体、需要快速对比各轮缓存结构与输出占比的开发者；希望用量信息与复制、分支等操作同一行可见的用户。

兼容性（以 README 为准）：

行为与限制：

1. 只覆盖已结束轮次；流式进行中无条。
2. 为使用量条在较早回复上也能看见，插件将带 data-clock="end" 的助手图标行固定为常显（官方默认仅最新一条常显，更早回复需悬停才淡入）。用户气泡不受影响。
3. 图标行顺序由官方硬编码，插件插槽在「复制」与「分支」之间，条落在官方「用量」左侧，无法插在用量与时间之间。
4. 依赖官方 turn-tail 的 location data 结构；DSH 若变更结构，插件需跟随适配。

DSH 插件在当前 dsh 进程权限下加载运行。安装前建议阅读仓库源码与 MIT 许可证，确认符合你的环境与安全要求。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-token-bar 把本轮 token 的三类结构从列表数字变成图标行里的分段条与百分比图例，与官方本轮用量同源，适合在 Web 调试时一眼扫过各轮缓存与输出比例。需要精确数字时仍可悬停条或使用官方用量入口。

• 目录页：https://www.skillhub.cn/plugins/LobotomyCorporation/dsh-token-bar
• GitHub：https://github.com/LobotomyCorporation/dsh-token-bar