闲时任务队列 BXY-Create/dsh-plugin-nonurgent

dsh-plugin-nonurgent

DeepSeek Harness 插件：把非紧急任务安排在只在 DeepSeek API 空闲时段定价运行，工作区和会话都由你指定——就像正常使用 harness 一样，只是延后执行。

闲时任务插件：把非紧急任务缓存起来，只在 DeepSeek 官方 API 空闲时段（峰谷定价谷段，半价）自动开始执行，且在你指定的工作区、指定的会话中运行，就像正常使用 harness 一样。

它做什么

- 用 /nonurgent add <description> 发布任务。任务会被缓存，不会立即执行。
- 空闲时段一到，插件就把任务注入真实的 harness 会话——也就是你平时用的那套智能体机制（bash 工具、会话历史、工作区上下文、目标……）。
- 目标：默认 = 当前会话；--workspace /abs/path = 在该工作区新建会话（侧边栏可见，完成后保留）；--session <id-prefix> = 某个已存在的会话（活跃：就地投递；已归档：自动恢复，完成后交还）。
- 空闲时段按 DeepSeek 官方峰谷定价（2026-08-17 生效）：高峰 = 北京时间 09:00–12:00 和 14:00–18:00；其余时间都是空闲时段（半价）。高峰时段绝不发送任何请求。时段可配置。
- 时段结束前 10 分钟任务仍未完成 → 向会话注入结构化检查点提示词（[CHECKPOINT]：已完成 / 进展 / 下一步 / 风险）。状态保存在会话历史里；任务挂起，在下一个空闲时段恢复，如此反复直到完成。
- 预期结果 + 子代理验收：用 --expected "..." 描述预期结果；会话收敛后，独立的子代理会话会对照预期审查执行记录，并在任务上记录通过/未通过的判定（acceptance）。验收提示词是对抗式的（独立审计员、必须给出证据、证据不足即判失败），判定失败会把任务标记为 failed，等待复查。模型独立性很重要：同模型的审计员会与执行者共享盲区，所以生产环境验收请把 acceptanceModel 设为与执行者不同的模型；不设置时，审计员跟随执行模型，但对抗式提示词依然生效。审计员也可以用自己的工具读取工作区文件，核实实际产物。
- 预期结果可以引用文件：在描述或预期结果里使用 [[文件:path]] / [[file:path]]（相对路径按任务工作区解析）——例如 --expected "满足 [[文件:requirements.md]] 的全部要求"。被引用文件的内容会读取并内联到执行消息（执行者据此对照真实需求）和验收提示词（审计员据此逐条对照文件的实际要求判断）。最多 5 个文件，每个 64 KB；读不到的文件会在提示词里报告，而不是静默失败。
- 审批预览（可选）：设置 requireApproval: true 后，新任务会进入 awaiting-approval 状态；add 命令会预览描述、目标、预期结果，只有执行 /nonurgent approve <id> 之后才会被调度。
- Git 快照回滚：执行前，如果目标工作区是 git 仓库，插件会运行 git stash create，并把 commit hash 存到任务上；出现异常后用 git -C <workspace> reset --hard <hash> 回滚。
- 模型选择：发布时挑选执行模型 —— --model provider/model（或使用 dock 下拉框，选项来自宿主模型目录，通过 ctx.llm 提供；modelList 可覆盖）。主对话模型在列表里标记为 （主agent模型，不推荐），因为用主模型执行延迟任务会把这些任务和你的交互会话绑在一起，而且当验收也用同一个模型时，会重新引入同模型确认偏差。
- 紧急度预分析（消耗少量 token）：发布时插件会跑一次轻量 LLM 分析（maxTokens: 200，analysisModel 可配置），标记出需要实时跟进或有硬性时间依赖的任务 —— 返回结果会给出提示，说明这类任务不推荐放进延迟错峰流水线（改用 run-now，或立即处理）。
- 崩溃安全：任务元数据原子化持久化，并带 .bak 兜底；运行中的任务会自愈回到队列。

安装

1. 让包能从你的 DSH 配置档解析到：

corepack pnpm add "dsh-plugin-nonurgent@file:./vendor/dsh-plugin-nonurgent"

2. 在 cordis.patch.yml 里挂载它（非 bundle 插件；热应用，无需重启 DSH）：

- insert:
- id: nonurgent
name: dsh-plugin-nonurgent

3. 硬刷新 Web UI。错峰任务 dock 会出现在输入框上方（todo/queue 旁边），显示窗口状态、倒计时，以及任务列表 / 添加表单。

用法

