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的开发基线是 dsh0.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
- 打开聊天页随便聊一句 → 消息旁边和输入框下方就会显示费用。
想先试 Git 版也可以:
pnpm dsh plugin --profile web add github:gaishilaji/dsh-plugin-cost(首次安装会要求给该仓库的构建脚本授权,按提示操作)。
从 dsh 0.1.x 升级
- 先把 dsh 升级到 0.2.1+,再重新安装/更新本插件(
dsh plugin --profile <name> add dsh-plugin-cost@0.2,本地 link 安装则重新add一次让清单刷新); - 旧版写进
settings.yaml的dsh-plugin-cost: { enabled, perTurn }段不再读取(0.2 起设置改为写 profile 的cordis.patch.yml)。升级后在 Plugins → dsh-plugin-cost 里重新设置一次每轮限额即可; - 旧版设置页只出现在 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 校正——所有最终显示(每轮芯片、 浮层、总消费)一律为精确值。



No comments yet. Be the first to write one.