deepseek-peak-valley-router

Readme

# deepseek-peak-valley-router

**[English](README.en.md) | 简体中文**

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`](dynamic/host-code.js) 中 `HOST_CODE` 的完整内容粘贴到 `code.host` 参数,然后 `cordis_run` 激活即可。

### 方式 B:组合插件(官方 bundle 安装,永久生效,需要重启)

本包是标准 DSH bundle(声明了 `dsh.bundle` 与 `cordis.patch.yml`),用官方安装路径即可:

```sh
# 本地 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 自己的补丁层覆盖即可:

```yaml
# ~/.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 官方公告](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/) 为准;本插件按公告实现,不保证与未来价格政策一致。
- 自动切换模型可能改变回答质量/行为;重要任务请留意实际使用的模型(会话 `request/header` 可查)。
- 本插件与 DeepSeek 官方无任何隶属关系,非官方作品。

## 参考

- [DeepSeek API 模型与价格](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)
- [DeepSeek-V4 系列 API 正式调价:首创峰谷计费(TechWeb)](https://www.techweb.com.cn/it/2026-08-17/2978269.shtml)
- [DeepSeek API 启用峰谷定价(通信世界)](http://www.cww.net.cn/article?id=612617)

## License

[MIT](LICENSE)