dsh-billing-mini-tag
Verifieddsh-billing-mini-tag · v0.3.1 · MIT · Web UI
DSH plugin: show the current session's spend (¥x.xx) at the right end of the composer statistics row, right of the context-usage meter, priced from the official token quote
Install
dsh plugin add dsh-billing-mini-tag Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-billing-mini-tag
English | 中文
在当前会话输入框下方的统计行最右侧、**上下文用量(context usage)**右边,常驻显示
本会话消费金额(¥x.xx)。金额按 DeepSeek 官方 Token 报价
计算。
右侧的 ¥1.47 就是这个插件
安装
两种方式,按你运行 DSH 的方式来选。
1. 在 shell 里安装
dsh plugin --profile web add dsh-billing-mini-tag
重启 dsh web 并刷新页面,然后发送一条消息。想固定版本,或直接跟随仓库而不是 npm 包:
dsh plugin --profile web add https://github.com/Refone/dsh-billing-mini-tag/archive/refs/tags/v0.3.1.tar.gz
dsh plugin --profile web add github:Refone/dsh-billing-mini-tag
再次执行同一条 add 命令即可更新;卸载:
dsh plugin --profile web remove dsh-billing-mini-tag
包内是纯 JavaScript、没有 prepare 脚本,因此从 GitHub 安装既不需要构建,也不需要
pnpm 的构建脚本授权。
2. 在 DeepSeek Harness Desktop 里安装
- 侧栏打开 插件。
- 点 添加插件 → 安装第三方插件。
- 在 包名或地址 里填入
dsh-billing-mini-tag(或github:Refone/dsh-billing-mini-tag),点 安装。 - 提示时点 立即启用;如果 DSH 提示需要重启,就重启应用——宿主半边要挂载计费路由, 第一次安装需要重启。
- 发送一条消息:
¥金额出现在输入框统计行最右侧、上下文用量右边。
如果访问不到 npm 或 GitHub,在同一个对话框里展开 安装源 换成镜像,或直接粘贴 Releases 里的 tarball 地址。
显示什么
- 只统计当前会话。 金额来自该会话持久化日志中的 token 用量,不是账号余额, 也不是所有会话的累计。
- 边用边更新。 浏览器半边每秒轮询一次宿主路由,步骤完成后数字就会变化, 不需要刷新页面。
- 在统计行最右侧。 角标是
conversation.composer.dock里order: 2的统计项。 该槽位渲染在官方的上下文用量指示之前,因此角标再带一个正的 CSSorder,保持排在 它右边(最初的布局),不会另起一行。
工作原理
包内包含两个半边:
| 半边 | 入口 | 职责 |
|---|---|---|
| 宿主 | src/index.js(. 导出) |
提供 GET /plugin-billing-mini-tag/cost?session=<id>,按 assistant step 折叠会话日志,并刷新官方报价。 |
| 浏览器 | src/client.js(./client 导出) |
注册 billing-mini-tag 这个 composer dock 统计项,把 ¥… 角标保持在统计行最右侧、上下文用量右边。 |
插件不声明 meta.title:DSH 会回退到包名 dsh-billing-mini-tag,而它同时也是组件行的
id 与模块名,因此组件行不再在标题下重复两行技术名。locale/*.json
保留描述(DSH 不会从包里推导它),以及角标 tooltip 的文案。
宿主半边:
- 启动时抓取一次官方中文报价页,之后每次发送消息再抓一次,并缓存最近一次 成功结果。请求 8 秒超时;首次抓取成功前(以及页面不可达时)使用内置报价。
- 按
turn:step折叠assistant/attempt/assistant/message的 usage:同一步 重复上报时后者替换前者,llm/retry-started会让重试单独计费,与 DSH 自身的tokenUsage投影保持一致。 - 记住每一步实际服务的模型,因此会话中途切换模型也按对应单价计费。
- 返回两位小数的展示字符串(
¥0.00),并附带原始 token 数、分模型明细、 报价来源与未知模型名,便于排查。未知会话、日志未加载、报价抓取失败都会 退化为 0 或沿用上一份报价,不会抛错打扰输入框。
该路由只接受同源请求:拒绝跨站调用,无请求头的探测只接受 loopback。另有调试
路由 GET /plugin-billing-mini-tag/quote 返回缓存的报价与当前单价。除抓取
报价页外不向任何地方发送数据,也没有遥测。
计费口径
单价为官方页面的「元 / 百万 token」:
| 桶 | 计价方式 |
|---|---|
| 缓存命中(从缓存读取的输入) | 缓存命中价 |
| 缓存未命中(未缓存输入) | 缓存未命中价 |
| 缓存写入 | 缓存未命中价 |
| 输出 | 输出价 |
高峰时段按北京时间判断(无夏令时):周一至周五 09:00–12:00、14:00–18:00。
官方报价未包含中国法定节假日,因此用工作日窗口做本地近似。报价无法识别的
模型按 deepseek-flash 计价,路由的调试字段会在 unknownModels 中列出它们。
环境要求
- DSH 0.2.x:包内声明
engines.dsh为>=0.2.0,该版本区间才有本插件 使用的 composer dock 列表槽位。 - Node.js 20 及以上。
- React 18 由宿主提供(peer dependency);插件本身没有运行时依赖。
- 可访问
api-docs.deepseek.com以获取实时报价;离线时仍可用内置报价。 - 浏览器半边注入 DSH 客户端的
locale服务(web 与 desktop 应用自带),用于角标 tooltip;fiber 会等待该服务,因此 tooltip 不会退化成原始 key。
需要
webServer服务。 插件通过随webbundle 提供的webServer暴露 计费路由,因此只要 profile 挂载了 web bundle 即可:webprofile 和桌面应用 的desktopprofile 都满足。装进只含dsh-base的自定义 profile 时,该行会 一直等待webServer,DSH 会拒绝启动。请用 web 模板初始化自定义 profile (dsh --profile <name> --from-default-profile web)。
开发
没有构建步骤:两个半边都是普通 ESM/JS,浏览器半边是手写的模块加载器
包装,不需要打包器。pnpm pack 会打包 src/、cordis.patch.yml、两份
README、CHANGELOG、LICENSE 和截图。
node scripts/check-release.mjs # 发布要求检查
node scripts/test-client.mjs # 浏览器半边冒烟测试(也可 pnpm test)
pnpm pack --dry-run # 查看最终 tarball 内容
scripts/check-release.mjs 检查 DSH 生态扫描的内容:dsh-plugin 关键字、README
中可复制的 dsh plugin --profile web add … 命令、导出的 apply(ctx) 模块、
可解析的 dsh.bundle.patch bundle 声明,以及包元信息、图标和 locale 键。
scripts/test-client.mjs 用桩替换 window.__ModuleLoader__、React、Cordis slots
服务和 locale 运行时,渲染页面真正会拿到的东西:¥x.xx 角标,以及中英两种语言的
tooltip。假上下文的 ctx.get() 恒为空,所以一旦有人改回可选查询,测试会失败,而不是
把原始 key 发到用户眼前。
.
├── src/index.js # 宿主半边(apply、报价、会话折叠、HTTP 路由)
├── src/client.js # 浏览器半边(composer dock 统计项 + ¥ 角标)
├── locale/{en,zh}.json # 插件描述 + 角标 tooltip 文案
├── icon.svg # 插件列表图标
├── cordis.patch.yml # bundle patch:把插件插入 profile
├── scripts/check-release.mjs
├── scripts/test-client.mjs
├── docs/development-trace.md
└── showcase.png
许可证
MIT © 2026 Refone