DSH 的上下文圆环展示的是 token 消耗，开发者真正关心的往往是费用。随着上下文拉长，缓存前缀变贵，轮次增加导致累计开销变大，当窗口积攒到一定厚度，每轮的输入和输出成本都会显著上升。dsh-cache-billing 插件将账单计算集成在上下文圆环弹层中，提供当前步、当前轮、会话累计三块明细，按峰谷费率实时算账，帮助判断是否需要更换窗口。
插件定位¶
dsh-cache-billing 是一个 DSH 客户端插件，由维护者 better-er 提供。它解决了“缓存命中率高但累计成本不可见”的问题，在客户端侧实时展示费用明细，支持第三方中转的记账逻辑，默认按 DeepSeek-V4.1-Flash 模型计价。
核心功能¶
第三方中转支持¶
不限定 DeepSeek 官方路由，只要 Provider 不为空即显示。中转的价格表与官方不同时，按模型名匹配价目表估算金额，显示“按 DeepSeek-V4.1-Flash 计价”，确保有账可算。
三级账单明细¶
支持三种计时级别的统计：
1. 当前步：单次 API 调用的费用。
2. 当前轮：本轮内多步累加的费用。
3. 会话累计：整会话的累计花费，逐笔按各自事件时刻的费率累加，跨轮不比价。
账单层级缩进清晰，分别列出缓存命中、缓存未命中（输入/输出）的 token 数与金额。
峰谷自动计价¶
根据北京时间自动判定费率：
* 高峰时段：工作日 09:00–12:00、14:00–18:00。
* 谷价时段：其余时段、周六日及中国法定节假日全天。
价格配置在 src/index.ts 的 MODEL 常量中，法定节假日表位于同文件的 HOLIDAYS_2026。
单一模型与精度分级¶
- 计价模型：统一按 DeepSeek-V4.1-Flash 计价。
- 显示精度：
- 当前步：四位小数
- 当前轮：三位小数
- 会话累计：两位小数
- 尾零不省，精确到 0.0001 元也能识别。
安装¶
使用以下命令安装插件。安装完成后插件会自动挂载，重启 DSH web 后生效。
dsh plugin --profile web add github:better-er/dsh-cache-billing
使用方式¶
安装完成后，打开 DSH web 界面，点击输入框右侧的上下文圆环。在弹层底部即可查看当前的账单明细，与“上下文用了多少”的信息同屏展示。
开发与配置说明¶
- 插件形态：标准的主机加客户端双半身插件。
- 记账范围：只认
usage中的 input、cacheRead、cacheWrite、output 四类 token。 - 源码配置：价格、峰谷时段、模型名白名单与显示名均写在
src/index.ts的 MODEL 常量里。修改配置后需执行npm run build重建。 - 节假日：法定节假日列表为
HOLIDAYS_2026，位于src/index.ts。
生态链接¶
- GitHub：https://github.com/better-er/dsh-cache-billing
- 目录页：https://www.skillhub.cn/plugins/better-er/dsh-cache-billing
