beijingwahw/dsh-usage-ledger

README excerpt

dsh-usage-ledger ( Token费用统计 ) 中文 English DeepSeek Harness 的 Token / 用量统计与成本控制插件：按对话聚合消耗、动态跟随官方定价、支持预算拦截，并内置 Web 仪表盘。 功能特性 - 按会话统计 ：监听 session/event ，把每次 assistant/message 的 usage （输入 / 输出 / 缓存读写 Token）折算为费用，按会话、按北京日、按生命周期三个维度聚合，并持久化到账本文件。 - 动态官方定价 ：定期抓取官方定价页，自动解析并热更新价格，官方调价 / 上新模型时无需改代码即可生效。 - DeepSeek 峰谷分时 ：识别官方「高峰 / 空闲」时段表与生效日期，按调用发生的北京时间实时取价。 - 多厂商价格目录 ：覆盖 DeepSeek、智谱 GLM、月之暗面 Kimi、阿里通义、字节豆包、MiniMax、百度文心等主流国产模型，新模型上线官方定价页后自动导入。 - 预算控制 ：支持日 / 总 / 单会话三级预算，达到阈值进入告警，超限可通过 llm/stream 钩子直接拦截模型调用。 - Web 仪表盘 ：通过 dsh-host-webserver 注册 /usage-ledger 路由，提供用量可视化与 JSON API。 - 用户覆盖价 ： customPrices 设置可为任意模型（含自定义模型）覆盖或补充价格，优先级最高。 安装 将本仓库放入 DeepSeek Harness 的插件目录（或通过包管理器安装），Harness 会依据 dsh.plugin.json 与 cordis.patch.yml 自动加载。 配置 在 Harness 的 cordis.yml 中挂载并配置： usage-ledger 命名空间的用户设置（可在运行时热更新）： 设置 默认 说明 dailyBudget 0 日预算（元），0 关闭 totalBudget 0 总预算（元），0 关闭 sessionBudget 0 单会话预算（元），0 关闭 warnRatio 0.8 进入告警的预算占比 enforceBudget true 超预算时拦截模型调用 pricingUrl DeepSeek 官方页 定价刷新来源 refreshIntervalMin 60 定价刷新间隔（分钟） customPrices {} 按模型 id 覆盖价格（最长前缀匹配） customPrices 示例： 价格单位为 元 / 百万 tokens 。 价格解析优先级 用户覆盖 DeepSeek 实时表 各厂商实时抓取表 内置目录精确匹配 最长前缀匹配 各厂商抓取方式（ fetchKind ）： 厂商 通道 DeepSeek 官方定价页 HTML（含峰谷表） 智谱 GLM SPA app. .js …

Category