dsh-token-bill

dsh-token-bill · 对话费用

[English](README.en.md)

[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件：估算每个对话花了多少钱。除了 DeepSeek，还内置了 Claude、GPT、Gemini、Grok 和国内 11 家厂商主流模型的官方价格，可以随时切换成美元、欧元、卢布等币种显示。

安装：DeepSeek Harness → 插件 → 添加插件，输入 dsh-token-bill。（[详细说明](#安装)）

• 输入框下方：上下文圆环左边显示本会话的估算费用，点一下展开明细。
• 侧边栏：会话列表里，每个对话的时间旁边直接显示它的费用，不用点进去。
• 16 家厂商的官方价格：DeepSeek；Anthropic Claude、OpenAI GPT、Google Gemini、xAI Grok；国内的月之暗面 Kimi、智谱 GLM、MiniMax、阿里通义千问、字节豆包、腾讯混元、百度文心、小米 MiMo、阶跃星辰、蚂蚁百灵、美团 LongCat，共 100 多个模型（[价格表](#内置价格)）。长上下文的阶梯价、官方已公布的调价日期，都按每次调用分别计算。没有内置的模型，在配置里补上价格即可。
• 切换币种：明细面板右上角可以切换显示币种，默认提供人民币、美元、欧元、卢布、印度卢比、印尼盾、巴西雷亚尔、港币——按 DeepSeek 用户最多的地区选取。官方同时有人民币价和美元价的模型直接用对应的价目表，其余按当日汇率换算（[说明](#币种与汇率)）。
• 区分高峰 / 空闲时段：DeepSeek 官方在北京时间工作日 9:00–12:00、14:00–18:00 收高峰价，其余时段（含周末、法定节假日全天）半价。插件按每次调用发生的时间分别计价，并显示「空闲时段节省」了多少。
• 算得更全：上下文压缩（compaction）时的模型调用也计入（内置的 token 计量不含这部分）；子代理的费用单独列出并给出合计；从别的会话分叉出来的会话，不会重复计算继承来的部分。
• 改价立即生效：会话里只记录 token 数，价格在显示时才套用，改了价格后所有历史会话都按新价格重算。
• 中英文界面，跟随浅色 / 深色主题；零依赖、无需构建。

> 费用由模型返回的 token 用量 × 价格表估算，仅供参考，以实际账单为准。

效果

| 明细面板（浅色） | 明细面板（深色） | 侧边栏 |

|---|---|---|

| | | |

以上为插件代码在 DSH 主题样式下的 2 倍分辨率预览渲染。示例数据：一次高峰时段对话 + 一次夜间（空闲）对话，其中各调用了一次 Claude Sonnet 5.5 和 GLM-5.3 + 一次上下文压缩 + 一个子代理。

面板里有什么：

| 行 | 含义 |

|---|---|

| 标题栏右侧的币种 | 点开切换显示币种，所有金额（包括侧边栏）一起换算；选择会记住。鼠标悬停可以看到汇率日期和来源。 |

| 输入 · 未命中缓存 / 命中缓存 / 输出 | 各类 token 数与对应费用；彩条是费用占比。有缓存写入时会多一行「缓存写入」。 |

| 缓存命中率 | 命中缓存的输入 ÷ 全部输入。 |

| 模型调用 | 计费的模型调用次数（失败后重试的那次也算）。 |

| 其中思考 | 输出里的思考（推理）tokens，已包含在「输出」中。 |

| 最近一轮 | 最近一轮对话的费用。 |

| 上下文压缩 | 压缩上下文时的模型调用费用。 |

| 空闲时段节省 | 和全部按高峰价相比省下的钱。 |

| 子代理 / 合计 | 本会话启动的子代理的费用，以及加上它们之后的合计。 |

| 按模型 | 每个模型的 token 与费用，按费用从高到低排列；没有价格的模型显示「未定价」。 |

• 金额后面的 + 表示有模型没有价格，这部分没有计入总额（在「按模型」里标为「未定价」）。
• 「子代理」「合计」只在本会话启动过子代理、并且侧边栏已加载它们的数据时出现。

安装

需要 DeepSeek Harness 0.2.2-rc.1 或更新版本。

在插件页面安装（推荐）

DeepSeek Harness 侧边栏 → 插件 → 添加插件，输入：

dsh-token-bill

点 安装，装好后点 立即启用。插件发布在 [npm](https://www.npmjs.com/package/dsh-token-bill) 上，以后出了新版本，可以直接在插件页面一键更新。

习惯用命令行的话，可以执行 dsh plugin add dsh-token-bill，需要时加上 --profile <你的 profile 名>。

> 国内镜像（npmmirror）同步新版本可能要等一会儿。如果装不到最新版，把「添加插件」里的 安装源 切换成 npm 官方源。

其他安装方式

• 从 GitHub 安装：在「添加插件」里填 github:leecisen/dsh-token-bill，装的是仓库里最新的代码。这种方式装的插件没法在插件页面一键更新，升级时要先卸载再重新安装。
• 离线安装：在 [Releases](https://github.com/leecisen/dsh-token-bill/releases) 下载源码 ZIP，解压到一个固定的文件夹，然后在「添加插件」里填这个文件夹的完整路径（例如 D:\dsh-plugins\dsh-token-bill）。

从旧版本升级

• 2.0.x → 2.1：在 插件 页面点更新即可。2.1 改了会话里记录用量的方式，更新后第一次打开会话时会重新统计一遍历史用量，会话很多时可能要等几秒。
• v1（@local/token-cost）：新版是一个独立的包（包名 dsh-token-bill，行 id dsh-token-bill），和旧版互不冲突。装好并启用新版后，在 插件 页面关闭或卸载旧的 @local/token-cost 即可。旧版的 inputPrice / cacheHitPrice / outputPrice 配置仍然有效，会用作"没有价格的模型的兜底价格"。
• 2.0.0（当时叫 dsh-token-cost）：先在 插件 页面卸载，再按上面的方法安装。注意：npm 上叫 dsh-token-cost 的包是别人的另一个插件，不是本插件的旧版本。
• 用 github: 地址装过 2.0.1 的：卸载后改成输入 dsh-token-bill 重新安装，以后就能一键更新了。

配置

不配置也能用：默认显示人民币、区分时段、在侧边栏显示费用、每天联网更新汇率。要修改时，在你的 profile 的 cordis.patch.yml（Windows 一般在 %USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml）里加一段：

- id: dsh-token-bill
  config:
    currency: CNY            # 默认显示的币种；也是 models 里自定义价格的默认币种
    currencies: [CNY, USD, EUR, RUB, INR, IDR, BRL, HKD]   # 面板里可以切换的币种
    exchangeRates: true      # 每天联网更新一次汇率；false = 只用内置汇率，不联网
    timeOfDayPricing: true   # 区分 DeepSeek 高峰/空闲时段；false = 全部按高峰价（保守上限）
    showInSessionList: true  # 在侧边栏会话列表显示费用
    holidays:                # 额外的法定节假日（北京时间日期），整天按空闲价
      - '2028-01-01'
    models:                  # 每百万 tokens 的价格
      my-model:              # 键可以是「模型 id」，也可以是「provider/模型 id」
        input: 0.8           # 输入（未命中缓存）
        cacheRead: 0.2       # 输入（命中缓存），默认等于 input（旧名 cacheHit 也能用）
        output: 2            # 输出
        currency: CNY        # 这组价格的币种，默认等于上面的 currency
        # cacheWrite: 1      # 缓存写入，默认等于 input
        # offPeak:           # 可选：空闲时段价格，缺的字段沿用上面的值
        #   output: 1