前言¶
DeepSeek Harness(DSH)通过插件扩展智能体工作流。对于在 DSH 中调用 DeepSeek V4 系列 API 的用户来说,峰谷定价会让高峰时段和空闲时段的模型成本、质量取舍不同:高峰时段更关注成本,空闲时段更关注模型能力。
deepseek-peak-valley-router 是一个 DeepSeek Harness 插件:它按当前时段自动路由模型,高峰时段使用 deepseek-v4-flash,空闲时段使用 deepseek-v4-pro;如果用户显式选择模型,插件不会覆盖用户选择。
这是什么¶
deepseek-peak-valley-router 是 Eligahyu 维护的 DSH 峰谷定价自动模型路由插件,许可证为 MIT。
它解决的问题是:
- 不需要手动在
deepseek-v4-flash和deepseek-v4-pro之间切换。 - 插件按峰谷时段自动路由到对应的 V4 型号。
- 用户显式选择的模型始终优先。
- 非目标 provider 或非这两个 V4 型号的请求保持原样。
核心功能¶
下面介绍该插件的主要行为。
1、自动识别峰谷时段。参考时区默认是 Asia/Shanghai,也可以配置为其他 IANA 时区。
2、按峰谷路由模型。
- 高峰时段自动路由到
deepseek-v4-flash。 - 空闲时段自动路由到
deepseek-v4-pro。
3、用户显式选择的模型始终优先。插件不会覆盖用户在模型选择器中做出的选择。
4、不越界处理请求。非 DeepSeek 官方 provider,或非 deepseek-v4-flash、deepseek-v4-pro 这两个 V4 型号的请求,一律不动或原样放行。
5、切换可审计。每次模型切换会记录进会话 request/header 事件,方便查看实际使用的模型。
6、提供对话级工具。
peakvalley_status:查看当前时段、目标模型和路由模式。peakvalley_reset:恢复自动路由。
7、配置容错。如果 timeZone 配置非法,插件会回退到默认时区并告警,避免请求失败。
8、边界处理。从 deepseek-v4-pro 切到 deepseek-v4-flash 时,插件会自动丢弃 reasoningEffort,避免请求被拒绝。
安装与启用¶
插件要求 Node >=20。
插件运行在 DeepSeek Harness 内,@deepseek-ai/dsh-tools 由宿主提供,无需手动安装。
组合插件安装¶
从 GitHub 安装插件:
dsh plugin --profile web add github:Eligahyu/deepseek-peak-valley-router
安装后重启对应 profile 生效:
dsh --profile web
动态插件安装¶
如果想在当前 Harness 对话里直接试用,可以用动态插件方式。
在 Harness 对话里使用 cordis_define 工具创建插件,把 dynamic/host-code.js 中 HOST_CODE 的完整内容粘贴到 code.host 参数,然后使用 cordis_run 激活。
动态版会额外暴露 harness.handle('peak-valley-status') Host 通道。组合版没有 Host 通道,状态查询通过 peakvalley_status 完成。
时区配置¶
默认参考时区为 Asia/Shanghai。如果需要修改,在 profile 的补丁层追加插件配置:
# ~/.dsh/profiles/web/cordis.patch.yml 追加
- id: deepseek-peak-valley-router
config:
timeZone: 'America/New_York'
如果配置了非法的 timeZone,插件会回退默认时区并告警。
典型用法¶
安装并启用后,可以在对话中查看当前路由状态:
调用 peakvalley_status
它会返回当前时段、目标模型和路由模式。
如果之前用户显式选择了某个模型,需要恢复自动路由时,可以调用:
调用 peakvalley_reset
该操作会清除内存中的用户选择记录,让插件重新进入自动路由状态。
适用场景与注意¶
适合在 DSH 中使用 DeepSeek V4 系列 API,并且希望按峰谷定价自动切换 deepseek-v4-flash 与 deepseek-v4-pro 的用户。
使用前注意以下几点:
- 峰谷时段和价格以 DeepSeek 官方公告为准。插件按公告实现,不保证与未来价格政策一致。
- 自动切换模型可能改变回答质量或行为。重要任务请留意会话
request/header中实际使用的模型。 - 插件激活前已创建的会话,自动路由会在下次页面刷新或重连后对该会话生效;手动选择模型会立即生效,并且插件尊重该选择。
- 插件以当前
dsh进程权限运行。安装前应检查源码、许可证和行为是否符合预期。 - 本插件与 DeepSeek 官方无任何隶属关系,非官方作品。
结尾¶
deepseek-peak-valley-router 的价值在于把峰谷定价下的模型选择变成自动路由:高峰用 deepseek-v4-flash,空闲用 deepseek-v4-pro,同时保留用户显式选择的优先权。
GitHub 地址:https://github.com/Eligahyu/deepseek-peak-valley-router
目录页地址未在本文核实,建议直接按插件名 deepseek-peak-valley-router 在 DSH 社区目录中检索。