Eligahyu / deepseek-peak-valley-router

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 维护的扁平模块回退自动解析,无需手动安装。

行为规则(优先级从高到低)

1. 用户显式选择的模型 —— 永远优先。你在模型选择器里选的每个模型都会写入 agent-default-model 设置,插件监听该设置的变更事件;一旦检测到,同一 provider 下的所有请求都直接路由到你选择的模型(请求当前配置来自会话/子代理的冻结值时也不例外)。插件启动后首个请求若发现默认模型已是 pro(非出厂默认 flash),也会视为你的历史选择。
2. 自动路由(默认)。未检测到显式选择时,按参考时区自动切换。
3. 不越界。非 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