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 │ 空闲价 ▁▂▃▅▇
| 段 | 含义 |
|---|
| 上下文 | 下一次请求要发送的上下文规模 |
| 下一步 | 下一次请求的成本区间 |
| 本轮 | 再问一轮的总成本区间；本会话还没有步数样本时显示 — |
| 价格档 | 当前处于空闲还是高峰时段，高峰时标为琥珀色 |
| 走势 | 最近若干步的成本柱状图，越高越贵 |
展开面板
分四块：
- 会话累计：整个会话到目前为止的花费，按当前价格档计算
- 构成：缓存读、输出、未缓存三个桶各自的 token 数与金额
- 每步成本：从插件装上那一刻开始累积的走势
- 提示：上下文占比与缓存命中率；占比过高时改为开新会话的建议
估算模型
下一步输入 = 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 服务
- 峰谷判断依赖运行机器的时钟换算北京时间，机器时区错误会判错价格档
开发
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 官方无隶属关系，也未获得官方背书。
