成本前瞻 manhkhiemhoang2-bit/dsh-costcast

dsh-costcast

DeepSeek Harness 插件：在输入框上方常驻一条读数，告诉你下一步和这一轮大概要花多少钱。

读数条

已有的成本插件都在报「已经花了多少」。这个插件报的是「接下来要花多少」——因为影响决策的是后者。

它做什么

会话每多跑一步，都要把整个上下文重新发一遍，而上下文只增不减。结果是单步成本随会话一路变贵，总花销涨得比步数快得多。这个插件把这条增长曲线摆到台面上：

- 下一步：按当前上下文规模、本会话实测的缓存命中率、每步平均输出，估算下一次请求的花费
- 本轮：再乘上本会话实测的每轮步数，给出「再问一轮」的区间
- 上下文占比：与宿主自带的上下文圆环同一口径，超过 70% 时提示开新会话
- 每步成本走势：装好之后开始累积，让上下文变贵这件事可见

点一下读数条，向上展开成本构成：会话累计、三个计费桶各自的金额、每步成本曲线。

和别的成本插件有什么不同

| | 常见的成本插件 | dsh-costcast |
| 时间方向 | 过去（已花掉多少） | 未来（下一步要花多少） |
| 数值形式 | 精确的单点值 | 区间 |
| 关注点 | 总账 | 边际成本 |
| 注册的工具 | 通常带查询工具或命令 | 一个都不注册，冲突面为零 |

三类数字来源完全不同，互不重复。这个插件也不展示 token 构成——宿主自带的上下文占用圆环已经做了那件事。

安装

要求 DeepSeek Harness 桌面版（内核 0.2.0-rc.2 及以上）。

git clone https://github.com/manhkhiemhoang2-bit/dsh-costcast.git

然后走 Harness 自己的插件通道安装（把路径换成你的克隆位置）：

& "$env:APPDATA\DSH Desktop\host-commands\desktop\generations\<最新一代>\bin\dsh.cmd" plugin --profile desktop add "C:\path\to\dsh-costcast"

这条命令会一次性完成依赖链接、dsh.profile.bundles 登记和 node_modules 软链，不需要手工改 profile 的任何文件。装完重启应用（客户端半端在启动时加载）。

卸载：

& $dsh plugin --profile desktop remove dsh-costcast

界面说明

读数条

上下文 562K │ 下一步 ¥0.032–0.036 │ 本轮 ¥0.19–0.54 │ 空闲价 ▁▂▃▅▇

| 段 | 含义 |
| 上下文 | 下一次请求要发送的上下文规模 |
| 下一步 | 下一次请求的成本区间 |
| 本轮 | 再问一轮的总成本区间；本会话还没有步数样本时显示 — |
| 价格档 | 当前处于空闲还是高峰时段，高峰时标为琥珀色 |
| 走势 | 最近若干步的成本柱状图，越高越贵 |

展开面板

分四块：

1. 会话累计：整个会话到目前为止的花费，按当前价格档计算
2. 构成：缓存读、输出、未缓存三个桶各自的 token 数与金额
3. 每步成本：从插件装上那一刻开始累积的走势
4. 提示：上下文占比与缓存命中率；占比过高时改为开新会话的建议

估算模型

下一步输入 = projectedTokens（按本会话实测命中率拆成 命中 / 未命中）下一步输出 = outputTokens ÷ steps，取 [0.5×, 1.5×] 作为区间单步成本 = 命中×命中价 + 未命中×未命中价 + 输出×输出价一轮成本 = 单步成本 × 每轮步数区间（steps ÷ turns 的 [0.6×, 1.5×]）

三项输入里，命中率和每步平均输出来自本会话实测，下一步上下文规模由宿主投影直接给出。
唯一不可预知的是输出长度，用带宽覆盖——这也是给区间而不是单点值的原因。

完整的推导、真实数据、以及模型会低估或高估的具体情形，见 DESIGN.md。

价格

内置价目（元 / 百万 tokens），来自 DeepSeek 官方文档，查证日期 2026-10-12：

| 模型 | 缓存命中 空闲 | 缓存命中 高峰 | 未命中 空闲 | 未命中 高峰 | 输出 空闲 | 输出 高峰 |
| deepseek-flash | 0.02 | 0.04 | 1 | 2 | 4 | 8 |
| deepseek-v4-pro | 0.15 | 0.30 | 4.5 | 9.0 | 13.5 | 27.0 |

高峰时段为北京时间周一至周五（不含法定节假日）9:00–12:00 与 14:00–18:00，其余时段为空闲，空闲价是高峰价的一半。

价格会调整，内置值只是一份快照。用之前建议对照官方价格页 确认。

数据来源

全部来自客户端投影，插件不读会话文件、不轮询、不发起网络请求、申请零额外权限。

| 投影 | 提供方 | 取什么 |
| tokenUsage | dsh-token-meter | 会话累计的四个计费桶 |
| contextPressure | dsh-token-meter | 上下文规模与窗口容量 |
| sessionStats | dsh-session-stats | 轮数与步数 |

宿主半端（index.js）是空的，只作为 bundle 的入口存在。

已知限制

- 模型名写死为 deepseek-flash。客户端投影里没有当前模型名，换模型需要同步改 src/component.js 里的 MODEL 常量
- 法定节假日没有内置。每年的假期安排会调整，写死会过期，所以只按周末与时段判断峰谷
- 每步走势从装上那刻开始累积，重启后清零。投影只提供会话累计，历史由插件自己攒
- 界面文字只有中文，未接入 locale 服务
- 峰谷判断依赖运行机器的时钟换算北京时间，机器时区错误会判错价格档

开发

bash
node build.mjs # 生成 client.js（改了 src/ 必须重新跑）
node --test test/estimate.test.mjs test/client.test.mjs
node --check client.js

client.js 是构建产物，不要直接编辑。源码分两部分：

- src/estimate.js：估算内核，纯函数，不依赖 DSH，可脱离宿主单测
- src/component.js：读数条与展开面板

测试共 42 例。估算内核的期望值按手算写死，另外有一组用真实会话数据做量级核对；客户端测试在 Node 里用桩件跑真实的 client.js，验证模块加载契约、槽位注册参数和渲染输出。

项目结构

src/estimate.js 估算内核：价格表、峰谷判断、成本区间、格式化 src/component.js 读数条与展开面板 build.mjs 把上面两个内联进浏览器包 client.js 构建产物：浏览器半端 index.js 宿主半端（空） cordis.patch.yml bundle patch test/ 42 个测试 docs/readout.svg 读数条示意图

许可证

MIT

蓝鲸标记取自微软 Fluent Emoji（MIT），出处与协议全文见 THIRD-PARTY.md。

本项目是社区插件，与 DeepSeek 官方无隶属关系，也未获得官方背书。