dsh-plugin-cron-scheduler
DeepSeek Harness 的 Cron 调度插件：通过自然语言或侧边栏 UI 安排代理任务，支持固定/新会话策略、运行历史记录、手动触发和实时同步。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-cron-scheduler@0.2.9Plugin Cron Scheduler 以 dsh-plugin-cron-scheduler 发布，当前版本为 0.2.9。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A cron scheduler plugin for DeepSeek Harness: schedule agent tasks on a cron expression — via natural language or a sidebar UI — and each job injects a user message into a target session at the right time, triggering a full agent turn.
DeepSeek Harness 的「定时任务」插件：按 cron 表达式给 agent 排班——到点往目标会话注入一条 user 消息，触发完整一轮 agent 执行（调工具、写文件、拉数据、生成报告，什么都行）。创建方式双通道：对话里自然语言说一句，或侧边栏底部「定时任务」列表里点「新建」。
Host 平面：持久化 JSON store（<dshHome>/cron-jobs.json，原子写）+ 每任务一条 ctx.timer 定时链 + 到点 agent.followup() 注入合成 user 消息（source.kind === 'plugin'）。
会话策略：
new（默认）：每次触发开一个新会话，干净隔离；fixed：绑定指定会话，累积上下文。绑定会话时是下拉选择（列出所有存活会话的标题），不用手填 session id。错过不补跑：DSH 不是常驻服务，进程关闭期间的 tick 直接跳过，重启后从当前时间往后算，绝不开机风暴。
并发保护：同一任务上一次触发还没结束，新 tick 跳过并记 skippedAt，不重复执行。
执行历史（v0.2.0）：每次触发记录 lastRunStatus（成功/失败/跳过）+ 错误信息 + runCount，侧边栏列表里直接看到「上次: 成功 2026-09-09 10:30」，失败还会显示错误摘要。
手动触发（v0.2.0）：列表里「跑」按钮或对话里 cron_manage run 立即执行一次，不改变既定排班。
双通道创建：cron_manage 工具（对话自然语言）+ 侧边栏 UI（表单），共享同一套 Host CRUD。
UI 位置：注册到侧边栏底部（sidebar.footer.action，新 id cron-hotplug），任务列表直接内联显示在侧栏里（新建/编辑/删除/启停/立即运行都在其中），与 Cordis Plugin 面板并列，不覆盖、不替换它。任务多时列表在容器内滚动，不会撑爆侧栏。
自适应（v0.2.9）：侧栏宽度可拖动，列表按容器实测宽度自动分档（ResizeObserver），任何宽度都不溢出、编/删 始终可点：
| 容器宽度 | 显示 |
|---|---|
| ≥ 300px | 名称 + Cron 表达式 + 上次状态 + 编/删 |
| 220–299px | 名称 + 状态 + 编/删（表达式收进 tooltip） |
| < 220px | 名称 + 状态色点 + 编/删（状态文字与表达式收进 tooltip） |
被省略的名称/表达式/状态都带 title，悬停可看全文；侧栏收起成 rail 时只显示一个时钟图标。
v0.2.8 曾把列表搬到
shell.overlay弹层（footer 只留入口），v0.2.9 按反馈回退为内联列表，自适应能力保留。
dsh plugin --profile <profile> add dsh-plugin-cron-scheduler
（包内置 dsh.bundle manifest，dsh plugin add 自动挂进 profile 的 bundles 层；dsh-market 里的一键安装同此通道。）
重启 DSH 后生效。之后在侧边栏底部「定时任务」列表里管理任务，保存即生效（无需重启）。
⚠️ 不要再往 profile 的
cordis.patch.yml里手写- insert: {id: dsh-cron, ...}： 那会与 bundle manifest 的自动挂载产生两条同名 entry，整个 profile 会以duplicate loader entry id "dsh-cron"启动失败。运行期任务数据走<dshHome>/cron-jobs.json；覆盖 composition 键（如configFile）用**不带 insert 的 id 覆盖条目。
阿周：每周一 10:30 帮我导出上一周的 ZDP 数据 小蓝：（调用 cron_manage 工具）已创建「每周导出ZDP上周数据」，下次执行：下周一 10:30
支持的 cron_manage action：create / list / update / delete / toggle / run。
cron 表达式是标准 5 字段（分 时 日 月 周）：
* * * * *
│ │ │ │ └─ 周几 (0-7，0 和 7 = 周日)
│ │ │ └─── 月 (1-12)
│ │ └───── 日 (1-31)
│ └─────── 时 (0-23)
└───────── 分 (0-59)
支持单值、范围（1-5）、步进（*/5）、列表（1,3,5）、通配（*）。例：
| 表达式 | 含义 |
|---|---|
0 10 * * * | 每天 10:00 |
30 10 * * 1 | 每周一 10:30 |
*/5 * * * * | 每 5 分钟 |
0 17 * * 5 | 每周五 17:00 |
| 键 | 默认 | 含义 |
|---|---|---|
configFile | <dshHome>/cron-jobs.json | 任务数据文件路径（仅 composition 配置） |
cwd | process.cwd() | new 策略新建会话的工作目录 |
⚠️ 新建会话（
new策略）必须补齐三样，否则那个 agent 一定是残的：
缺什么 后果 agent preset（ agentPresets.mount）工具集退化成空的全局层——只剩全局注册的工具，没有 shell/read 等标准工具 模型选择（ agentDefaultModel+ 装钩子）persona 段的 {{model}}取不到值，第一轮直接报错cwd（ meta.cwd）persona 段的 {{cwd}}取不到值，第一轮直接报错插件会自动补齐这三样（默认 preset / 默认模型 /
cwd不配则用process.cwd()）。
为什么不用 settings 面板的通用 namespace？DSH 的 settings wire 只服务一张 硬编码白名单（
WEB_SETTINGS_NAMESPACES），插件无法把自有 namespace 暴露给 浏览器写入。本插件因此在 host 自建了/api/cron/*路由，侧边栏 UI 直连该路由。
| Method | Path | 说明 |
|---|---|---|
| GET | /api/cron/jobs | 列出全部任务 |
| POST | /api/cron/jobs | 新建任务 |
| PUT | /api/cron/jobs/:id | 更新任务 |
| DELETE | /api/cron/jobs/:id | 删除任务 |
| POST | /api/cron/jobs/:id/run | 立即运行一次 |
| GET | /api/cron/sessions | 列出存活会话（固定会话下拉用） |
| GET | /api/cron/events | SSE 推送 jobs-changed |
node --test 'test/*.test.js'
nextRunAt / skippedAt 是易失字段（进程内），重启后按当前时间重新计算。fixedSessionId。MIT