DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

gaishilaji /

gaishilaji/dsh-plugin-cost

Verified

deepseek harness插件,展示每轮对话的总消费及消费详情。

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@b031f287

dsh-plugin-cost — DeepSeek Harness 对话费用实时显示

dsh-plugin-cost

给 DeepSeek Harness 的聊天界面装一个「账单显示器」——每条回复花了多少钱、整场对话花了多少钱、有没有超预算,全部实时显示,不用再自己去查用量。插件设置里开启限额提示后,对话进行时会动态估算当前已经产生的消费。

版本对应:dsh 0.2.x 用插件 0.2.x,dsh 0.1.x 用插件 0.1.5——不知道装哪个先看下表。插件在 package.json 里用 engines.dsh 声明兼容范围,版本不匹配时 dsh 在启动时会直接拒绝加载并给出提示,不会静默崩溃。

🧩 版本对应(先看这里)

插件版本 适配的 dsh 版本 安装命令 设置入口
0.2.x(当前 0.2.0) >= 0.2.1-rc.2 且 < 0.3.0 dsh plugin --profile web add dsh-plugin-cost@0.2 Plugins → dsh-plugin-cost
0.1.x(最后 0.1.5) >= 0.1.1-rc.1 且 < 0.2.0 dsh plugin --profile web add dsh-plugin-cost@0.1.5 Settings → Plugins
  • 先确认自己的 dsh 版本:dsh --version;在 dsh 源码目录里用 pnpm dsh --version,安装命令同理换成 pnpm dsh plugin ...。
  • 建议显式带版本号安装:不带版本号时取 npm 的 latest 标签,标签指向哪一版就装哪一版,可能和你的 dsh 不匹配。
  • 0.2.0 / 0.2.0-rc 系列 dsh 不在本插件 0.2.x 的声明范围内,请先把 dsh 升到 0.2.1-rc.2 及以上。
  • 插件 0.1.5 的开发基线是 dsh 0.1.1-rc.2,dsh 0.1.6/0.1.7 未逐一回归;能升级 dsh 的话,建议直接升到 0.2.1+ 并换用插件 0.2.0。

🎬 效果演示

对话进行中费用实时上涨
① 对话进行中:本轮费用 实时上涨,接近限额变红提醒
本轮总消费与悬停明细
② 回复完成:消息旁显示 本轮总消费,悬停查看每次调用的明细
会话总消费读数带
③ 输入框下方常驻:整场会话总消费与输入/输出 token
④ 设置入口:Plugins → dsh-plugin-cost → 每轮消费限额
0.2 起配置页随插件详情页展示,保存即写入当前 profile 的 cordis.patch.yml,无需重启

✨ 它能做什么

  • 每条回复一个价签(见图②):消息旁多出 本轮总消费 ¥0.0987,悬停可见这条回复本身多少钱、中间的每次调用(思考、查文件、跑命令…)各花了多少;
  • 整场对话心里有数(见图③):输入框下方常驻 总消费 ¥X · 输入 N · 输出 M,随时瞄一眼;
  • 预算提醒,防止跑冒(见图①④):给每轮设个上限(如 ¥1),对话中在输入框上方实时显示 本轮 ¥0.34 / 限额 ¥1.00,快超时变红;超了的那轮价签也标红;(目前仅作提示,如果消费超出心里预期,请主动停止当前对话)
  • 自动按官方分时价计费:DeepSeek 高峰时段(工作日北京时间 9:00–12:00、14:00–18:00)价格翻倍、其余半价,插件按每条回复的发生时刻自动判断;
  • 价格自己说了算:所有单价在配置文件里,官网调价后改几个数字即可,不用等插件更新。

金额为实时估算,以 token 用量 × 单价计算,单轮/单会话误差很小;最终以 DeepSeek 官方账单为准。

🚀 安装(三步)

# 1. 安装(在 dsh 源码目录下用 pnpm dsh,npm 安装版直接 dsh)
pnpm dsh plugin --profile web add dsh-plugin-cost

# 2. 重启 dsh web 生效
pnpm dsh web
  1. 打开聊天页随便聊一句 → 消息旁边和输入框下方就会显示费用。

想先试 Git 版也可以:pnpm dsh plugin --profile web add github:gaishilaji/dsh-plugin-cost(首次安装会要求给该仓库的构建脚本授权,按提示操作)。

从 dsh 0.1.x 升级

  1. 先把 dsh 升级到 0.2.1+,再重新安装/更新本插件(dsh plugin --profile <name> add dsh-plugin-cost@0.2,本地 link 安装则重新 add 一次让清单刷新);
  2. 旧版写进 settings.yaml 的 dsh-plugin-cost: { enabled, perTurn } 段不再读取(0.2 起设置改为写 profile 的 cordis.patch.yml)。升级后在 Plugins → dsh-plugin-cost 里重新设置一次每轮限额即可;
  3. 旧版设置页只出现在 Settings 的 Plugins 分区;新版改在 Plugins(插件管理)页 → 本包详情页,配置项与行为不变。

🤔 常见问题

Q:显示的价格准吗? 按官方价目表实时计算,展示的就是精确的 token 用量 × 单价(分时价自动处理)。极端情况下与实际账单可能有几分钱级舍入差异,以 DeepSeek 官方账单为准。开启限额后的流式估算会有一定误差,因为那个时候拿不到具体token消费,只能根据字符估算token,同样的在单轮次其误差忽略不计。

Q:价格变了怎么办? 不用等插件更新——打开 dsh 的配置(cordis.patch.yml),找到 config.prices 改数字即可,改完生效。

Q:支持哪些模型? 目前内置 DeepSeek 各模型的价格表(见下)。其他模型会照常统计 token 用量,费用暂记 0,在价格表里补一行就能计费。


