dsh-token-usage
更清晰、更美观的 DeepSeek Harness 会话界面 Token 用量条。
🌐 中文 · English
DeepSeek Harness 的 Web 界面默认只在输入框下方用一行挤在一起的纯文本展示 Token 统计。dsh-token-usage 把它替换成一目了然的胶囊用量条，外加一个可展开的明细面板——并且自动适配你的明暗主题。
🎯 Token 用量不该靠猜，应该一眼就读懂。
截图
输入框下方的 Token 用量条
点击用量条展开的明细面板
目录
亮点
- 上下文一眼掌握 —— 细进度条随上下文占用从绿 → 黄 → 红变化。
- 输入 / 输出 / 缓存分开展示 —— 输入拆成缓存读取、缓存写入、未命中三段，命中率直接亮在条上。
- 速度就在眼前 —— 解码吞吐（
tok/s）与平均首字延迟（TTFT）直接显示。 - 点击展开明细面板 —— 上下文占用与构成（系统提示 / 工具 / 对话）、输入构成堆叠条、会话轮次 / 步数 / 模型 / 工具耗时。
- 自然的边缘渐隐 —— 面板上下边缘在还有内容可滚时渐隐并高斯模糊，滚到顶/底自动消失。
- 主题自适应、中英双语 —— 样式只用
--dsw-*主题变量（明暗皆宜），文案内置中英双语。
展示内容
输入框下方的用量条从左到右依次是：
| 胶囊 | 含义 |
|---|---|
| 上下文 | 已用 / 窗口 token，带按占用率变色的进度条 |
| 输入 | 计费输入总量（缓存读取 + 缓存写入 + 未命中） |
| 输出 | 服务商上报的输出 token |
| 命中率 | 缓存读取占计费输入的比例 |
| tok/s | 解码吞吐（按上报用量的步骤） |
| TTFT | 平均首字延迟 |
点击用量条展开面板：上下文占用与构成、输入分段堆叠条、吞吐 / 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 即恢复默认 stats 行；删除这几行即可重新启用。
构建与开发
pnpm install
pnpm typecheck # tsc -b
pnpm build # tsc -b + tsdown → lib/index.js（host）+ lib/client.js（浏览器）
pnpm test # vitest：折叠纯函数、locale 配对、jsdom 渲染、slot 注册/销毁/重载
client bundle 以 window.__ModuleLoader__.load({ id, factory }) 形式产出；CSS Modules 由 lightningcss 哈希后注入 ` 标签。**务必提交lib/** —— Git 安装使用的是构建产物，不是src/`。
实现原理
- 纯 client 插件 —— host 半只是空
apply()；浏览器半通过exports["./client"]下发。 - 插槽 —— 注册进
conversation.composer.dock（cellid: "stats"、priority: -1），遮蔽官方文本行；注册随插件 fiber 一并撤销。 - 数据 —— 读取持久投影
tokenUsage、contextPressure、contextBreakdown、sessionStats；仅在投影缺失时用窗口折叠兜底。 - Locale —— 自有
tokenUsage命名空间，中英双语。
