前言¶
DeepSeek 的官方定价策略根据时间段区分费率，周一至周五 9:00-12:00 和 14:00-18:00 为高峰时段，其余时间为空闲时段。在 DeepSeek Harness (DSH) 的 Web 界面中，如果不使用辅助工具，开发者很难直观地看到当前处于哪个时段以及会话的实时成本。dsh-peak-pricing 插件通过在 Composer 底部增加一行信息，直接显示当前生效的定价时段、剩余时长（秒级）以及会话累计成本，帮助开发者根据成本节奏调整工作计划。
插件概览¶
这是一个 DeepSeek Harness Web 插件，由 Oliver0804 维护，遵循 MIT 许可证。它解决了在 Web 界面中缺乏实时成本监控和定价时段提示的问题，同时兼容其他厂商模型的固定费率显示。
核心功能¶
- 显示定价时段与倒计时：实时判断当前是高峰还是空闲时段，并显示倒计时。
- 实时会话成本估算：基于每一步 token 的使用量，根据当时生效的费率累加成本。
- 悬停查看趋势：鼠标悬停（或键盘聚焦）该行，可查看缓存命中率趋势图及详细费率桶。
- 支持多厂商：除 DeepSeek 外，还支持 z-ai/glm-5.3-flash 等其他厂商的固定费率模型。
安装与启用¶
在安装前，请确保已安装 Node.js >= 20。插件通过 DSH 的插件系统加载。
- 安装插件：
在终端中执行以下命令：
dsh plugin --profile web add dsh-peak-pricing
安装完成后，重启 `dsh web` 即可在界面中看到新增的行。
- 验证安装：
确认插件配置已生效：
dsh --profile web --dump-config | grep peak-pricing
- 移除插件：
若需卸载，执行：
dsh plugin --profile web remove dsh-peak-pricing
- 本地开发安装：
如果需要调试或安装特定版本，可先打包：
npm pack
dsh plugin --profile web add "file:$PWD/dsh-peak-pricing-<version>.tgz"
定价逻辑与数据¶
时段与费率¶
DeepSeek 的高峰时段为周一至周五 9:00-12:00 和 14:00-18:00（北京时间），周末及节假日为空闲时段。插件通过 UTC +8 时区计算，确保不同浏览器的显示一致。
成本计算方式¶
成本计算采用增量累加而非简单按结束费率重算：
1. 每次获取新的 tokenUsage 投影时，与上一次的值做差分。
2. 差分部分的 token 数量，根据获取时的实时费率进行计费。
3. 首次读取会话时，因为没有上一次数据，会按当前费率一次性计费。
数据存储¶
运行总成本存储在 localStorage 中，以会话 ID 为键，刷新页面后数据不丢失。若模型不在定价表中，插件仍会显示时段和倒计时，但不会显示成本。
缓存命中处理¶
根据官方定价逻辑：
- cacheReadTokens 计入缓存命中输入费率。
- uncachedInputTokens 和 cacheWriteTokens 计入缓存未命中输入费率。
兼容性与限制¶
生态兼容¶
该插件与 dsh-live-stats 插件兼容。由于 dsh-live-stats 会将统计行合并为一行，该插件会注入少量样式，使价格行能够独立换行显示，避免被挤压。
本地源码修改¶
价格表位于插件的 src/pricing.ts 文件中。如果需要更新 DeepSeek 官方的新定价，只需修改该常量并重新构建即可。该文件仅包含纯逻辑，不依赖 React 或 DOM。
总结¶
dsh-peak-pricing 是一个专注于成本控制的实用工具，它通过插件形式集成到 DeepSeek Harness Web 界面中。它不仅能让你在操作时一目了然地看到当前费率，还能通过趋势图辅助判断缓存效果。对于需要频繁调用 API 的开发者来说，这是监控成本节奏的有效手段。
