dsh-usage-billing
Manifest validSession billing: the session cost and balance displayed below the input box are priced incrementally according to the official peak/off-peak pricing; off-peak hours receive a 50% discount with a countdown timer displayed.
会话账单 · dsh-usage-billing
非官方社区插件:本项目由社区成员独立开发和维护,与 DeepSeek 官方无关;第三方内容未经官方审核,使用前请自行评估风险。
输入框下那枚小胶囊,实时告诉你这一条对话已经花了多少钱,以及现在是不是该等一等再跑。
同样的请求,空闲时段只要一半。先看见,才省得下来。

三个理由
1. 按请求时刻计价,不是按平均值估 每个请求用它发生那一刻的峰谷价计费,切换时段不重算历史。token 计数与平台同源,与官方账单实测对照误差约 0.9%(对照表见文末「与平台『用量信息』的差异」)。
2. 空闲价 = 高峰价的一半,高峰时胶囊直接倒计时 工作日 09:00–12:00、14:00–18:00 之外(含周末、法定节假日)为空闲时段。高峰时胶囊显示「高峰 · 2h 后空闲」;已经空闲时收起倒计时(避免拥挤),改在弹窗的时段徽标里显示「剩 12h」。弹窗还会累计本会话因避开高峰少花了多少钱。价目与法定节假日日历运行时自动抓取,失败自动回退上次成功值并提示。
3. 只看你正在聊的这一条 不是「近 30 天总账」,是本会话。胶囊常驻 composer,样式对齐宿主统计控件,不遮挡输入框、不打断上下文。
30 秒装上
dsh plugin --profile web add @vacum972/dsh-usage-billing
装完刷新页面即可,出厂价目已内置,零配置。Desktop profile 见 安装;不想联网可 autoRefresh: false 只用内置价目。
金额是估算值,不含 Search / Fetch 等按次费用,实际扣费以 DeepSeek 账单为准。

功能
- 按官方峰谷价目逐次请求计价:每次模型请求按它发生时刻的时段(高峰/空闲)计价,切换时段不重算历史;
- 价目自动校准:Host 定期拉取 DeepSeek 官方价目文档,解析模型价格;失败时回退到上次成功价目并在弹窗提示, 且每 2 分钟自动重试;
- 法定节假日日历:自动获取中国法定节假日,高峰/空闲判断与官方规则一致(周末与节假日全天空闲);
- 避开高峰的节省统计:落在空闲时段的结算会同时记录「若在高峰要多花多少」,弹窗累计显示本会话少花的金额;
- 空闲倒计时:胶囊直接显示「高峰 · X 后空闲」或「空闲中 · 剩 X」,一眼判断现在跑还是等一等;
- 剩余金额:读取当前登录账号的充值余额 + 赠送余额,打开弹窗即刷新、之后每 60 秒更新,可手动重试;
- 上下文不打扰:胶囊与弹窗样式对齐宿主 composer 统计控件,紧凑布局,不会遮挡输入框。
界面预览
点开后的详情弹窗:消费金额、剩余金额、请求次数、Tokens 总计、平均成本、高峰/空闲时段消费拆分、 本会话因避开高峰的节省额,以及当前时段生效的官方价目与空闲倒计时:

