前言¶

在 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 未在已覈實資料中出現，因此不附目錄頁鏈接。