dsh-token-usage-cost

DSH（DeepSeek Harness）Web 界面的 token 用量与费用速览插件。纯 UI 展示，绝不进入模型上下文、不影响会话与 token 统计。

… assistant 回答 …
                               本轮 · ¥0.0123 · ↑2.9K ↓328 · GLM5.3F ← 每轮 chip（模型色 + 悬浮明细）
─────────────────────────────────────────────
1 轮 · 2 步 | LLM 14.6s · … | 缓存命中 33% | 输入 2.9K tok · 输出 328 tok
        本会话 ¥0.157 · ↑12.4K ↓2.1K · glm-5.3 ⚙      ← 会话累计行（⚙ 编辑价格配置）

功能

每轮费用 chip：每轮（一次提问 → 回答 + 工具调用）结束后，在该轮的复制/反馈操作栏中常驻显示 本轮 · 费用 · ↑输入 ↓输出 · 模型短名；单模型的费用与短名使用同一稳定颜色，多模型则分别着色，悬浮可见实际模型、时段、四计费桶与单价来源。
会话累计行：输入条上方状态行下方，显示整场会话累计费用、token；同会话切过模型时显示“多模型”。

自动拉取价格表：四个内置权威源并发拉取、自动识别格式后合并成一张大表（实测 9600+ 条目），host 侧磁盘缓存（默认 7 天 TTL）：

源	格式	覆盖
LiteLLM 社区表（gh-proxy 镜像 / 直连）	`input_cost_per_token` 等，USD/token	2600+ 通用模型
OpenRouter `/api/v1/models`	`pricing.prompt` 等，USD/token（字符串）	最新 GLM/DeepSeek 全系（含 glm-5.3-flash）
models.dev `/api.json`	`cost.input` 等，原生 USD/1M	zhipuai/deepseek/openai 等官方档

⟳ 一键对账同步：⚙ 编辑器里的同步按钮 = 拉全部价格源 × 枚举你 DSH 已配置的模型（llm 适配器目录）→ 逐个自动匹配 → 后缀命中的映射自动写回 modelMap 配置（不覆盖你手动写的）；未匹配的列出清单，提示去 overrides 补。
按模型配置费用：三层解析，优先级从高到低
1. overrides 手动覆盖（价格表没有的私有/新模型）
2. modelMap 模型映射（同步按钮自动补全；你也可以手写）
3. 价格表精确 key → 后缀匹配（段数少者优先官方直供档，自动剔除"套餐免费全 0"假价格）
峰谷 / 时段价：可配置 IANA 时区和任意多个 timeBands。每条模型调用按其历史发生时间匹配时段；时段可设置基础价倍率 multiplier、模型专属倍率 modelMultipliers，或针对模型设置最终单价 overrides，支持跨午夜（如 22:00 → 06:00）。
历史模型归因：从 DSH 全量 session.history 中读取每条 assistant/message 自带的 provider/model 和事件时间。因此同一轮中的模型切换、工具调用后的再次模型调用都会分别计价，不会用当前模型重算旧步骤。
币种与汇率：默认 ¥ 人民币（可配汇率），也可切 $ 美元原价显示。
⚙ 迷你编辑器：点会话累计行末尾的 ⚙，直接在页面里改币种/汇率/峰谷时段/映射/覆盖、一键对账同步。

数据来源：费用优先读取 DSH 全量 session.history 中每条 assistant/message 的 usage、message.source 与事件时间；初次加载期间才回退到当前窗口节点 / tokenUsage 投影。企业计费口径下 reasoningTokens 单独保留、不并入输出桶。费用 = Σ(每条调用的四计费桶 × 该条模型在该时段的单价)。

安装

从 GitHub 安装

dsh plugin --profile web add github:arthur20150522/dsh-token-usage-cost

## 配置

配置文件：`~/.dsh/dsh-token-usage-cost.json`（也可用 ⚙ 编辑器改）。

