前言¶

在 DSH 里使用 DeepSeek 时，需要随时确认当前会话已经产生多少花费，但不想手动查价格、手动乘单价，也不希望费用展示插件额外发起外部请求。

dsh-cost 是一个 DSH 原生插件：按 DeepSeek 峰谷价格表实时计算当前对话花费，并把金额徽标显示在输入框旁。

这是什么¶

dsh-cost 由 kami-mura 维护，用于 DSH Web 端会话。它根据 DSH 内置 deepseek-official provider 上报的 token usage，把当前对话花费折算成 CNY 或 USD，并常驻显示在输入框旁。

许可证为 MIT。

核心功能¶

• 输入框旁常驻金额徽标，token 用量变化时自动更新。
• 货币可在 DSH 设置 > 插件 > Plugin configuration 中选择 CNY 或 USD，默认 CNY，选择保存在当前浏览器。
• 悬浮提示语言跟随 DSH 系统语言：中文 / English。
• 悬停费用图标后可查看输入 tokens、输出 tokens、flash 花费、pro 花费。
• 展示费用四舍五入保留两位小数；不足 0.01 时显示为 <0.01。
• 按 DeepSeek 官方人民币与美元价格表、北京时间峰谷时段计价。
• 分开计算缓存命中、缓存未命中、缓存写入与输出。
• 同一 turn/step 的 usage 按投影替换规则去重。
• 未识别第三方模型不猜价，显示 ≈/¥0+ 或 ≈/$0+。
• Host 端 durable 会话投影 costLog 计算，翻页、上下文压缩、历史补拉不改变累计值。
• 浏览器端只读投影并渲染，不发外部请求。
• 样式使用 DSH WebUI 设计令牌，明暗主题自动跟随。

安装与启用¶

先添加插件：

dsh plugin --profile web add github:kami-mura/dsh-cost

安装后需重启 dsh web 服务生效。

卸载时使用：

dsh plugin --profile web remove dsh-cost-log

典型用法¶

1、打开任意会话，输入框右侧会出现费用徽标。

2、悬停费用徽标，查看输入 tokens、输出 tokens、flash 花费、pro 花费。

3、点击费用徽标，查看 flash / pro 花费明细。

4、切换货币：打开 DSH 设置 > 插件 > Plugin configuration，选择 CNY 或 USD。

5、如需运行测试：

node --test tests/*.test.mjs

计价口径与限制¶

• 只给 DSH 内置 deepseek-official provider 的完整模型 ID deepseek-v4-flash 与 deepseek-v4-pro 计价。
• 未识别的第三方模型不猜价，显示 ≈/¥0+ 或 ≈/$0+。
• 分开计算缓存命中、缓存未命中、缓存写入与输出。
• 同一 turn/step 的 usage 按投影替换规则去重，避免同一用量被重复计入。
• 金额是依据 provider 上报 token usage 的参考估算，不是 DeepSeek 官方账单。

架构与隐私¶

• Host 端通过 durable 会话投影 costLog 计算累计花费；翻页、上下文压缩、历史补拉不会改变累计值。
• 浏览器端只读投影并渲染，不发外部请求。
• 不读取 API Key、不查询账户余额、不发送外部请求。
• 不需要数据库、代理或额外常驻服务。
• 依赖 DSH 运行时能力：Host sessionProjections；Client slots、locale、react 平台模块与 ui-conversation 的 conversation.input.right 插槽。

适用场景与注意¶

适合需要在 DSH Web 会话中持续查看 DeepSeek 对话花费的人，尤其是使用 deepseek-v4-flash 与 deepseek-v4-pro 的场景。

安装前应检查源码与 MIT 许可证。插件以当前 dsh 进程权限运行，建议仅安装来自可信来源的版本。

1.0.0 起进入稳定维护：不再增加功能，只在 DeepSeek 官方价格变化或 DSH 接口变化时更新。

链接¶

GitHub 仓库：https://github.com/kami-mura/dsh-cost