/nonurgent add <description> [--expected "expected result"] [--workspace <absolute path>] [--session <session-id-prefix>]
/nonurgent list
/nonurgent status [id]
/nonurgent run-now <id> # execute immediately, ignoring the window
/nonurgent pause <id>
/nonurgent resume <id>
/nonurgent approve <id> # authorize a task stuck in awaiting-approval (requireApproval mode)
/nonurgent cancel <id>
/nonurgent clear-done

配置

全部可选，通过 cordis.yml 里条目的 config 设置：

config:
model: null # null = follow the session default model
defaultWorkspace: null # cwd for new sessions when no workspace is given
peakWindows: # Beijing time HH:MM; adjust here if official pricing changes
- { start: "09:00", end: "12:00" }
- { start: "14:00", end: "18:00" }
checkpointLeadMin: 10 # state-saving prompt N minutes before the window ends
tickMs: 30000
maxConcurrent: 1
maxTotalRounds: 20 # per-task delivery cap (resumptions)
keepDone: 50yaml
requireApproval: false # true = 任务启动后先等待批准，直到 /nonurgent approve acceptanceModel: null # 验收模型；推荐：与执行者不同的模型，避免同模型确认偏差（null = 跟随执行模型） gitSnapshot: true # 在 git 工作区执行前运行 git stash create

--workspace / --session 的值可以用 "双引号" 或 '单引号' 包起来，以便包含空格（例如 --workspace "D:/Program Files/project"）。--expected 同样支持引号。

工作原理（宿主侧）

插件调用的 API 与官方 dsh-schedule / api-proxy 相同：

- ctx.agents.get() / ctx.agents.resume() / ctx.agents.create({ meta: { cwd } }) 获取目标智能体；
- agent.followup() 把任务消息排入队列；agent.steer() 插入检查点提示词；agent.cancel({ kind: "hook" }, { keepInbox: true }) 在窗口边界挂起；agent.whenIdle() 检测收敛；
- 完成状态由 turn/end 事件确认——因错误收敛的轮次标记为 failed，绝不会标记为 done；
- 取消任务时先调用 agent.inbox.remove(messageId) 撤回仍在等待投递的消息，再用 cancel(..., { keepInbox: true }) 中止进行中的活动，从而保留无关的排队输入；
- 验收会启动一个用完即弃的 agents.create 会话，注入任务描述、预期结果、执行记录（以投递消息为锚点的任务轮次窗口：user/message → 助手回复 → 工具调用 → 真实输出，从窗口开头截取——尾部是流式分块事件），以及所有被引用的文件，解析结构化的 [FINAL-VERDICT] 判定，然后销毁会话；
- GET /plugins/nonurgent/state 返回每个任务的 log 详情（外加 logCount），Web 面板据此展示完整审计轨迹；GET /plugins/nonurgent/tasks/<id> 返回存储的轨迹 + 验收判定，加上 ?live=1 可获取运行中任务的实时轨迹（同样的锚定窗口，按需重新计算）；
- Web 面板详情：点击任意任务行即可展开其子代理输出——状态/目标/会话/模型/轮次/时间戳/git 快照/最后错误、预期结果、验收判定、执行轨迹（按用户 / 助手 / 工具调用 / 工具输出着色），以及最近的日志尾部。运行中的任务每 5 秒刷新一次轨迹；已结束的任务会显示 Archive 按钮。

运行时依赖：@deepseek-ai/dsh-agent（用于 installModelSelection），外加 Node 内置模块。

开发 bash
node --test test/logic.test.js test/store.test.js # 纯逻辑 + 存储单元测试
node --test test/integration.test.js # 使用假智能体的完整编排测试（约 4 分钟）
集成测试与时间、平台无关：每个 harness 都使用相对当前时刻的峰值窗口（高峰时段不再出现 real-clock + 默认窗口导致的失败），所有文件路径都从 os.tmpdir() 推导（不再硬编码 /tmp）。测试还覆盖了含空格的 --workspace 路径、取消撤回、requireApproval/approve，以及子代理验收流程。

License

MIT

功能

