dsh-ui-usage-billing

<p align="center">把每一分模型开销，看得清清楚楚。</p>

中文 · English

---

演示动图

新版仪表盘八个分区逐个切换（概览 / 账单 / 用量 / 趋势 / 上下文 / 智能体 / 费率 / 设置）：

✨ 为什么选它

市面计费插件大多停在「token 数 × 单价」。dsh-ui-usage-billing 把计费做成一条可对账的账本链路——用量是真的、价格是活的、峰谷跟着模型走。

账是真的，还能对账

用量从持久化会话日志实时聚合，绝不伪造样本（数据到达前显示空快照）；官方余额当日变动与本地账本交叉对账，偏差超阈值主动提示核对——账单经得起质疑。

价格是活的，历史不重算

models.dev 实时目录 + 内置 25 厂商 241 款模型 + 设置面板自定义单价（可按中转站绑定同模型不同价），新模型无需等发版；DeepSeek 分时价按官方变更节点分段计价（8-17 前基础价、8-17~8-23 周末计峰、8-23 起周末全谷），价格调整永不回写旧账。

峰谷全感知，提醒跟着模型走

计费通道按当前会话使用的模型自动识别：DeepSeek 按量走分时价（工作日 9-12 / 14-18 高峰 ×2、周末全天低谷），智谱 Coding Plan 走积分峰谷（工作日 14-18 高峰全额、非高峰积分 5 折），通道层可扩展、更多厂商逐步接入；切档前弹窗 / 系统通知自动提醒，且只有当前模型真正涉及峰谷才会提醒、费用条才显示档位——不用你盯时间表。

订阅、余额、额度一屏闭环

DeepSeek / Kimi / 智谱 GLM / 腾讯云 TokenHub 等 7 家官方余额、Coding Plan 额度、中转站滚动额度窗口、自声明端点，再加余额差对账——订阅扣的和余额扣的同屏可查、交叉验证。

还有这些同类少见的细节

• 不止「花了多少」还答「花在哪」：输入按缓存命中 / 未命中分桶（含 reasoning）、官方 / 三方分桶、按工作区 / 会话 / 中转站下钻、每轮费用突增归因。
• 子智能体费用并入对话口径：宿主把子智能体落成独立会话，账本按父链把后代消耗归并到委派它的对话（多级委派整链递归），父行「含子智能体」徽标明示合计、展开可见逐个子会话——胶囊上的会话总额与账单对本体+子会话对得上账。
• 性能面板：各模型首字延时（TTFT）均值 / P50 / P90 与生成速度，同类少有。
• 未收录模型显著标注「未收录」、绝不静默计 0；目录外模型配一条别名即完成识别与计价。
• 可选的 usage_stats 工具让模型直接回答「今天花了多少」「哪个站点用得最多」。
• 默认零工具注入：仅当用户在设置里显式开启「注入用量查询」后，才向模型注册 usage_stats 这一个只读工具（默认关闭）；任何情况下都不注入系统提示、不写模型可见事件。
• 中文 / English 语言切换，¥ / ≈$ / ≈€ 币种切换（二者独立）；无图表库、无外部 CDN、离线自包含。
• 会话行可跳转：面板里的会话标题点一下直接打开宿主对话（双代会话选择通道自动探测；宿主不支持时给出可读提示，不静默无反应）。
• 上下文占用维度：概览页显示当前会话的上下文占用率、窗口上限与构成拆解（系统 / 工具 / 消息）——数据取自宿主官方的 context 投影，没有投影的会话整块不显示（不拿 0 冒充）。
• 对话内入口：/usage 命令直接拉起计费仪表盘（宿主无该能力时静默降级，不影响面板）。

📊 仪表盘

• 侧边栏触发卡：设置按钮上方常驻单值主数字（今日 / 本周 / 本月统计范围在设置里选，可选涨跌徽章），配近 7 天 sparkline 迷你趋势与当日水位仪表指针；折叠栏自动切为图标钮，悬停浮现速览卡（更新时间 + 指标网格 + 主力消耗 / 额度提醒）。

