dsh-wb-cron
无人值守定时任务调度器：cron/固定间隔/一次性三种调度，到点在 web profile 进程内拉起全新 root agent 执行任务指令（全栈继承 agentrouter/wb-memory/skills/hooks），会话落盘可续聊；每任务可钉模型与 Agent 预设（预设被删/损坏时三级降级跑完并留痕）；提供 cron_* 模型工具、设置页完整管理与侧边栏速览。零 npm 运行时依赖、零遥测。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:miseryrua/dsh-wb-cron#1b031226b9a102e283d8783896426ff341ce667a
Wb Cron 以 dsh-wb-cron 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（DSH）无人值守定时任务调度器插件：到点自动在 web profile 进程内拉起全新 root agent，在指定工作区自主执行任务指令。会话正常落盘、可在 Web 侧边栏续聊；无需子进程、无需单独凭据。
主界面左下角有速览入口（运行角标 + 浮层面板），设置页里有完整管理卡片：
| 侧边栏速览 | 设置 → 定时任务 |
|---|---|
| 侧边栏速览面板 | 设置页任务列表 |
编辑对话框：Agent 预设就在「模型」下方，任务可各自钉住 standard / ptc / minimal / cordis 或任意用户自建预设。列表行也会显示每个任务当前钉的预设。
新建任务默认「跟随全局默认」，也可以直接钉住某个预设：
| 跟随全局默认（当前全局为 ptc） | 钉住「极简模式（minimal）」 |
|---|---|
| 新建任务默认跟随全局默认 | 钉住极简模式 |
截图为演示数据。预设下拉的内容与「跟随全局默认」括号里的 id 都来自宿主当前实际安装的预设（
GET /dsh-wb-cron/presets）。
skip 跳过 / runOnce 补跑一次——无论哪种，唤醒后最多补跑一次，绝不回放积压）。standard → 全局默认 → 宿主裸上下文三级降级跑完，并在运行历史的 error 字段里写明降级原因（2026-09-22 定案：定时任务无人值守，中断代价高于偏差）。cron_create / cron_list / cron_update / cron_delete / cron_run_now / cron_next / cron_history 七个模型工具，直接说"每天早上 9 点帮我跑 X"即可。schedule_create（内置）：会话内提醒——会话关闭时提醒一直逾期等它。
cron_create（本插件）：跨会话无人值守执行——浏览器关掉照样跑，会话落盘可续聊。
# 本地开发
dsh plugin --profile web add "file:<本目录绝对路径>"
# 然后手动在 profile package.json 的 dsh.profile.bundles 数组追加 "dsh-wb-cron"
#（dsh plugin 只转发给 pnpm，不会改 bundles 数组；见下"装前审查"）
# npm 发布后
dsh plugin --profile web add dsh-wb-cron
# GitHub 来源（市场惯例：固定 commit 便于审查）
dsh plugin --profile web add "github:miseryrua/dsh-wb-cron#<sha>"
注意：dsh plugin add 仅把包装进 profile 的 node_modules；还需在
~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组里加 "dsh-wb-cron" 并重启宿主才会生效。
安装任何 DSH 插件都意味着以你的权限运行第三方代码。本插件源码结构一览：
| 文件 | 职责 |
|---|---|
lib/index.js | 入口：装配存储/调度器、注册 7 个工具、9 条 HTTP 路由（同源栅栏）、settings 命名空间 |
lib/cron.js | 零依赖 cron 解析与下次触发计算（含 IANA 时区，经 Intl 两遍逼近） |
lib/jobs.js | 存储 ~/.dsh/wb-cron/jobs.json（tmp+rename 原子写、严格解码、坏文件自动备份）与 history.jsonl（500 条截断） |
lib/scheduler.js | 30s tick 墙钟判定、串行队列、错过处理、maxRuns 终结 |
lib/fire.js | 开火路径（配方逐行对齐 @deepseek-ai/dsh-headless 的 run()）：解析预设（含三级降级）→ agents.create → followup → whenIdle → sessions.flush |
lib/client.js | 前端（手写 __ModuleLoader__ bundle）：侧边栏入口 + 设置页卡片 |
test/ | 30 个单元测试（node --test 自动发现模式运行） |
fire.js 引用的 @deepseek-ai/* 包全部由宿主提供（~/.dsh/profiles/node_modules 安装闭包），插件自身 package.json 无任何运行时依赖。
HTTP 路由的写操作全部经过同源栅栏（loopback host + sec-fetch-site 校验，防 DNS rebinding 与跨站请求）；支持 X-Dsh-Request-Id 幂等去重。
nextFire 已超过 2 分钟容差 → 按任务配置 skip（默认，记一条 skipped-missed）或 runOnce（立即补跑一次）；绝不回放积压。任务是无人值守的，因此预设不可用时不中断执行，按以下顺序逐级降级，并把降级原因写进该次运行历史的 error 字段（status 仍按实际执行结果记 completed / timeout / error）：
| 级 | 尝试 | 失败后 |
|---|---|---|
| 0 | 任务钉的 preset | 记 预设 X 不可用，降级… |
| 1 | standard（内置标准模式） | 记 standard 亦不可用，降级为全局默认… |
| 2 | 全局默认预设（agentPresets.resolve(undefined)） | 记 无任何可用预设，以裸上下文执行 |
| 3 | 裸上下文（meta 不带 agentPreset） | 执行本身失败才会向上抛错 |
preset 字段取值：预设 id 字符串，或 null / 缺省 = 跟随全局默认（与 model 字段对称）。存量任务没有该键时等同 null（向后兼容）。
预设列表与 defaultId 由 GET /dsh-wb-cron/presets 提供，前端下拉直接用该路由（agentPresets 服务不可用时返回 {presets:[],available:false,note} 而非报错）。预设挂载与模型选择互不干扰：agents.create 的 setup 里先 installModelSelection 再 presets.mount，与官方 dsh-api-session-controller 的 composeAgent 一致。
注意：setup 必须用块体写法。表达式体会隐式返回 installModelSelection 的 disposer 函数，而 dsh-agent-loop 会调用其 .commit()，报 (intermediate value)?.commit is not a function（2026-09-07 实测）。
{
"maxConcurrentJobs": 1, // 全局并发上限（默认串行）
"tickMs": 30000, // 调度检查间隔
"historyLimit": 500, // history.jsonl 保留条数
"defaultTimeoutMinutes": 30, // 单次运行看门狗
"appendMemoryLogDefault": true // 任务头默认是否带 wb-memory 收尾指引
}
node --test # 30 个测试（注意：必须用自动发现模式；node --test test/ 会 MODULE_NOT_FOUND）
数据目录：~/.dsh/wb-cron/（jobs.json / history.jsonl）。
会话深链跳转、permission preset 接入（权限不足 → skipped-permission 滚动语义）、webhook 通知互通（payload 对齐 chicheng-push 占位符，本插件不实现任何通知渠道）、空闲时段运行选项。
MIT © 2026 miseryrua
仓库：https://github.com/miseryrua/dsh-wb-cron（问题反馈请开 issue）