luxueliu-usage-command

🧾 一条 /usage指令，今天API烧了多少钱一眼看穿——你的 token 钱包终于有账本了

/usage — DeepSeek Harness 的本机 API 花费价目卡命令（¥ / 按日 / 分小时）。

由 luxueliu 制作并开源。数据源是本机 LiteLLM 网关的落账文件 gateway_usage.jsonl，按官方公布价计价，输出「按本地别名 × 分小时」的当日 ¥ 消费卡。

这是什么

• 一个 DSH指令：在对话输入 /usage，立即得到价目卡。
• 三类付费模型全覆盖计价，计价货币跟随时区：
  1. 官方直连类（例如DeepSeek 官方 API）；
  2. 中转商类（OpenRouter / 各家中转 API）；
  3. 套餐内的计费池类（自动排除阿里百炼 Token Plan、ClinePass 等套餐内的限额模型，仅计价付费池内的非免费模型）。
• 模型表可自由扩展：在 cordis config 里用 dsModels / usdModels / planModels 任意添加你自己的网关模型与价格，aliases 还能把网关落账里的旧模型名/别名映射到新名字（见下方配置）。没有价目的未知模型自动归入"其他/退役别名"兜底，只列 token，绝不误入今日计费。
• 时区/币种自适应：自动探测系统 locale 与时区——中国用户看到 ¥ + 北京时间，美国用户自动切换 $ + 美东时间，港台用户 NT$/HK$ 同样可用；ds 峰谷价格始终按北京时间（北京电价峰谷），不随用户地区漂移。
• 不落账：Cursor 编辑器直连、DeepSeek 官方直连（DSH harness 官方通道等旁路）。

与官方 dsh-usage 的区别

官方 dsh-usage（kestiny18 出品）读 Harness 会话日志，仅显示DSH平台消耗。

本插件走本地LiteLLM 网关落账，统计全局LLM消费（只要是经由网关出入的），不限平台。

安装

要求：Node.js 22.18+ 与一个 DeepSeek Harness Web profile（如无DSH，也可以让ds帮你把插件适配到其它harness上^_^）。

# 方式一：GitHub 仓库
dsh plugin --profile web add github:luxueliu/luxueliu-usage-command

# 方式二：npm（若已发布）
dsh plugin --profile web add luxueliu-usage-command

重启 DSH 后在对话输入：

/usage

配置

插件随包 cordis.patch.yml 已带默认配置；需要改路径/币种/时区时，在 profile 的 cordis.patch.yml 覆盖：

- insert:
    - id: luxueliu-usage-command
      name: luxueliu-usage-command
      config:
        gatewayLog: "D:/your/path/gateway_usage.jsonl"   # 落账文件；留空自动探测
        currency: "CNY"          # CNY | USD | TWD | HKD；留空按系统 locale
        timezone: "Asia/Shanghai" # IANA 时区；留空取系统时区
        cnyPerUsd: 7.2           # 人民币兑美元汇率
        showRateLegend: true     # 报表尾部是否打印单位价图例
        tailBytes: 0             # >0 只读文件末尾 N 字节（大文件加速）
        debugLog: false          # 写 ~/.dsh/luxueliu-usage-command.log

或设置环境变量 LUXELIU_USAGE_GATEWAY_LOG 指向落账文件。

自由扩展三类模型（核心能力）

不需要改代码——在 profile 的 cordis.patch.yml 里给你的网关模型加价目即可：

- insert:
    - id: luxueliu-usage-command
      name: luxueliu-usage-command
      config:
        # 第一类：官方直连类（人民币计价，可配峰谷小时，peakHours 命中 ×2，按北京时间判定）
        dsModels:
          "my-official-model": { hit: 0.2, miss: 2.0, out: 6.0, peakHours: [9,10,11,14,15,16,17] }
        # 第二类：中转商/OpenRouter 类（美元计价，unit 可改 CNY）
        usdModels:
          "my-relay-model": { hit: 0.5, miss: 2.0, out: 8.0, note: "我的中转商" }
        # 第三类：套餐池（固定月费，不计价，仅列 token）
        planModels:
          - "my-plan-model"
        # 网关落账 model 字段 -> 本地别名（兼容旧名/历史别名）
        aliases:
          "my-relay-model-v2": "my-relay-model"

命令

/usage             # 今天
/usage today       # 今天
/usage yesterday   # 昨天
/usage 08-20       # 指定月-日（今年）
/usage all         # 全量（无分小时，只有按模型汇总）

计价口径

• 价格来自官方公布价（联网核实 2026-08），见代码内 DS / PRICES 表；改价请更新两处（本插件 + usage-price-report skill）。
• DeepSeek 峰谷价：高峰 9:00-12:00 / 14:00-18:00（本地小时 9,10,11,14,15,16,17）为低谷 ×2；
• 汇率默认 7.2（USD→CNY），可配。
• 缓存拆分：优先 prompt_cache_hit_tokens / prompt_cache_miss_tokens；缺省用 prompt_tokens_details.cached_tokens；再缺省整段按未命中计。

已知缺口

• DeepSeek 官方直连（不经本地网关）的用量不在本账内，官方账单会高于本插件数额。
• gemini 的 Vertex 缓存价 in×0.25 标待核实。
• 只统计网关落账文件中的调用（含 Codex 等走网关的用量）。

License

MIT © luxueliu