• 八区仪表盘：概览 / 账单 / 用量 / 趋势 / 上下文 / 智能体 / 费率 / 设置——Hero 大数字 + 环比 + 本月预计 + KPI（悬停显示口径说明）+ 用量热力图，趋势 7/30 天可切费用 / Token，模型单价表、预算（全局 + 按模型）与峰谷提醒都在；设置页支持全文搜索（中英关键词过滤分区，全不命中显示空态）；克制冷调、深浅主题自适应。Tab 只保留名称，不再挂状态徽标（信息都在各自分区里）。

• 上下文分区：占用率进度条 + 下一次 / 最近一次请求占用 + 窗口上限 + 构成拆解（系统 / 工具 / 消息）。数据取自宿主官方 context 投影；没有投影的会话整块不显示，不拿 0 冒充。

• 智能体分区：按委派关系还原的智能体网络——父对话 → 子智能体的层级树，每行给调用数、自身费用与链合计（自身 + 全部后代），直接回答「哪次委派最贵」。

• 即时代费用条：常驻「本轮 / 会话」费用，位置三档可选（输入框内部工具行 / 上方 / 下方，默认工具行）；峰谷档位与切换倒计时只在当前模型涉及峰谷时出现；订阅额度预警 chips 剩余 ≤20% 浮现、≤10% 标红；可在设置 Tab 整条隐藏（偏好本地持久化，统计与提醒不受影响）。

• 峰 / 谷切换提醒：切档前弹窗 + 可选系统通知，提前量 / 位置 / 模式 / 预览均可配；文案按计费通道区分（DeepSeek 价格减半、智谱积分 5 折）。

• 会话完成提醒：会话 running → completed 时弹系统通知（默认关闭，面板设置开启）；多窗口 / 多实例按认领端点去重，同一会话只提醒一次。

• 插件信息卡：设置 Tab 常驻「关于」卡——版本号服务端读自包 package.json（单一来源，发布自动正确），作者 / 仓库 / npm / 许可证一键可达。

💰 计费引擎

• 提供商优先分组：费用按调用实际发生的 llm 入口（通道）分组——腾讯云 TokenHub / Token Plan / DeepSeek 官方 / 直连·路由名 / 未知路由，模型品牌只是行内徽标 + 副标；官方判定按通道 origin（api.deepseek.com）而非路由名，deepseek-* 网关路由不再被误算官方。routeAliases 归位改名 / 删除的历史路由，modelKeyAliases 把目录外模型 id 绑定到计费键（日期后缀、组织前缀、TokenHub 短 id hy3 已内置识别）。

• 实时费率表：models.dev 抓价 + 探活模型对标，系统实际配置的模型全纳入；峰谷分时（工作日 9-12 / 14-18 高峰 ×2、周末全天低谷，历史费用按官方变更节点分段，见下方「计费细节」）+ 实时汇率（USD→CNY），每 6 小时自动刷新；费率条显示「上次同步」时间并可一键立即同步（无需重启宿主）。

• 自定义单价：设置面板为未收录或变价模型填实付价（未命中 / 缓存命中 / 输出，可选 USD 与低谷价），总览与日趋势按用户价重估；支持按中转站来源绑定同模型不同价，目录外模型填价即生效。

• 官方 vs 三方分桶：账单 Tab 的模型明细费用列按官方直连 / 第三方中转分解（混合时「官 x / 三 y」）；联网搜索辅助请求计入官方。

• 月度预算 + 分档提醒：预算条 ≥80% 琥珀、超支红脉；跨 50 / 80 / 100% 各提醒一次；余额折算 CNY 低于阈值每天提醒一次。按模型预算：为本月消耗 Top 模型逐个设人民币上限（与全局预算相互独立），单模型跨 80% / 100% 各提醒一次。

• 成本突增归因：最近 40 轮费用柱状图，金额贴柱顶、峰谷背景分带、超 2 倍红标归因。

🔌 订阅与余额

…