前言¶
在 DeepSeek Harness(DSH)的 Web 界面中,开发者通常需要追踪当前会话的 token 使用量和速率,但缺少一个直观的、聚合的实时花费计算。dsh-ui-cost-meter 插件通过读取 Harness 的 token 日志,结合配置的费率,在 composer 下方展示当前会话的总花费。
是什么¶
这是一个 Web GUI 客户端插件,由用户 yuu1111 维护。它的核心作用是在现有的统计信息旁,增加一个显示当前 Session 总花费的“pill”组件。该数值基于 Harness 已记录的 provider 使用量,乘以配置的每百万 token 费率计算得出。
核心功能¶
- 实时花费显示:显示当前会话已产生的花费。
- Cost Pill:以胶囊形式显示在 composer 下方,与系统自带的步骤/令牌统计并列。
- 基于费率定价:花费由 Harness 已记录的 provider 使用量乘以配置的每百万 token 费率计算得出。
- 未定价 Token 追踪:如果某个路由没有配置费率,其 token 会被标记为“未定价”(末尾带
+),并在面板中列出。 - 缓存追踪:支持缓存命中、读取和写入的追踪。
安装与启用¶
通过官方 CLI 安装该插件:
dsh plugin --profile web add dsh-ui-cost-meter
配置¶
在插件配置中指定货币符号和费率。费率单位为每百万 token。每个路由(provider/model)只能配置一个费率。你需要将示例中的费率替换为实际支付费率。
- id: cost-meter
name: dsh-ui-cost-meter
config:
symbol: '$'
rates:
<provider>/<model>:
input: 0.15
output: 0.6
cacheRead: 0.003
cacheWrite: 0
注意事项¶
- 非账单记录:显示的数值是 Harness 的 token 统计乘以你配置的费率,不是提供商的正式账单。费率配置错误会导致显示错误。
- 单路由单费率:每个路由只能有一个费率。如果会话中路由价格发生变化,需确保配置反映当前实际支付价格。
- 货币自定义:通过
symbol字段自定义货币符号,插件不进行跨货币转换。
总结¶
dsh-ui-cost-meter 为 DSH Web 界面增加了实时的成本追踪能力。开发者可以根据实际支付费率配置插件,在开发过程中快速评估单次会话的开销。更多细节可查看项目目录或源码仓库。
- GitHub: https://github.com/yuu1111/dsh-ui-cost-meter