dsh-cost-meter

解决什么问题

• 看不到花了多少钱：在 DSH Web GUI 中实时显示当前会话费用、输入/缓存/输出 token 与缓存命中率，并汇总今日、本月与累计成本。
• 多渠道额度分散：官方余额、自定义 provider 余额、OpenCode Go 与 Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet 等 Coding Plan 配额集中展示，订阅额度与按量计费分开统计。
• 预算容易失控：预算框给出用量百分比、进度条与今日占比，≥80% 警告、≥100% 超支提示。
• 峰谷价切换容易忘：显示 UTC 峰段（01:00–04:00、06:00–10:00）与当前档位，支持切换前弹窗/系统通知提醒，并可一键从官方文档同步价格。
• 安装前的历史缺失：首次启动自动回放主机会话日志补全历史成本（幂等，不重复计费）。

适合谁

• 关心 API 花费、想为单次会话或月度消费设预算的 DSH 用户。
• 同时使用官方 API 与多个订阅制 Coding Plan / 中转 provider、需要区分「订阅额度」与「真金白银」的开发者。
• 想按模型、按天复盘用量与成本的重度用户或小团队。

主要功能

• 会话/每日/累计成本卡片，90+ 模型价格目录，峰谷价可编辑，价格自动匹配。
• 官方余额与自定义 provider 余额（可配置 dot path / 数字 / 加减除等提取规则），带可选三段进度条。
• Coding Plan 配额查询与显示，各窗口可单独开关；输入框上方额度条汇总预算/Go/各套餐用量，点击即可刷新。
• Codex 风格 26 周 token 热力图、今日会话明细、历史记录（保留天数可配置）。
• 侧边栏精简模式、可配置显示位置、双语（zh/en）界面。

安装与文档

MIT 许可，npm 包 dsh-cost-meter。README 提供安装（含 macOS/Linux 的 pnpm 与 PATH 说明）与逐项配置指引，docs/ 下另有功能专题文档与版本发布说明。