前言¶
DSH 的理念是「一切皆插件」：既有改变智能体行为的插件，也有只读取已有运行数据并做展示的工具。qwert702/dsh-token-viewer 属于后者。它为 DeepSeek Harness Web GUI 提供 CC Switch 风格的 token 消耗统计，主要解决“当前会话用了多少计费输入、缓存命中如何、整体成本和账户余额是多少”这类问题。
它不增加 prompt content、tools，也不发起新的 provider requests；接口侧主要是一组只读统计表面，以及一个余额代理读取。
这是什么¶
- 插件名：
qwert702/dsh-token-viewer - 维护者：
qwert702 - 许可证：
MIT - 定位：DeepSeek Harness Web GUI 的 CC Switch 风格 token 消耗统计（只读）
它基于 harness 的 host usageLog 投影展示逐请求用量，并额外代理读取 DeepSeek 账户余额。对 Web GUI 用户来说，它的价值是把 token 消耗、缓存命中率、成本趋势和余额集中到同一个界面里。
核心功能¶
TokenDock¶
TokenDock 是位于 composer 上方的实时条。它显示当前会话的：
- 计费输入：未缓存 + 缓存读取 + 缓存写入
- 输出
- 缓存命中率
- 近似上下文占用
侧边栏卡片¶
侧边栏卡片显示：
- DeepSeek 账户余额
- 余额刷新
- host proxy 失败时的错误重试
- 跨所有会话的聚合消耗
- 可展开的按会话列表
用量统计面板¶
用量统计面板基于 host usageLog 投影做逐请求统计。每条记录对应一次 reported assistant step，记录提交时间、模型和四个 token 桶。
面板中的主要信息包括：
- 真实消耗 Hero
- 请求数
- 总成本
- 五卡分解
- 缓存命中率进度条
趋势图¶
趋势图按请求提交时间分桶：
- 当天按小时分桶
- 其他时间按天分桶
- 空桶补零
图表中包含四个 token 序列，以及一条虚线成本线。
标签页¶
面板提供三个标签页：
- 请求日志：新到旧排序；点击行打开对应会话。
- 按项目统计。
- 按模型统计，并显示平均成本。
时间范围¶
时间范围预设包括：
today / 7d / 14d / 30d / all
模型价格¶
插件按模型峰谷列表价展示：
- 模型：
V4-Flash/V4-Pro - 计价单位：每
1M tokens CNY - 缓存写入：按
cache-miss费率 - 北京峰时：
09:00–12:00和14:00–18:00 - 峰时价格：两倍谷时价
- 未知模型：回退到
V4-Flash谷时表
价格来源可能包括内置表：
MODEL_PRICING
当可访问时，面板也会通过以下接口获取 provider 官方价格：
GET /api/billing/pricing
余额路由¶
余额读取通过以下接口完成：
GET /api/billing/balance
该接口代理 DeepSeek 的：
/user/balance
代理路径经过 harness credentials service；API key 不离开服务器。
安装与启用¶
在 DSH 环境中执行安装命令：
dsh plugin add qwert702/dsh-token-viewer
安装完成后，先重启 harness，再刷新网页，然后在侧边栏打开：
Token 消耗 → 用量详情
典型用法¶
下面是安装后的基本查看路径。
- 安装插件：
dsh plugin add qwert702/dsh-token-viewer
-
重启 harness，并刷新 Web GUI 页面。
-
查看侧边栏卡片：
- 查看 DeepSeek 账户余额。
- 手动刷新余额。
- 如果 host proxy 失败，使用错误重试。
- 查看跨所有会话的聚合消耗。
- 展开查看按会话列表。 -
打开侧边栏中的：
Token 消耗 → 用量详情
-
在用量统计面板中查看：
- 真实消耗 Hero。
- 请求数。
- 总成本。
- 五卡分解。
- 缓存命中率进度条。
- 趋势图。 -
切换时间范围：
today / 7d / 14d / 30d / all
- 切换标签页：
- 请求日志：查看逐请求记录，并打开对应会话。
- 按项目统计。
- 按模型统计，并查看平均成本。
适用场景与注意¶
适合以下场景：
- 想在一个 Web GUI 中查看 DeepSeek 会话的 token 消耗。
- 想查看缓存命中率、真实消耗和总成本。
- 想按请求、项目、模型查看统计。
- 想查看 DeepSeek 账户余额，并避免在浏览器侧直接暴露 API key。
注意事项：
- 该插件定位为只读统计表面，不增加 prompt content、tools 或 provider requests。
- 余额接口通过 harness credentials service 代理，
API key不离开服务器。 - 插件会运行在当前 DSH 进程上下文中；安装前应检查源码、许可证和依赖来源。
- 许可证为
MIT。 - 价格展示依赖内置价格表或 provider 官方价格接口；未知模型会回退到
V4-Flash谷时表。
结尾¶
qwert702/dsh-token-viewer 把 DeepSeek Harness Web GUI 的 token 消耗、缓存命中、成本趋势和余额查看集中到一处，适合作为日常开发中的只读用量面板使用。
GitHub 仓库：
https://github.com/qwert702/dsh-token-viewer
目录页地址未在已核实资料中提供，建议使用插件名检索：
qwert702/dsh-token-viewer
