前言¶

在 DSH 里跑智能体时，模型调用常常分散在官方直连、中转 API、套餐池等多个来源里。只看 token 数，很难判断当天实际花费了多少。luxueliu-usage-command 是一个 DeepSeek Harness 插件，提供 DSH 指令 /usage，从本机 LiteLLM 网关落账文件读取调用记录，输出按模型×分小时的当日花费卡。

下面介绍它的定位、安装方式、命令、配置和适用边界。

插件定位¶

luxueliu-usage-command 由 luxueliu 开源，许可证为 MIT。

它的核心能力是：

• 提供 DSH 指令 /usage，展示本机 API 花费价目卡。
• 数据源为本机 LiteLLM 网关落账文件 gateway_usage.jsonl。
• 覆盖三类付费模型计价：官方直连类、中转商类、套餐内的计费池类。
• 自动适配时区/币种：中国用户显示 ¥ + 北京时间，美国用户显示 $ + 美东时间，港台用户显示 NT$ / HK$。
• 支持在 cordis config 中通过 dsModels、usdModels、planModels 和 aliases 扩展模型价格与别名。
• 无价目的未知模型归入兜底，只列 token，不计入今日计费。

插件要求 Node.js 22.18+ 与一个 DeepSeek Harness Web profile。

核心功能¶

生成当日花费卡¶

插件按模型×分小时输出当日 ¥ 消费卡。可以查看今天、昨天、指定月-日，也可以查看全量汇总。

覆盖三类付费模型¶

插件对三类模型分别计价：

1. 官方直连类。
2. 中转商类。
3. 套餐内的计费池类。

对于套餐内的限额模型，如阿里百炼 Token Plan、ClinePass 等，插件会排除，仅计价付费池内的非免费模型。

按缓存命中拆分计价¶

插件支持按缓存命中/未命中拆分计价，并可用 prompt_cache_hit_tokens、prompt_cache_miss_tokens 等字段。

时区与币种自适应¶

中国用户看到 ¥ 和北京时间；美国用户看到 $ 和美东时间；港台用户可用 NT$ / HK$。

DeepSeek 峰谷价按北京时间判定，默认汇率为 7.2（USD→CNY）。

安装与启用¶

先确认本机环境满足要求：Node.js 22.18+，并且存在一个 DeepSeek Harness Web profile。

接着用 GitHub 仓库安装：

dsh plugin --profile web add github:luxueliu/luxueliu-usage-command

安装完成后，重启 DSH，然后在对话输入：

/usage

插件会以当前 dsh 进程权限运行。安装前应检查源码与 MIT 许可证。

典型用法¶

下面是可复现的指令示例。

查看今天：

/usage today

也可以直接输入：

/usage

查看昨天：

/usage yesterday

查看指定月-日（今年）：

/usage 08-20

查看全量，只有按模型汇总，没有分小时：

/usage all

配置¶

插件随包提供 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"
        timezone: "Asia/Shanghai"
        cnyPerUsd: 7.2
        showRateLegend: true
        tailBytes: 0
        debugLog: false

也可以设置环境变量 LUXELIU_USAGE_GATEWAY_LOG，指向落账文件。

如果要扩展网关模型价格，在 cordis.patch.yml 中添加：

- insert:
    - id: luxueliu-usage-command
      name: luxueliu-usage-command
      config:
        dsModels:
          "my-official-model": { hit: 0.2, miss: 2.0, out: 6.0, peakHours: [9,10,11,14,15,16,17] }
        usdModels:
          "my-relay-model": { hit: 0.5, miss: 2.0, out: 8.0, note: "我的中转商" }
        planModels:
          - "my-plan-model"
        aliases:
          "my-relay-model-v2": "my-relay-model"

其中：

• dsModels 用于官方直连类模型，可配置峰谷小时。
• usdModels 用于中转商类模型。
• planModels 用于套餐池模型。
• aliases 用于把网关落账中的旧模型名/别名映射到本地别名。

计价口径¶

• 价格来自官方公布价，资料注明联网核实时间为 2026-08。
• DeepSeek 峰谷价按北京时间判定，默认汇率为 7.2（USD→CNY）。
• 支持按缓存命中/未命中拆分计价，并可用 prompt_cache_hit_tokens、prompt_cache_miss_tokens 等字段。
• 无价目的未知模型归入兜底，只列 token，不计入今日计费。
• 资料标注 gemini 的 Vertex 缓存价 in×0.25 待核实。

如果模型价格调整，需要同步更新本插件和 usage-price-report skill。

适用场景与注意¶

适合使用 LiteLLM 网关接入多个模型来源、希望按日和分小时查看花费的人。

需要注意：

• 插件只统计网关落账文件中的调用，包含 Codex 等走网关的用量。
• 不落账：Cursor 编辑器直连、DeepSeek 官方直连（DSH harness 官方通道等旁路）。
• DeepSeek 官方直连（不经本地网关）的用量不在本账内，官方账单会高于本插件数额。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

链接¶

GitHub 仓库：

https://github.com/luxueliu/luxueliu-usage-command

目录页 URL 未在已核实资料中出现，因此不附目录页链接。