在 DeepSeek Harness（DSH）的使用流程中，精确掌握 API Token 的消耗构成（特别是缓存命中情况）对优化提示词和成本控制很重要。现有界面通常只显示总消耗，缺少对缓存输入、未缓存输入和输出段落的拆分展示。该插件通过读取 DSH 内部的会话投影，提供直观的用量条。
这是一个轻量级的 UI 插件，用于在 DSH Web UI 中可视化 API Token 用量。由 hurry060215-tech 维护。它直接读取 DSH 的 tokenUsage 投影，将用量显示为三个分段：缓存输入、未缓存输入和输出，而不需要访问 DeepSeek API 或用户凭据。
核心功能¶
- 数据源直接读取：直接读取 DSH 已有的
tokenUsage会话投影，不请求 DeepSeek API。 - 隐私安全：不读取 API Key，不查询账号余额，不修改会话日志。
- 可视化区分：使用颜色区分分段，绿色表示缓存读取，黄色表示未缓存输入，蓝色表示输出。
- 交互与可访问性：支持鼠标悬停或辅助技术读取三个分段的精确 token 数量。
- 响应式设计：桌面端和窄屏均可用；窄屏会隐藏文字标签但保留颜色与数值。
- 无额外开销：纯 UI 插件，不新增模型工具、system prompt 或 token 开销。
安装与启用¶
-
确保环境满足要求：
- DeepSeek Harness
>=0.1.5-alpha.1 <0.1.6-0 - Web profile
- Node.js
^22.19.0或>=24 - pnpm 10
- DeepSeek Harness
-
执行安装命令。插件尚未发布到 npm，需直接安装 GitHub Release 中的预构建包：
npx --yes @deepseek-ai/dsh@0.1.5-rc.1 plugin --profile web add https://github.com/hurry060215-tech/dsh-api-usage-bar/releases/download/v0.2.0/dsh-api-usage-bar-0.2.0.tgz
- 启动 Web 界面：
npx --yes @deepseek-ai/dsh@0.1.5-rc.1 web
- 打开终端打印的完整启动链接（或使用自动打开的浏览器），完成一次模型请求后，用量条会自动出现在输入框下方。
注意：安装包包含预构建的 lib/，用户不需要克隆仓库或运行构建。
端口冲突处理：如果 3080 端口已被占用，可以使用以下命令指定端口：
npx --yes @deepseek-ai/dsh@0.1.5-rc.1 web --port 3091
统计口径¶
插件基于 DSH 的 token 投影进行归一化展示，三个分段对应以下字段：
| 分段 | DSH token 投影字段 |
|---|---|
| 缓存输入 | cacheReadTokens |
| 未缓存输入 | uncachedInputTokens + cacheWriteTokens |
| 输出 | outputTokens |
条形图表达的是用量构成，而非账户余额进度。
注意事项¶
- 卸载：若需移除插件，请使用
npx --yes @deepseek-ai/dsh@0.1.5-rc.1 plugin --profile web remove dsh-api-usage-bar。 - npm 限制：由于插件未发布到 npm，安装时请勿尝试使用
add dsh-api-usage-bar命令。 - 隐私说明：插件只读取浏览器已收到的累计 token 投影，不发起网络请求，不持有凭据，不写会话事件。
