DSH work on time（dsh-work-on-time）
一个给 DeepSeek Harness（DSH）用的宿主插件：
峰时只收需求、只排任务；谷时自动把排好的任务跑起来。
灵感来自 DeepSeek 的错峰优惠：把“写代码”这类重活挪到便宜的时段，而把“想清楚要做什么”留在工作时间。
峰时 / 谷时怎么算
默认按北京时间（Asia/Shanghai）：
| 时段 | 判定 |
|---|
| 周一至周五 09:00–12:00 | 峰时 |
| 周一至周五 14:00–18:00 | 峰时 |
| 周末、法定节假日全天 | 谷时 |
| 工作日其余时间 | 谷时 |
- 区间是左闭右开：09:00 整算峰时，12:00 整算谷时。
- 支持跨零点窗口（如
22:00–02:00）与全天窗口（start === end）。
- 调休上班日、额外放假/剔除日期都可以自己配。
它做了什么
- 峰时：插件向模型注入一段系统提示，并拦截执行类工具（
pwsh/write/edit/subagent/workflow 等，可配置）。
模型只能把需求拆成任务清单，调用 pv_enqueue 入队，然后告诉你“已入队，谷时执行”。
- 谷时：插件心跳（默认 45 秒）发现当前是谷时，就把所有
queued 批次按会话分组，
向对应会话投递一条 【谷时任务启动 · dsh-work-on-time】 消息（内含批次 id、需求、编号任务清单、执行要求），
模型随后按清单逐条执行；每批结束调用 pv_complete 记录结果。
- 会话当时没开也没关系：批次一直留在队列里，等会话恢复后的第一个谷时再投递。
安装
git clone https://github.com/YuGaN525/DSH-work-on-time.git
然后在 DSH 里安装（插件目录的绝对路径）：
plugin_manager → action: install_bundle
target: <绝对路径>/DSH-work-on-time
安装后插件会自动启用，pv_* 工具立即可用。改完 index.js 后需要重载：
plugin_manager → action: set_plugin
target: include:work-on-time
enabled: false # 先关
enabled: true # 再开
target 必须是精确的 entryId（include:work-on-time），传包名会报 unknown-plugin。
工具
| 工具 | 作用 |
|---|
pv_enqueue | 入队一个需求 + 任务清单。峰时唯一应该调用的写操作；不传 tasks 时按换行/分号自动拆分（最多 12 条）。 |
pv_status | 查看当前峰/谷、距下次切换多久、队列与批次详情（可传 batchId）。 |
pv_complete | 标记批次完成：outcome 为 done/partial/failed，附 summary。 |
pv_cancel | 取消一个还没开的批次。 |
pv_run | 立刻强制开跑（跳过峰谷判断）。峰时用它会在该批次运行期间临时放行执行类工具。 |
pv_config | 改配置：峰时窗口、节假日、时区、心跳、守卫开关等。 |
配置
配置优先级：内置默认值 → cordis.patch.yml 的 config: → $DSH_HOME/work-on-time.config.json（pv_config 写入这里，最高）。
所以用 pv_config 改过之后，再改 cordis.patch.yml 不会生效；要恢复 patch 默认值，删掉 $DSH_HOME/work-on-time.config.json 再重载。
常用项（都可在 cordis.patch.yml 或 pv_config 里改）：
timeZone: Asia/Shanghai
peakWindows:
- { days: [1, 2, 3, 4, 5], start: '09:00', end: '12:00' }
- { days: [1, 2, 3, 4, 5], start: '14:00', end: '18:00' }
extraHolidays: [] # 追加休息日，如 ['2027-01-01']
excludeHolidays: [] # 从内置表里剔除某天（把它当普通工作日）
extraWorkdays: [] # 调休上班日，即使是周末也算工作日
tickSeconds: 45 # 心跳节流间隔
peakGuard: true # 峰时是否拦截执行类工具
blockedToolsDuringPeak: [pwsh, write, edit, subagent, subagent_fork, workflow]
dispatchOnlyWhenIdle: true # 会话忙时先不打断
maxDispatchesPerTick: 3
autoCompleteIdleSeconds: 90 # 会话空闲这么久还没 pv_complete，自动标完成
days 用 ISO 数字：1=周一 … 7=周日。
法定节假日表
内置表目前只覆盖 2026 年（国务院办公厅 2026 年部分节假日安排）。
节假日按“休息日（不上班）”处理：落在节假日的工作日一律算谷时。
- 以后的年份公布后，改
index.js 里的 BUILTIN_HOLIDAYS，或用 pv_config({ extraHolidays: [...] }) 追加。
- 想临时把某个节假日变回工作日，用
excludeHolidays。
- 当前年份不在覆盖范围时，
pv_status 和系统提示都会给出提示，避免“节假日没生效”的静默错误。
数据文件
| 文件 | 内容 |
|---|
$DSH_HOME/work-on-time.state.json | 队列与批次（原子写）。插件重载时把上次遗留的 running/interrupted 批次重新排队成 queued，并在下次唤醒文案里提示“先检查已完成部分，避免重复劳动”。 |
$DSH_HOME/work-on-time.config.json | pv_config 的持久化覆盖。 |
从旧名（dsh-peak-valley-queue）升级时，首次启动会自动把 peak-valley-queue.*.json 复制成 work-on-time.*.json，队列不丢。
测试
仓库自带离线自测（假的 Cordis 上下文 + 临时 DSH_HOME，不碰真实数据）：
node test/mock-test.mjs
# PASS: 97 passed, 0 failed
覆盖：日期/星期/节假日判定、时段边界（08:59/09:00/11:59/12:00/13:59/14:00/17:59/18:00）、
周末与节假日、excludeHolidays/extraWorkdays、跨零点窗口、全天窗口、下一切换点，
以及入队、峰时拦截、pv_run 强制开跑、pv_complete、pv_cancel。
项目结构
index.js # 零依赖宿主插件（只 import node: 内置模块）
cordis.patch.yml # bundle 插入声明 + 默认配置
locale/{zh,en}.json # 插件管理器里的标题/描述
icon.svg # 图标
test/mock-test.mjs # 离线自测
为什么零依赖：本地 link: 方式安装的插件，运行时解析不到 @deepseek-ai/* 这类 bare specifier，
所以工具用普通对象注册（不用 defineTool），配置也不导出 schemastery schema。
限制
- 需要 DSH 进程在运行：插件是宿主插件，应用关掉就不会有任何调度。
- 谷时唤醒的是原会话：会话得还能恢复（模型、工作目录都在）。会话被删掉的话，批次会一直排队，直到手动
pv_cancel 或改配置。
- 强杀进程时，已在跑的批次下次启动会被重新排队，可能重复执行 — 唤醒文案会提醒模型先检查已完成的步骤。
- 峰时拦截是“工具级”的：如果用
pv_config({ peakGuard: false }) 关掉，模型在峰时就能直接干活。
License
MIT © 2026 YuGaN525
