前言¶
在 DeepSeek Harness (DSH) 中开发智能体时，精确追踪每轮对话的真实成本以及订阅资源的剩余情况是必要的。dsh-turn-cost 是一款 Web 插件，它能在 DSH 界面中直接显示每轮对话的花费（人民币，官方峰谷价）、缓存命中占比，以及订阅路由（如 Kimi 7天周额度、阿里 Token Plan）的实时额度读数。
核心功能¶
该插件提供以下核心能力：
- 按对话实际用的路由分流显示：区分官方按量模型与订阅路由，分别展示金额或额度信息。
- 显示官方按量金额（人民币，峰谷价）：基于 DeepSeek 官方定价计算，支持峰谷价档位。
- 显示订阅路由的 token 与额度读数：针对 Kimi 7天周额度、阿里 Token Plan 等订阅制模型显示剩余 Token 和额度比例。
- 计算缓存命中占比：显示缓存读 token 占比，用于评估长对话的缓存效果。
- 会话级累计：在输入框下方汇总整个会话的消耗数据。
- 支持自定义费率表：允许用户覆盖内置的官方定价。
安装与启用¶
通过 npm 安装插件：
dsh plugin --profile web add dsh-turn-cost
安装后重启 DSH Web 服务并刷新页面即可生效。
典型用法¶
在使用过程中，关注界面中的两个区域：
- 每条回复下方：显示该轮的详细数据。
例如：本轮 ¥0.67 · 332万 token · 缓存读 100% - 输入框下方（官方统计条同一带）：显示本会话的累计数据。
例如：本会话 ¥15.42 · 3280万 token · 缓存读 99%
对于订阅路由（如 Kimi），下方会额外显示官方实时额度读数：
例如：本轮 12.3万 token · 7 天还剩 47 次 · 余额 ¥28.79
配置说明¶
若需自定义费率表，可在配置文件中指定路径。插件会读取 dsh.profile.bundles 中的配置项来定位费率文件。
注意事项¶
- 数据安全：只读取本机数据，不接触模型 API Key。
- 金额性质：金额仅为 provider 上报 usage × 费率表的估计值，不构成官方账单。
- 订阅显示：订阅路由显示 token 与额度读数，不编造消耗百分比。
- 未定价模型：未在费率表里的模型显示
unpriced。 - 许可证：MIT 许可证。
总结¶
该插件解决了 DSH 用户对成本透明度和订阅额度可视化的需求。通过在本地读取会话日志并计算，它为开发者提供了直观的成本与资源监控。
