DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在使用 DeepSeek API 进行开发或对话时,实时掌握当前模型的输出价格以及账户余额很有必要。dsh-pricing-badge 插件正是为此设计,它将价格表和余额信息直接嵌入到 DSH Web UI 的输入框下方,提供直观的监控。
核心功能¶
这是一个 DeepSeek Harness Web UI 插件,由 ZhangBo-cmd 维护(MIT 许可证)。它主要解决以下问题:
- 实时状态指示:在输入框下方显示一个纯文字胶囊,包含当前是“高峰”还是“空闲”时段,以及节假日原因。
- 成本监控:显示当前会话所选模型的输出价格,以及 DeepSeek 账户余额。
- 价格速查表:点击胶囊展开价格表,支持对比不同时段(高峰/空闲)和不同场景(缓存命中/未命中)的价格。
工作原理¶
- 纯工具、纯前端:插件本身不发起任何模型请求,因此不会产生额外的 token 费用。余额读取由服务端代取。
- 自动刷新:按北京时间实时判定高峰/空闲,每 30 秒刷新一次状态。
- 价格来源:价格与时段规则来自 DeepSeek 官方定价页,内置 2026 年全年法定节假日。
安装与启用¶
安装命令本质是将参数转发给 profile 目录里的 pnpm,因此 --profile 是必填项。对于默认的网页界面,使用 --profile web。
- 安装插件:
dsh plugin --profile web add dsh-pricing-badge
- 启动 Web UI:
dsh web
- 验证安装:
安装后,刷新页面即可在输入框下方看到指示灯。可以通过以下命令验证配置是否生效:
dsh --profile web --dump-config
输出中应出现以 `dsh-pricing-badge` 命名的一层配置。
自定义与维护¶
如果需要调整价格或节假日规则,可以直接编辑 lib/client.js。
- 修改价格:编辑顶部的
DEEPSEEK_MODELS(DeepSeek 分时段模型)和THIRD_PARTY_MODELS(第三方固定价模型)数组。单位为每 100 万 tokens。 - 节假日配置:已内置 2026 年全年法定节假日。若官方调价,更新
HOLIDAYS数组即可。
注意事项¶
- 官方定价为准:价格数据来自 DeepSeek 官方页面,官方可能调价,请以官方页面为准。
- 构建授权:如果从 GitHub 源码安装,需要配置 profile 的
pnpm-workspace.yaml以允许构建授权(allowBuilds)。
结语¶
dsh-pricing-badge 是一个轻量级的成本监控工具,适合需要在 DSH 中频繁切换模型、关注高峰时段费用的用户。它不改变 DSH 的核心逻辑,仅提供直观的视觉反馈。
- 目录页:zhangbo-cmd/dsh-pricing-badge
- GitHub 仓库:zhangbo-cmd/dsh-pricing-badge