- 在任意会话里用 /nonurgent add <描述> 发布任务，任务被缓存，不会立即执行；
- 空闲时段到来后，任务被投递进真实的 harness 会话执行（bash 工具、会话历史、工作区上下文等完整能力）：默认 = 当前会话；--workspace /绝对路径 = 指定工作区新建会话（完成后保留可查看）；--session <id前缀> = 指定已有会话（live 原地投递；历史会话自动 resume 恢复，完成后归还）；
- 时间窗按官方峰谷定价（2026-08-17 生效）：高峰 = 北京时间 09:00–12:00、14:00–18:00，其余为空闲时段（半价）；高峰时段绝不发送任何请求；窗口可配置；
- 空闲段结束前 10 分钟仍未完成 → 向会话插入结构化「现场记录」指令（[CHECKPOINT]：已完成/进度位置/下一步/风险与注意），现场保存在会话历史中，任务挂起并在下一空闲时段自动续跑，直至完成；
- 预期结果 + 子代理验收：发布时用 --expected "..." 描述预期结果；执行收敛后，插件创建独立子代理会话对照预期结果审查执行记录，在任务上记录 通过/不通过 结论（acceptance）。验收指令为对抗性审计（独立审计方、要求引用证据、证据不足即判不通过），验收不通过时任务标记为 failed 供复核。模型独立性很重要：同模型审计与执行方共享盲区，生产建议用 acceptanceModel 配置与执行不同的模型；未配置时跟随执行模型，但对抗性指令仍然生效；验收所用的模型记录在 acceptance.model 供追溯；验收方还可使用自己的工作区工具读取文件核对实际产物；
- 预期结果可引用文件：在任务描述或预期结果里写 [[文件:路径]] 或 [[file:路径]]（相对路径按任务工作区解析），例如 --expected "满足 [[文件:requirements.md]] 的全部要求"。插件会读取文件内容并内联到两处：执行消息（执行方按真实要求干活）与验收指令（审计方以文件里的实际要求逐项对照）。最多 5 个文件、每个 64KB；读取失败会明确写进提示而不是静默跳过；
- 授权预览（可选）：配置 requireApproval: true 后，新任务进入 awaiting-approval 状态，发布命令展示任务预览（描述/目标/预期结果），须 /nonurgent approve <id> 授权后才进入调度；
- git 快照回滚：执行前若目标工作区是 git 仓库，自动执行 git stash create 并把 commit 记在任务上，发现异常可用 git -C <工作区> reset --hard <hash> 回滚；
- 模型选择：发布任务时可指定执行模型（--model provider/model 或 dock 下拉，模型列表来自宿主 ctx.llm 目录，可用 modelList 配置覆盖）；列表中主对话模型标注「（主agent模型，不推荐）」——用主模型跑闲时任务会与会话交互耦合，且同模型验收会重蹈确认偏误；
- 紧急性初步分析（少量 token）：发布时用轻量分析（maxTokens: 200，模型可用 analysisModel 配置）判断任务是否需要实时跟进/对时间强依赖——若不适合延迟执行，响应会给出「不建议使用闲时任务」的提示（此时应改用 run-now 或立即处理）；
- 崩溃/重启自愈：任务元数据原子持久化（.bak 回退），运行中任务自动回归队列。

安装

1. 让 DSH profile 能解析本包（file: 依赖）：

bash
corepack pnpm add "dsh-plugin-nonurgent@file:./vendor/dsh-plugin-nonurgent"

2. 在 cordis.patch.yml 挂载（非 bundle 插件，热应用无需重启）：

yaml
- insert:
- id: nonurgent
name: dsh-plugin-nonurgent

3. 硬刷新 Web 页面：输入框上方出现「闲时任务」横条（与 todo/队列并列），显示时段状态、倒计时与任务列表，可展开添加任务（「当前会话」或「新会话 + 工作区」）；点击任意任务行可展开查看子代理输出与执行情况（状态/目标/会话/模型/投递次数/时间/快照/错误、预期结果、验收结论、执行轨迹（用户/助手/工具调用/工具输出 分色显示）、最近日志；执行中每 5 秒刷新实时轨迹；已终结任务提供「归档」按钮）。

使用 text /nonurgent add <描述> [--expected "预期结果"] [--workspace <绝对路径>] [--session <会话id前缀>] /nonurgent list /nonurgent status [id] /nonurgent run-now <id> # 立即执行（无视窗口） /nonurgent pause <id> /nonurgent resume <id> /nonurgent approve <id> # 授权待授权（awaiting-approval）任务进入调度 /nonurgent cancel <id> /nonurgent clear-done

配置与实现要点配置见上方英文节（新增 requireApproval/acceptanceModel/gitSnapshot）。--workspace/--session 支持用 "双引号" 或 '单引号' 包裹，以容纳含空格的路径。实现与官方 dsh-schedule/api-proxy 使用相同的会话驱动 API（followup/steer/cancel/whenIdle + turn/end 完成判定 + inbox.remove 撤回消息），运行时依赖仅 @deepseek-ai/dsh-agent 与 Node 内置模块。

开发与测试 bash
node --test test/logic.test.js test/store.test.js # 纯逻辑 + 存储单测
node --test test/integration.test.js # 假 agent 编排全链路（约 4 分钟）

集成测试已做到时间无关与平台无关：所有 harness 使用相对当前时刻的动态高峰窗口（高峰时段也能跑），全部路径基于 os.tmpdir()（Windows 直接可跑）；并覆盖含空格工作区路径、cancel 撤回、requireApproval/approve 授权、子 agent 验收流程。

许可证

MIT