截图为隐私脱敏示意:金额、余额与时间戳已打码(马赛克);录屏 GIF 里的聊天记录也一并打码。 请求次数、Tokens 与官方价目为真实数据。
时段与价目(确保准确)
按 DeepSeek 官方价目页 的规则:
- 高峰时段:北京时间周一至周五(不含中国法定节假日)09:00–12:00、14:00–18:00;
- 其余时间(含周末、法定节假日全天)为空闲时段,空闲价 = 高峰价的一半;
- 出厂价目(2026-11-04 抓取,元 / 百万 tokens):
| 模型 | 输入(缓存命中) | 输入(缓存未命中) | 输出 |
|---|---|---|---|
| deepseek-flash | 0.04 高峰 / 0.02 空闲 | 2 高峰 / 1 空闲 | 8 高峰 / 4 空闲 |
| deepseek-v4-pro | 0.30 高峰 / 0.15 空闲 | 9.0 高峰 / 4.5 空闲 | 27.0 高峰 / 13.5 空闲 |
自动刷新:正常情况下每 30 分钟拉取一次官方价目 Markdown 与节假日日历;失败后每 2 分钟重试, 成功即恢复;提示条悬停可看到失败时间与具体原因。
安装
方式 A:npm 一键安装(推荐)
需要 DSH >=0.2.1-rc.5:
dsh plugin --profile web add @vacum972/dsh-usage-billing
安装后重启 dsh web(或刷新页面加载客户端包),输入框下方出现胶囊。
方式 B:从 GitHub 源码安装
dsh plugin --profile web add github:vacum972/dsh-usage-billing
Desktop 用户
Desktop 的 desktop profile 由 Electron 应用独占,普通 npm 版 dsh CLI 会拒绝管理它。Desktop 上请通过
DSH 内的插件中心(安装 @vacum972/dsh-usage-billing)启用;或使用 Desktop 自带的 CLI 以本地路径安装:
dsh plugin --profile desktop add link:<本仓库路径>
配置
配置挂在插件行的 config 上,出厂值见 cordis.patch.yml。在 profile 的 cordis.patch.yml 追加同 id 的行可覆盖;
补丁会整体替换 config,所以要把想保留的键都写全:
- id: usage-billing
name: '@vacum972/dsh-usage-billing'
config:
currency: CNY
timeZone: Asia/Shanghai
peakWindows: ['09:00-12:00', '14:00-18:00']
peakWeekdays: [1, 2, 3, 4, 5]
holidays: [] # 额外节假日;留空则只用自动抓取的日历
autoRefresh: true
refreshMinutes: 30
priceUrl: 'https://api-docs.deepseek.com/zh-cn/quick_start/pricing.md'
holidayUrl: 'https://timor.tech/api/holiday/year/{year}'
default: # 未列出的模型使用这一行
peak: { cacheRead: 0.04, cacheMiss: 2, cacheWrite: 0, output: 8 }
idle: { cacheRead: 0.02, cacheMiss: 1, cacheWrite: 0, output: 4 }
models:
deepseek-flash:
peak: { cacheRead: 0.04, cacheMiss: 2, cacheWrite: 0, output: 8 }
idle: { cacheRead: 0.02, cacheMiss: 1, cacheWrite: 0, output: 4 }
deepseek-v4-pro:
peak: { cacheRead: 0.3, cacheMiss: 9.0, cacheWrite: 0, output: 27.0 }
idle: { cacheRead: 0.15, cacheMiss: 4.5, cacheWrite: 0, output: 13.5 }
- 单价单位:
currency/ 百万 tokens;DeepSeek 不单独计缓存写入费(cacheWrite: 0); autoRefresh: false可关闭联网刷新,只用配置里的价目与holidays;- 换到别的时区/供应商时改
timeZone、peakWindows、priceUrl、holidayUrl。
剩余金额
- 数据来自当前登录的 DeepSeek 账号(Platform 充值钱包 + 赠送钱包),显示两者合计,并列出两项明细;
- 未登录或纯 API Key 模式显示「登录后查看」;读取失败显示「读取失败,点击重试」;
- 打开弹窗即刷新,之后每 60 秒刷新;点击右侧时间可手动刷新;
- 金额按 Platform 展示规则处理:两位小数,正的不足一分显示
<0.01。
计费口径
- 请求次数:每次模型调用结束(
assistant/message)或失败/被中止(assistant/attempt)都计一次; - token:只使用供应商在会话日志里上报的 usage;同一尝试的最终样本替换流式样本,
llm/retry-started之后的尝试重新计一次,与 DSH 内置tokenUsage投影口径一致; - 成本:每次尝试的 token 用该次请求日志时间对应的时段价目计价后再累加;
单次成本 =
输入×未命中单价 + 缓存读×命中单价 + 缓存写×写入单价 + 输出×输出单价,除以 1,000,000; 同一尝试的样本被替换时按新样本重算该次成本; - 这是估算值,不包含 Search/Fetch 等独立 API 的按次费用、供应商调价窗口差、优惠等, 实际扣费以 DeepSeek 账单为准。
与平台「用量信息」的差异
插件统计的是本会话,平台「用量信息」是近 30 天、全部会话 / API Key 的汇总,所以数值不同是预期行为。 开发环境实测对照(同一时刻):
| 口径 | API 请求次数 | Tokens | 消费金额 |
|---|---|---|---|
| 插件(本会话) | 299 | 78,677,354 | ¥3.22(估算) |
| 平台(近 30 天) | 488 | 103,214,039 | ¥6.21(账单) |
把本机所有会话投影里的 tokenUsage 相加得 102,263,277,与平台 103,214,039 相差约 0.9%(平台数据有约 5 分钟延迟),
说明 token 计数与平台同源,差异来自统计范围;请求次数与金额还包含其它会话/其它 Key、重试计次差异,
以及 Search/Fetch 按次费用(官方另计 ¥5 / 1000 次成功请求,插件不统计)。弹窗底部提供「查看平台用量 ↗」链接。
隐私与外部服务
- 不保存、不读取、不上传任何 API Key;剩余金额通过 DSH 已登录账号的账户服务读取,token 只在 Host 内部使用;
- 插件运行时仅访问两个公开地址:DeepSeek 官方价目文档与
timor.tech节假日日历;可用autoRefresh: false完全关闭; - 无遥测、无第三方上报;会话用量全部在本地按会话日志计算;
- 数据不写入插件目录之外的私有文件(统计随会话投影缓存由 DSH 管理)。
兼容性
- 在 DSH
0.2.1-rc.5(Desktop / web profile 与本地 link 安装)上开发与验证; - 插件使用 DSH 客户端会话投影与账户 Remote 接口,属于较内部的接口:DSH 升级后如出现兼容问题,欢迎提 Issue;
- 单元测试覆盖折叠计价、价目解析、弹窗渲染,可用
node tests/*.test.mjs运行。
结构
index.js Host 半体:usageBilling 会话投影(请求数/token 桶/按请求时刻的时段计价/高峰反事实节省额/价目与节假日自动刷新)
client.js Client 半体:composer dock 胶囊(费用 + 空闲倒计时)+ 详情弹窗(剩余金额、节省额、当前时段价格)
cordis.patch.yml bundle 补丁:插入插件行与出厂价目/时段配置
locale/zh.json 插件管理页标题与描述(中文)
locale/en.json 同上(英文)
icon.svg 插件图标
assets/screenshots 界面截图(金额已打码)
tests/ 单元测试
CHANGELOG.md 变更日志
License
Comments
Loading…
Similar plugins
by X-avier-W
DeepSeek Harness 计费插件:当前会话成本 + 官方余额(官方峰谷价 / 每分钟余额对齐 / 期间实时扣减)
★ 0
↓ 40/wk
MIT
JavaScript
Aug 25, 2026
dsh plugin --profile web add dsh-elegent-balance-trackerby MrTomTao
给DeepSeek Harness Web GUI用的会话token计费插件:在会话标题栏显示本次会话的实时花费,点开可以看输入 / 缓存命中 / 缓存写入 / 输出 / 推理的分项、按模型的账单,以及当前用的是高峰还是空闲时段价。
★ 0
MIT
JavaScript
Oct 5, 2026
dsh plugin --profile web add dsh-token-billingby Mirfakk
DSH 额度面板:输入框下方实时显示本会话消费金额(官方峰谷分时计价)、token 用量与 DeepSeek 账户余额。
★ 0
MIT
JavaScript
Sep 21, 2026
dsh plugin --profile web add dsh-peak-usageby oliblue-evan
DSH 用量与余额:会话用量、按每笔实际发生时刻与模型计价的费用(峰谷/档位)、账户余额;账号登录无需 API Key。
★ 0
MIT
JavaScript
Sep 29, 2026
dsh plugin --profile web add dsh-usage-pillby ytftu
DSH(DeepSeek Harness)插件:底栏会话消费金额、每条回复本轮金额、右上角开放平台余额/今日用量/峰谷,点击弹出折线图。
★ 3
↓ 404/wk
MIT
JavaScript
Oct 31, 2026
dsh plugin --profile web add dsh-session-costby xiaml666
DSH 花费显示:每轮对话花了多少钱、整个会话累计多少钱,按官方价格表精确计价(自动刷新、高峰/低谷自动同步、多供应商多币种),并附带账户余额与可视化设置面板;余额与会话累计始终同币种。
★ 0
MIT
JavaScript
Sep 11, 2026
dsh plugin --profile web add dsh-plugin-cost