luxueliu-usage-command
🧾 一条 /usage，今天烧了多少钱一眼看穿——你的 token 钱包终于有账本了
/usage — DeepSeek Harness 的本机 API 花费价目卡命令（¥ / 按日 / 分小时）。
由 luxueliu 制作并开源。数据源是本机 LiteLLM 网关的落账文件 gateway_usage.jsonl，按官方公布价计价，输出「按本地别名 × 分小时」的当日 ¥ 消费卡。
这是什么
- 一个 DSH 斜杠命令插件：在对话输入
/usage today、/usage yesterday、/usage 08-20 或 /usage all，立即得到价目卡。
- 三类付费模型全覆盖计价：
- 官方直连类（DeepSeek 官方 API，人民币计价 + 北京峰谷价）；
- 中转商类（OpenRouter / 各家中转 API，美元计价）；
- 套餐池类（阿里百炼 Token Plan、ClinePass 等固定月费套餐——不计价，只列 token 用量）。
- 模型表可自由扩展：三类模型都不是写死的——在 cordis config 里用
dsModels / usdModels / planModels 任意添加你自己的网关模型与价格，aliases 还能把网关落账里的旧模型名/别名映射到新名字（见下方配置）。没有价目的未知模型自动归入"其他/退役别名"兜底，只列 token，绝不误算钱。
- 时区/币种自适应：自动探测系统 locale 与时区——中国用户看到 ¥ + 北京时间，美国用户自动切换 $ + 美东时间，港台用户 NT$/HK$ 同样可用；ds 峰谷始终按北京时间（梁文峰的北京电价峰谷），不随用户地区漂移。
- 当地货币直接展示：所有消费以用户所在地货币（¥/$/NT$/HK$）显示，按模型×分小时拆分，一眼看出谁在烧钱，而不是甩给你一堆 token 数字。
- 不落账：Cursor 编辑器直连、DeepSeek 官方直连（DSH harness 官方通道等旁路）。
与官方 dsh-usage 的区别
官方 dsh-usage（kestiny18 出品）是 Web 用量面板插件（Settings → Usage 页 + 52 周热力图 + 每轮消息底部用量行），读 Harness 会话日志。
本插件是斜杠命令版，读 LiteLLM 网关落账文件，输出可在对话里直接看的文本价目卡，支持按天/按小时/按模型拆分与 ds 峰谷价。两者互补：一个看面板，一个在对话里直接问。
安装
要求：Node.js 22.18+ 与一个 DeepSeek Harness Web profile。
# 方式一：GitHub 仓库
dsh plugin --profile web add github:luxueliu/luxueliu-usage-command
# 方式二：npm（若已发布）
dsh plugin --profile web add luxueliu-usage-command
重启 DSH 后在对话输入：
/usage today
配置
插件随包 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；2026-08-17 起为新价，之前按旧价。
- 汇率默认 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