开发者文档

定价与计费口径

按 DeepSeek 官方《模型 & 价格》(2026-08 快照)计价,单价单位为元 / 百万 tokens,配置存高峰价、空闲自动 ×0.5:

费用 = 未命中输入 × miss单价 + 缓存命中输入 × hit单价 + 输出 × 输出单价
模型 输入·缓存命中 输入·缓存未命中 输出
deepseek-v4-flash / v4-flash-vision-exp ¥0.10 ¥3.00 ¥9.00
deepseek-v4-pro ¥0.30 ¥9.00 ¥27.00

每条消息按其发生时刻判断峰谷(可重放、幂等);同一消息重放不重复计费。

配置项

字段 默认 说明
prices 上表 { [model]: { cacheHit, cacheMiss, output } },高峰价(元/百万)
peakMode auto auto 按北京时间分时;peak 恒高峰;off-peak 恒空闲
defaultModel deepseek-v4-flash 读不到模型名时的兜底
budget.enabled false 是否启用每轮消费限额(也可在 Plugins 页改)
budget.perTurn 1 每轮消费上限(元)
budget.mode 'warn' 超限行为:'warn' 仅提示('ask' 预留,未实现)

限额可双通道配置:cordis.patch.yml 的 config.budget(组合层默认值)或 Plugins → dsh-plugin-cost 的配置页(user 层,写入当前 profile 的 cordis.patch.yml)。 budget 整体声明为 volatile:保存后 Loader 原地替换配置引用,宿主投影在下一次 wire 视图里带上新限额——无需重启。与组合层相同的值会用 unset 清除 user 覆盖层。

项目结构

dsh-plugin-cost/
├── package.json          # dsh.bundle + dsh.client;peer/dev 依赖;scripts
├── tsdown.config.ts      # 宿主 ESM 库 + 浏览器 CJS bundle 两段构建
├── cordis.patch.yml      # bundle 配置层(价格表、峰谷、限额在此配置)
├── dev/cordis.yml        # 开发期 --patch overlay(只加载宿主半身)
├── src/
│   ├── index.ts          # 宿主:cost 投影(计费 + turn/step + 当前轮 + 限额/估算口径下发)
│   └── client/
│       ├── index.tsx     # 浏览器:input.dock 动态本轮/限额行 + assistant-actions 汇总芯片/浮层 + composer.dock 总消费
│       └── settings-card.tsx  # 浏览器:Plugins → 本包详情页的每轮限额配置页(configForms)
└── test/smoke.mjs        # 峰谷/单价 + Config volatile + 投影折叠 + client 握手/槽位注册验证

工作原理(dsh 机制速览)

  • 宿主侧:从会话事件流(assistant/message 携带的 usage)按消息 id 折叠费用明细, 注册为名为 cost 的 projection(ctx.sessionProjections.register);用 turn/start、turn/end 维护"当前轮"(openTurn);并把当前生效的每轮限额 (读取 volatile 配置)与流式估算口径作为 wire 视图附加字段随帧下发;
  • 0.2 的会话事件变化:assistant/chunk 已移除,流式增量只作为 transient 的 agent/assistant-stream 帧存在,不进入会话日志。因此"进行中"的实时读数改由 浏览器半身读取 Chat 的 useChat(...).legacy.partial(当前流式步骤的 blocks),按 wire 下发的 estimation(字符/token 系数、输出单价、峰谷策略) 自行估算;每步 assistant/message 落账后即切换到精确 usage;
  • 设置:0.2 起 installSettingsSection/settingsScope 移除,插件配置由 Loader 条目的 Config schema 投影。本包把 budget 声明为 volatile 字段,配置页通过 ctx.configForms.get('cost') 读写(plugins.bundle.config 槽位,键 = 包名), 保存由 ConfigEditor 写入 profile 的 cordis.patch.yml;
  • 浏览器侧:useProjection('cost') 订阅宿主推送,渲染三处—— conversation.input.dock(运行中本轮/限额动态行)、 conversation.chat.assistant-actions(每轮总消费芯片与 hover 明细)、 conversation.composer.dock(总消费读数带);
  • 宿主侧 inject: ['sessionProjections']、浏览器侧 inject: ['slots']:Cordis 的"未声明即访问"契约。

开发与验证

pnpm install
pnpm typecheck && pnpm test     # test = build + smoke(含官网价格核对断言)
# 注:dsh 0.2 的类型图较大,typecheck 脚本已固定 8GB 堆;如仍 OOM 可调大该数值

本地快速试宿主半身(在 dsh checkout 根):

pnpm dsh web --patch /absolute/path/to/dsh-plugin-cost/dev/cordis.yml --no-open --port 3081

浏览器半身需安装进 profile(client 插件集合变更后重启生效):

pnpm dsh plugin --profile web add /absolute/path/to/dsh-plugin-cost
pnpm dsh web

已知边界

  • 金额为估算,与实际账单可能存在舍入/汇率/活动差异,以 DeepSeek 官方账单为准;
  • 费用按 assistant/message 的 usage 计算:一次请求(step)一条消息; 同一会话重放(刷新/恢复)由 projection 缓存保证不重复计费;
  • 每条消息的费用在消息出现后即刻显示(投影帧随事件流推送,可能比消息渲染晚一拍);
  • 运行中的"流式估算"是近似值:浏览器按当前 partial 已流出的字符数 × 约 3.2 字符/token × 输出单价推算,只覆盖输出侧(思考/正文/工具参数),并按 defaultModel 计价 (流式中模型名未知);每步完成即以真实 usage 校正——所有最终显示(每轮芯片、 浮层、总消费)一律为精确值。
—/ 5

No ratings yet

Verified DSH bundle

Commit b031f287c833

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout