前言¶
在 DeepSeek Harness（DSH）里做长对话、多轮调用或子代理编排时，token 用量会散落在各次模型调用里，官方账单又往往滞后。单靠 API 控制台或事后对账，很难在「当前这一轮」就判断会话成本是否偏高。下面介绍社区客户端插件 dsh-token-bill（维护者 leecisen）：按内置价目表与 token 用量做估算，在输入框旁和侧边栏会话列表直接展示金额，并支持按模型、高峰/空闲时段拆分明细。
这是什么¶
dsh-token-bill 是发布在 npm 上的 DSH 插件（当前版本 2.1.0，许可证 MIT）。它定位是「对话费用估算」：用模型返回的 token 用量乘以各厂商官方价格（或你在配置里补充的价格）算出参考金额，以实际账单为准，README 中已明确说明。
插件分类为客户端，通过 Cordis patch 注入会话与工作区 UI；需要 DSH ≥ 0.2.2-rc.1（package.json 中 engines.dsh 与 README 徽章一致）。
核心功能¶
界面展示¶
- 输入框下方：上下文圆环左侧显示当前会话的估算总费用，点击可展开明细面板。
- 侧边栏：会话列表中，每个对话的时间旁显示该对话的费用（可通过配置关闭）。
明细面板中可查看：输入（未命中缓存 / 命中缓存 / 输出）的 token 数与费用占比、缓存命中率、模型调用次数、思考 token（已含在输出内）、最近一轮费用、上下文压缩（compaction）产生的调用费用、DeepSeek 空闲时段相对高峰价的节省额、子代理费用及合计、按模型汇总的 token 与费用（无定价模型显示「未定价」）。金额后带 + 表示有部分模型未计入总额。
价目表与计价规则¶
内置 16 家厂商 主流模型的官方价格（README 截至 2026-11-08 核对）：DeepSeek；Anthropic Claude、OpenAI GPT、Google Gemini、xAI Grok；国内月之暗面 Kimi、智谱 GLM、MiniMax、阿里通义千问、字节豆包、腾讯混元、百度文心、小米 MiMo、阶跃星辰、蚂蚁百灵、美团 LongCat 等，合计 100+ 模型。长上下文阶梯价、官方已公布调价日期按每次调用发生时间分别计算；未内置的模型可在配置 models 中补价。
DeepSeek 高峰 / 空闲：北京时间工作日 9:00–12:00、14:00–18:00 为高峰，其余时段（含周末、法定节假日全天）按半价；插件按每次调用时间计价，并展示「空闲时段节省」。内置 2026、2027 年放假安排，也可在 holidays 中追加日期。
币种与汇率¶
明细面板右上角可切换显示币种，默认提供 CNY、USD、EUR、RUB、INR、IDR、BRL、HKD；选择会记住，侧边栏金额一并换算。官方同时有人民币价和美元价的模型直接使用对应价目表，其余按汇率换算。默认每天联网更新汇率（exchangeRates: true），联不上时使用内置汇率；悬停币种可见汇率日期与来源。
计量范围¶
- 上下文压缩时的模型调用计入（README 说明内置 token 计量不含 compression 部分，插件单独算）。
- 子代理费用单独列出并给出合计（需侧边栏已加载子代理数据）。
- 从其他会话分叉出来的会话，不重复计算继承部分。
- 会话内只存 token 数，价格在展示时套用；改价或改配置后历史会话按新规则重算。
界面中英文随 DSH 语言；随浅色/深色主题。README 称零依赖、无需构建。
安装与启用¶
环境要求：DeepSeek Harness 0.2.2-rc.1 或更新；Node ≥ 22（package.json 的 engines）。
在插件页面安装（推荐）¶
DeepSeek Harness 侧边栏 → 插件 → 添加插件，输入：
dsh-token-bill
点 安装，完成后点 立即启用。新版本可在插件页一键更新。国内 npmmirror 同步可能延迟，装不到最新版时可把安装源改为 npm 官方源。
习惯命令行可执行：
dsh plugin add dsh-token-bill
需要时加上 --profile <你的 profile 名>。
其他方式¶
在「添加插件」中填写 github:leecisen/dsh-token-bill 可安装仓库最新代码，但无法插件页一键更新，升级需先卸载再装。离线可从 Releases 下载 ZIP，解压后在「添加插件」中填写该目录的完整路径。
从旧版升级：2.0.x → 2.1 可在插件页更新（首次打开会话可能重新统计历史用量）；旧包名 @local/token-cost 与新版可并存，启用新版后关闭旧插件即可。npm 上的 dsh-token-cost 是他人插件，非本仓库旧版。
配置（可选）¶
不配即可用：默认人民币、区分时段、侧边栏显示费用、每天更新汇率。修改时在 profile 的 cordis.patch.yml 中增加插件段（Windows 示例路径：%USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml）：
- id: dsh-token-bill
config:
currency: CNY
currencies: [CNY, USD, EUR, RUB, INR, IDR, BRL, HKD]
exchangeRates: true
timeOfDayPricing: true
showInSessionList: true
holidays:
- '2028-01-01'
models:
my-model:
input: 0.8
cacheRead: 0.2
output: 2
currency: CNY
fallback:
input: 2
cacheRead: 0.5
output: 8
注意：DSH 对插件 config 为整体替换，未写字段用 README 表格中的默认值。自定义价格查找顺序：provider/模型 → 模型 → 内置价 → fallback。通过 deepseek-account 使用时按 API 价估算；走额度套餐可在 models 下用 deepseek-account/<模型> 改为 0 或实际单价。
典型用法¶
- 安装并启用后，打开任意会话，在输入框下方圆环左侧查看当前会话估算费用。
- 点击该金额打开明细，核对缓存命中率、压缩与子代理行是否出现，并在右上角切换币种。
- 在侧边栏浏览历史会话，对比各对话旁显示的费用，决定是否收紧上下文或换模型。
- 使用未内置定价的私有或网关模型时，在
cordis.patch.yml的models或fallback中补全每百万 token 的 input / cacheRead / output 价格。
适用场景与注意¶
适合：长期在 DSH 里调试智能体、对比多模型成本、需要即时感知 DeepSeek 峰谷差价与子代理叠加费用的开发者。
注意：
- 金额为估算，仅供参考，以各云厂商实际账单为准。
- 插件在当前 DSH 进程权限下运行（客户端注入）；安装前建议查看 GitHub 仓库 源码与 MIT 许可证。
- 汇率与官方调价会变动；内置价目表以 README 说明的核对日期为准，过期可向仓库提 issue / PR。
DSH 生态主张「一切皆插件」；SkillHub 目录页 为社区收录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-token-bill 把 token 用量、多厂商官方价、DeepSeek 时段差价和子代理/压缩调用叠在一起，落到输入框与侧边栏两处只读展示，适合把「这轮对话大概花多少」当成开发时的即时反馈，而不是替代财务对账。
- 目录页：https://www.skillhub.cn/plugins/leecisen/dsh-token-bill
- 仓库：https://github.com/leecisen/dsh-token-bill
