前言¶
DeepSeek Harness（DSH）的对话界面在最后一条回答下方会显示官方的「用量」弹窗，历史回答需要悬停才出现。对于需要持续监控每轮对话成本与性能的开发者来说，这个交互方式不够直观。下面介绍一个客户端插件，它把本轮 Token、回答耗时、本会话累计 Token 常驻显示在每条回答下方，并在回答生成时实时刷新。
是什么¶
dsh-token-usage-badge 是一个面向 DeepSeek Harness 的纯客户端插件，由 oxygenforce 维护。它通过宿主的 turn-tail 节点读取本轮 Token 与耗时，通过 tokenUsage 投影读取会话累计，渲染在官方动作行之后。插件只注入一个 <style> 标签和一个读数槽位条目，不注册服务、不读写文件、不发网络请求。
核心功能¶
常驻读数¶
每条回答下方显示一行淡色读数，格式为：1.1M tok · 1分02秒 · 共 26.9M tok。
从左到右每一段的含义：
| 片段 | 含义 |
|---|---|
1.1M tok |
本轮 Token：这一次提问→回答的消耗 |
1分02秒 |
回答耗时：提问→回答落盘的墙钟时间 |
共 26.9M tok |
本会话累计 Token |
数据来源与口径¶
- 本轮读数取自宿主的
turn-tail节点，与官方「用量」弹窗同一口径。 - 耗时取
turn.start.time→closing.time。 - 会话累计读
tokenUsage投影，实时更新。
悬停查看详细分解¶
鼠标悬停读数，可看到未缓存输入 / 缓存读取 / 缓存写入 / 输出 / 其中推理的精确数字。
生成中实时刷新¶
回答还在生成时，紧跟耗时之后会显示 +12.3K tok，+ 后面的数字是这一个回答到目前为止的消耗（不含历史回合）。数字每完成一个步骤刷新一次，是真实用量，不按字符估算。
避免重复显示¶
官方设置「性能与用量」的 pill 已经显示本轮 token 时，本插件只补耗时和会话累计，不在同一行重复同一个数字；那颗 pill 关掉时自动补回。
失败策略¶
组件内部 try/catch，任何异常都返回 null，绝不连累对话界面。
安装与启用¶
方式一：插件市场（推荐）¶
插件收录到 DSH 插件市场后，在 Harness 里打开「插件市场」搜索 dsh-token-usage-badge 即可一键安装。
方式二：本地目录 / Release 包¶
- 打开 Releases 页面，下载最新一版的
dsh-token-usage-badge-<版本>.tgz并解压（内部是package/目录）； - 在 Harness 的插件管理页选择「从本地目录安装」，指向解压出来的
package/目录； - 安装后刷新一次 Web 页面，读数即刻出现，不需要重启
dsh web。
本包同时带有 dsh.bundle.patch 与 cordis.patch.yml，两条安装路径都会按 bundle 正常启用。
实现细节¶
位置与降级¶
注册在 conversation.chat.turnTail（order: -10），用 react-dom 的 portal 把读数接到官方动作行结束时间之后；取不到动作行时原地降级渲染。
外观与主题¶
字体与颜色全部走 --dsw-alias-* / --dsh-content-* 主题令牌，深浅色自动跟随；只注入一个 <style> 标签。
只渲染一份¶
enforceSingleRenderer() 给本实例节点打上 data-dtc-owner，同一动作行里其余读数与分隔线隐藏（不删 DOM，避免打断宿主的 React 重渲染）。改名、热更新、多窗口并存都不会叠出第二份。
第一步未结算时的估算¶
第一步还没结算时宿主没有任何用量可读，此时先按已流出的文字量给出带 ~ 的估算（例如 ~1.4K tok），结算上报后立刻换成不带 ~ 的精确值。
兼容性¶
面向 @deepseek-ai/dsh-client-ui-chat / dsh-client-ui-conversation 的 0.2.1-rc.2 客户端契约（conversation.chat.turnTail 槽位、turn-tail 节点数据）。
适用场景与注意¶
适合需要持续监控每轮对话成本与性能的 DSH 开发者。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
结尾¶
这个插件把 Token 用量与耗时从「悬停弹窗」变为「常驻读数」，减少反复悬停的操作。安装与启用只需在插件市场搜索或从本地目录指向 package/ 即可。
- 目录页：https://www.skillhub.cn/plugins/oxygenforce/dsh-token-usage-badge
- GitHub：https://github.com/oxygenforce/dsh-token-usage-badge
