deepseek-peak-valley-router
English | 简体中文
DeepSeek Harness 的峰谷定价自动模型路由插件:自动识别 DeepSeek API 当前处于高峰还是空闲时段,并据此自动选择模型——高峰时段用便宜的 deepseek-v4-flash 省钱,空闲时段用更强的 deepseek-v4-pro 提质量。你显式选择的模型始终优先,插件绝不剥夺你的选择权。
> 背景:DeepSeek 自 2026-08-17 起对 V4 系列 API 实行峰谷定价——高峰时段价格为空闲时段的 2 倍。官方高峰时段按北京时间定义为 09:00-12:00 与 14:00-18:00,其余为空闲时段。本插件据此自动调度,无需手动换模型。
功能
- 自动识别峰谷:参考时区(默认
Asia/Shanghai,可配置)换算任意系统时区/夏令时下的当前时刻,判定高峰/空闲 - 自动路由:高峰 →
deepseek-v4-flash;空闲 →deepseek-v4-pro - 用户选择优先:你在模型选择器里显式选择的模型会被直接路由到(同一 provider 下,无论请求当前配置是什么),通过监听
agent-default-model设置的变更事件识别 - 不越界:非 DeepSeek 官方 provider、非这两个 V4 型号的请求一律不动
- 可审计:每次切换都是
agent/request瀑布的正式返回,记录进会话request/header事件,不是静默漂移 - 对话级工具:
peakvalley_status— 查询当前时段、参考时区时间、目标模型、路由模式(auto / respect)、你显式选择的模型peakvalley_reset— 恢复自动路由(清除内存中的用户选择记录,直到你再次在界面选模型)- 健壮性:非法
timeZone配置自动回退默认时区并告警,绝不会让请求失败;启动兜底采用懒加载,与宿主服务加载顺序无关 - 边界处理:从 pro 切到 flash 时自动丢弃
reasoningEffort(flash 可能仅支持off),避免请求被拒绝
时段规则(官方)
| 时段 | 北京时间 | 定价 | 自动路由 |
|---|---|---|---|
| 高峰 | 09:00–12:00、14:00–18:00 | 全价(空闲的 2 倍) | deepseek-v4-flash |
| 空闲 | 其余时间 | 半价 | deepseek-v4-pro |
> 价格以 DeepSeek 官方公告为准,见文末参考链接。若官方调整时段,修改 lib/timezone.js 中的 PEAK_WINDOWS 即可。
安装
方式 A:动态插件(推荐试用,无需重启)
在 Harness 对话里用 cordis_define 工具创建插件,把 dynamic/host-code.js 中 HOST_CODE 的完整内容粘贴到 code.host 参数,然后 cordis_run 激活即可。
方式 B:组合插件(官方 bundle 安装,永久生效,需要重启)
本包是标准 DSH bundle(声明了 dsh.bundle 与 cordis.patch.yml),用官方安装路径即可:
# 本地 checkout
dsh plugin --profile web add ./deepseek-peak-valley-router
# 或从 GitHub
dsh plugin --profile web add github:Eligahyu/deepseek-peak-valley-router
# 发布到 npm 后(推荐,无需构建授权):
dsh plugin --profile web add deepseek-peak-valley-router
dsh --profile web # 重启生效
时区配置(可选,默认 Asia/Shanghai):在 profile 自己的补丁层覆盖即可:
# ~/.dsh/profiles/web/cordis.patch.yml 追加
- id: deepseek-peak-valley-router
config:
timeZone: 'America/New_York'
> 依赖:运行在 DeepSeek Harness 内,@deepseek-ai/dsh-tools 由宿主提供(见 package.json 的 peerDependencies),经 launcher 维护的扁平模块回退自动解析,无需手动安装。
行为规则(优先级从高到低)
- 用户显式选择的模型 —— 永远优先。你在模型选择器里选的每个模型都会写入
agent-default-model设置,插件监听该设置的变更事件;一旦检测到,同一 provider 下的所有请求都直接路由到你选择的模型(请求当前配置来自会话/子代理的冻结值时也不例外)。插件启动后首个请求若发现默认模型已是 pro(非出厂默认 flash),也会视为你的历史选择。 - 自动路由(默认)。未检测到显式选择时,按参考时区自动切换。
- 不越界。非 DeepSeek provider 或非 V4 双型号的请求原样放行。
工作原理
- 时区换算:
lib/timezone.js用Intl.DateTimeFormat(IANA 时区,hourCycle: 'h23')把机器墙钟时间换算到参考时区,任何系统时区/夏令时下都正确;非法时区回退默认时区,Intl 不可用时回退UTC+8偏移(Asia/Shanghai 无夏令时)——请求路径上绝不抛错。 - 路由缝:挂接
agent/request瀑布事件——next()产出冻结的LlmCallConfig,返回替换对象即完成切换,循环会把切换记录进request/header。 - 选择权:用户显式选择由 Harness 自身的会话模型选择机制(
installModelSelection)保证优先;插件在自身 respect 检查里主动路由到用户选择,双保险。
> 已知运行时说明:插件激活之前就已创建的会话,其模型由会话自身的"选择冻结"机制主导——你手动选模型立即生效且插件尊重;自动路由在下次页面刷新/重连(agent 重建)后对该会话生效,对新会话和所有子代理立即生效。这是 Harness 模型路由架构(冻结配置 + 会话选择优先)的既定行为。
> 双版本差异:动态版额外暴露 harness.handle('peak-valley-status') Host 通道(供后续 Client UI 查询);组合版没有 Host 通道,状态查询通过对话级工具 peakvalley_status 完成。其余行为完全一致。
验证
- 运行测试:
npm test(Node ≥ 20,node --test,21 个用例:时区纯逻辑 + 路由行为) - 启动后看日志:进入高峰/空闲时打印
peak-valley: 进入高峰时段(...),DeepSeek 模型路由 -> deepseek-v4-flash;每次切换打印peak-valley: deepseek-v4-flash -> deepseek-v4-pro (...) - 对话中调用
peakvalley_status查看当前状态 - 会话日志的
request/header事件记录每个请求实际使用的模型
目录结构
deepseek-peak-valley-router/
├── .github/workflows/test.yml # CI:Node 20/22/24 上自动跑 node --test
├── cordis.patch.yml # bundle patch(官方 dsh plugin add 安装入口)
├── lib/
│ ├── index.js # 组合安装版插件(ESM,配置文件读 config.timeZone)
│ └── timezone.js # 纯逻辑:时区换算 + 峰谷判定(零依赖,可独立测试)
├── dynamic/
│ └── host-code.js # 动态安装版(cordis_define code.host 原文)
├── test/
│ ├── timezone.test.js # 时区换算、边界时刻、跨午夜
│ └── router.test.js # 路由行为:自动路由/用户选择优先/时区容错/工具
├── package.json
├── CHANGELOG.md
├── README.md # 中文文档
├── README.en.md # English docs
└── LICENSE
免责声明
- 峰谷时段、价格以 DeepSeek 官方公告 为准;本插件按公告实现,不保证与未来价格政策一致。
- 自动切换模型可能改变回答质量/行为;重要任务请留意实际使用的模型(会话
request/header可查)。 - 本插件与 DeepSeek 官方无任何隶属关系,非官方作品。
参考
- DeepSeek API 模型与价格
- DeepSeek-V4 系列 API 正式调价:首创峰谷计费(TechWeb)
- DeepSeek API 启用峰谷定价(通信世界)
License
MIT
