dsh-deepseek-price-tip：在 DeepSeek Harness 中实时查看 API 峰谷价格

它是做什么的？

DeepSeek 价格峰谷提醒是 DeepSeek Harness（DSH）的价格提醒插件，在 Harness Web UI 输入框下方显示一个小胶囊，告诉你 DeepSeek 官方 API 当前处于峰价还是谷价，以及距离下次切换还有多久。它解决的是调用官方 API 时容易忽略峰谷时段、事后才发现费用偏高的问题，让你在发请求前就能看到当前档位。插件由 jaaaa34 维护，采用 MIT 协议，用 JavaScript 编写，没有第三方依赖，只使用 Node 内置模块。

核心功能

• 实时峰谷读数：按官网规则计算当前时段（北京时间 09:00–12:00、14:00–18:00，周一至周五，不含中国法定节假日），并倒计时到下一次切换。
• 人民币价目表：读取官方中文定价页，列出模型、档位、缓存命中与未命中输入价、输出价，峰谷两档同时展示并高亮当前生效的一档。
• 从官网更新：面板中的“立即更新”会重新抓取价格与峰谷时段规则，包括时间窗口、星期和是否排除节假日。
• 自动更新：启动时以及之后每 30 分钟检查一次，缓存超过设定小时数就在后台重新抓取；抓取失败时保留旧表并报告原因。
• Agent 工具：提供 deepseek_price_tip 工具，支持 status 与 refresh 两个动作，与面板共用同一份数据。

怎么使用这个插件？

在 DSH 中启用并重启 Harness Web UI 后，输入框下方就会出现胶囊，点开即可查看价目表、峰时规则、数据来源和抓取时间。需要最新价格时点“立即更新”，插件会从官网重新抓取；也可以在对话中让 Agent 调用 deepseek_price_tip 查询状态或触发刷新。自动抓取间隔、峰时窗口、星期规则、追加节假日和抓取地址都可以在配置里调整，把自动刷新设为 0 即可关闭后台抓取、只保留手动按钮。节假日目前只内置到 2026 年，跨年后需在配置中补充，否则界面会提示未内置该年节假日。

报错怎么排查？

如果官网表格结构发生大改，解析会失败而不会写入半张表，界面继续显示上一次成功的数据并提示失败原因，此时按官方说明修复解析器或更换抓取地址。若界面提示未内置该年节假日，在配置中追加对应日期即可，避免把节假日误报成峰价。重新安装或升级插件会丢失本地缓存，下次刷新时重新抓取，期间使用内置兜底数据。