```jsonc
{
  "currency": "CNY",          // 'CNY' | 'USD'
  "usdRate": 7.2,             // 1 USD 兑换（currency=USD 时忽略）
  "timeZone": "Asia/Shanghai", // 峰谷规则使用的 IANA 时区
  "fetchEnabled": true,
  "ttlHours": 168,            // 价格缓存有效期
  // 价格源列表：全部并发拉取后按顺序合并，越靠前越优先。
  // 支持三种格式，自动识别；可以加任意镜像前缀（如 gh-proxy.com/https://...）。
  "sourceUrls": [
    "https://gh-proxy.com/https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json",
    "https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json",
    "https://openrouter.ai/api/v1/models",
    "https://models.dev/api.json"
  ],
  // 模型映射：DSH 里显示的"provider/模型名" → 价格表 key。
  // 「⟳ 同步」按钮会自动补全这里的映射；你手写的键同步时永远不会被覆盖。
  "modelMap": {
    "zhipuai/glm-5.3-flash": "z-ai/glm-5.3-flash"
  },
  // 手动价格覆盖：单位 USD / 1M token，优先级最高（四种字段都可选，
  // 但 input/output 必填）。适合价格表没有的私有模型，或想对齐平台实际计费时使用。
  "overrides": {
    "glm-5.3-flash": { "input": 0.075, "output": 0.25, "cacheRead": 0.015, "cacheWrite": 0.075 }
  },
  // 数组顺序即优先级；不需要峰谷价时写 []。
  "timeBands": [
    { "name": "谷", "start": "00:00", "end": "08:00", "multiplier": 0.5 },
    {
      "name": "峰",
      "start": "08:00",
      "end": "24:00",
      // overrides 是这个时段的最终 USD / 1M 单价，不再套 multiplier。
      "overrides": {
        "glm-5.3-flash": { "input": 0.111111, "output": 0.388889, "cacheRead": 0.031944 }
      }
    },
    // 仅工作日、仅指定模型的高峰倍率；key 使用 DSH 实际 provider/model。
    {
      "name": "DeepSeek V4 Flash 高峰",
      "weekdays": [1, 2, 3, 4, 5],
      "start": "09:00",
      "end": "12:00",
      "modelMultipliers": {
        "deepseek4399/deepseek-v4-flash-vision-exp": 2,
        "deepseek4399new/deepseek-v4-flash-vision-exp": 2
      }
    },
    {
      "name": "DeepSeek V4 Flash 高峰",
      "weekdays": [1, 2, 3, 4, 5],
      "start": "14:00",
      "end": "18:00",
      "modelMultipliers": {
        "deepseek4399/deepseek-v4-flash-vision-exp": 2,
        "deepseek4399new/deepseek-v4-flash-vision-exp": 2
      }
    }
  ]
}

overrides / modelMap 填写速查：

key 写 DSH 里的模型标识：完整 provider/model 或裸 model 都能命中；
overrides 的 value 只要求 input、output 两个数字（USD/1M），cacheRead/cacheWrite 缺省时按输入价估算；
modelMap 的 value 必须是价格表里存在的 key（同步按钮自动写的都是校验过的）；不确定 key 名，先点一次 ⟳ 同步看报告里命中了哪条；
timeBands 的 start / end 是 HH:mm，end 允许写 24:00；跨午夜写法如 22:00 → 06:00；重叠时数组中靠前的规则优先；
weekdays 可选，按本地时区的星期匹配：0 是周日、1 是周一、…、6 是周六；省略则每天生效；
时段 overrides 会优先于全局 overrides；未配置时段 overrides 时，先匹配 modelMultipliers（模型专属倍率），未命中才用该时段全局 multiplier；两者都会缩放基础价（包括全局 overrides）；
改完保存即生效（client 实时重读配置），无需重启。

REST（仅 loopback）：

路由	方法	说明
`/api/dsh-token-usage-cost/config`	GET / POST	读 / 浅合并写配置
`/api/dsh-token-usage-cost/prices`	GET	价格表（过期自动重拉）
`/api/dsh-token-usage-cost/refresh`	POST	强制重拉
`/api/dsh-token-usage-cost/sync`	POST	对账：强拉价格源 × 枚举已配置模型 → 匹配 + 写回 modelMap + 返回未匹配清单

dsh-token-usage-cost

Install

README

dsh-token-usage-cost

功能

安装

从 GitHub 安装