dsh-cron
Manifest validDSH Sidebar "Scheduled Tasks": Built-in cron scheduling engine and execution ledger — create tasks, edit expressions, start/stop, and run manually. Script output can be delivered to Discord.
定时任务(dsh-cron)
给 DSH 侧栏加一条 定时任务:列出所有任务与下次到点时间,可新建、改 cron、启停、删除、手动跑脚本型任务,执行结果落进账本,并能把脚本输出投递到 Discord。
自带 cron 调度内核,落在进程内 ticker 上,不需要任何外部服务或守护进程。
装 / 卸
git clone https://github.com/AkaneRanma/dsh-cron
cd dsh-cron
.\install.ps1 # 演练:只打印将改 profile 的哪两处
.\install.ps1 -Apply # 写 profile/package.json(自动 .bak 备份)
cd "$env:USERPROFILE\.dsh\profiles\desktop"; pnpm install
# 重启 DSH 生效
卸载:.\install.ps1 -Apply -Remove → pnpm install → 重启。
install.ps1 只动两处:<DSH_HOME>/profiles/*/package.json 的 dependencies 加一条 dsh-cron: link:<本目录>,以及插件清单里加 dsh-cron。改前自动备份,-Remove 按备份还原。
面板
顶部三个页签:任务 / 消息平台 / 一次性清理。
| 操作 | 行为 |
|---|---|
| + 新建任务 | 名称 + cron + 脚本 + 投递,cron 先校验再落盘 |
| 改 cron / 脚本 / 名称 → 保存 | 只改该条,写前备份、原子替换 |
| 停用 / 启用 | 只翻 enabled,ticker 跳过停用项 |
| 立即执行 | 只对脚本型(no_agent + script),返回 stdout/stderr;旁边的 发 Discord 勾上才投递,默认勾上 |
| 删除 | 从任务文件移除该条 |
| 立刻检查一次 | 手动触发一次 tick,回报「执行几条 / 记漏跑几条」 |
任务页只列 cron 型任务;一次性自毁任务在第三个页签,见下节。
agent 型任务(需要模型与会话)不执行,只显示、不提供运行按钮。
消息平台(Discord)
凭据存在 <dataHome>/settings.json,面板保存即生效,不需要重启;cordis.patch.yml 里的同名字段只作初值。
| 项 | 作用 |
|---|---|
| Bot 令牌 | 与任务里的 deliver=discord:频道ID 配合发消息;面板只显示打码后的尾四位 |
| Webhook | 整条 URL,配了就优先用它,连令牌都不用 |
| 默认频道 ID | 任务没填 deliver 时发这里;「发送测试消息」也用它 |
| 允许的用户 ID | 白名单,供以后接双向消息;投递不受影响 |
| 发送测试消息 | 立刻发一条固定文本,验证凭据可用 |
| 调度容差 | 超过多少分钟算漏跑、漏跑要不要发消息、通知冷却多长(存进同一个 settings.json) |
三者全清空时 settings.json 会被删除,回落到 cordis.patch.yml 的初值。
一次性自毁任务
给临时产物(测试脚本、备份、截图、dump)建一条一次性任务:到点删路径,删完自己从 jobs.json 消失,执行记录留在账本,面板第三页可查。
| 通道 | 做法 |
|---|---|
| CLI(最省事) | node bin/purge-later.mjs --after 120 --note "说明" "E:\\workplace\\tmp\\x.ps1" |
| 查待销毁 | node bin/purge-later.mjs --list |
| HTTP | POST /dsh-cron/api {"op":"purgeLater","paths":["..."],"afterMinutes":120,"note":"..."} |
| 面板 | 第三个页签「一次性清理」:看待销毁、倒计时、立即销毁、取消,下方是销毁记录 |
数据模型:schedule.kind = "once" + cleanup.paths。ticker 到点执行 cleanup(目录递归删、文件直接删),成功后只摘 jobs.json,names.json 与账本保留,记录里仍有中文名。失败(被占用等)时任务转停用保留,账本记失败原因。
安全闸(cleanupGuard):只收绝对路径;拒绝盘符根、层级过浅、用户主目录、DSH_HOME、本插件数据目录本身。越界直接拒,不做「尽力删除」。
错过窗口仍补跑:默认 purgeMaxLatenessSec 30 天,关机一夜回来照样删;超过才记 skipped。
数据在哪
| 内容 | 路径 |
|---|---|
| 任务 | <DSH_HOME>/schedule/jobs.json |
| 执行账本 | <DSH_HOME>/schedule/executions.db(node:sqlite) |
| 平台设置 | <DSH_HOME>/schedule/settings.json |
| 任务名登记 | <DSH_HOME>/schedule/names.json |
| 备份 | <DSH_HOME>/schedule/backups/,保留最近 10 份 |
<DSH_HOME> 默认 ~/.dsh,可用 config.dataHome 改到任意目录。任务名另记一份的原因:任务删掉后,「最近执行」里那些历史记录仍显示当初的中文名,不会退化成一串 job_id。
调度契约
- ticker 每
tickMs(默认 20s)扫一遍,(job_id, scheduled_instant)唯一键保证同一分钟只跑一次。 - 一次 tick 没跑完,下一次直接返回
busy(脚本比tickMs还慢时不会两个 tick 抢同一分钟);同一任务在跑时其它 tick 跳过它。 - 容差
catchUpSec(默认 3600s)内:晚到照跑,账本记detail=晚到执行(晚 N),输出照发;同一窗口里更早的几个到点合并成一次,不连环重放。 - 超出容差:不再静默跳过 —— 记账本
status=missed,并(同任务冷却missedNotifyCooldownSec内只发一次)通知 Discord「错过到点执行,这次没有执行脚本」。 - 超出容差但开了
missedCatchUpOnce:本轮到点里只真跑最近一次(detail=漏跑补跑一次(晚 N)),更早的合并记missed,不会连环重放;随后的 tick 因账本已占位不会重复补。这时不再额外发「错过」通知(脚本输出本身就会送到,重复推送只会吵),适合机器会休眠、又不想把容差开得很大的场景。 - 漏跑回看下界:任务
created_at(新建时自动写入,按分钟取整),所以新任务不会凭空翻出创建前的「历史漏跑」;老任务没有该字段且账本为空时只回看最近一天。窗口上限missedLookbackMinutes(默认 3 天)。 - 卡死的
running行(超过timeoutMs+2 分钟还没收尾,说明上次进程崩了)会被忽略并允许本轮重跑。 - 脚本按扩展名选解释器:
.py→pythonCommand,.mjs/.js/.cjs→ 当前 node,其它走 shell;超时timeoutMs(默认 300s)强杀。 - 脚本查找顺序:
<dataHome>→<dataHome>/scripts→ 同名文件在scripts/下,绝对路径直用。 - 投递:配了
discordWebhook(整条 URL)优先;否则discordToken+ 任务deliver=discord:频道ID(空的用「默认频道 ID」);都没配则账本记skipped,面板显示「未配置频道」。 - 消息长相:脚本 stdout 原文直接发,保留脚本自己的 Markdown(粗体、列表、
代码、>引用、链接都正常渲染);不套代码块,也不额外加任务名标题行。超过 1800 字按行自动切成多条,多出的段带「(续 2/3)」前缀。
写盘安全
- 只写自己的任务文件与账本,不动任何其他应用的数据。
- 每次写入先复制到同目录
backups/,保留最近 10 份,再tmp + rename。 - cron 表达式落盘前用内置 5 段解析器验范围与步长,非法值直接拒绝。
writable: false可整体降级为只读;账本表用PRIMARY KEY(job_id, scheduled_instant)防重复记账。- 路由只接受同源请求:非本机来源且
Origin与Host不一致时直接 403。
配置项(cordis.patch.yml)
| 键 | 默认 | 说明 |
|---|---|---|
enabled | true | 关掉则整插件不注册 |
dataHome | 空 | 空 = <DSH_HOME>/schedule |
writable | true | 面板是否可写 |
tickMs | 20000 | 扫描间隔 |
catchUpSec | 3600 | 补跑容差(秒),超出的到点记 missed |
maxLatenessSec | 3600 | 老字段名,等同 catchUpSec(两者都在时以 catchUpSec 为准) |
missedNotify | true | 漏跑是否发 Discord 通知 |
missedNotifyCooldownSec | 1800 | 同一任务漏跑通知的冷却 |
missedLookbackMinutes | 4320 | 漏跑回看窗口(分钟,默认 3 天) |
missedCatchUpOnce | false | 超出容差也只补跑最近一次(休眠后不想整批作废时开) |
timeoutMs | 300000 | 单个脚本超时 |
pythonCommand | python | .py 解释器 |
discordWebhook / discordToken | 空 | 投递凭据 |
测试
node test\client-smoke.mjs # 客户端骨架:导出形状、两条 slot 是否注册
node test\e2e.mjs # 宿主端到端:建任务 / 到点执行 / 账本 / 同一分钟不重复 / 手动跑
node test\settings-e2e.mjs # 凭据与默认频道:保存 -> 打码回读 -> 清空;删掉的任务仍记住名字
node test\deliver-format.mjs # 投递格式:分片逻辑;配了凭据就真发一条到 Discord 核对渲染
node test\missed-catchup.mjs # 漏跑兜底:超容差只补跑最近一次;关掉后恢复「只记账」
前四个(含 missed-catchup)都在临时 dataHome 里跑,不碰真实配置、不发消息;只有 deliver-format 在配了凭据时会真发。CI(.github/workflows/ci.yml)用 Node 22 + Python 3.12 跑全部五个。
已知边界
- 账本读写用
node:sqlite,需要宿主 Node >= 22.5;低版本时账本该栏报错,任务与 ticker 照常。 - 原生「自动化任务」页属于产品包
dsh-client-ui-schedule,第三方只能并列新增入口,无法插入页签;ctx.remote.schedule.*也不可复用。 - 客户端除
react外不 require 任何dsh-client-*包:抛错的组件会清空整个 slot 条目。 - Windows 上
node:sqlite关闭时偶发Assertion failed: !(handle->flags & UV_HANDLE_CLOSING)告警,出现在进程退出阶段,不影响结果。
License
MIT © AkaneRanma
Comments
Loading…
Similar plugins
by 534119219
DSH 定时任务插件:侧栏「定时任务」入口,cron 定时执行 shell / python / node 脚本、Skill 与 Agent 任务;支持 chicheng-push 与 messaging-core 推送通知、会话归档、移动端适配。
★ 7
MIT
JavaScript
Aug 26, 2026
dsh plugin --profile web add chicheng-cronby csiroqa
DeepSeek Harness(DSH)定时任务 + 状态监控插件:按 cron 时间表自动触发 Agent 执行任务,/status 与设置页仪表盘查看系统与 harness 综合状态。Scheduled tasks (cron) + status monitoring plugin for DeepSeek Harness.
★ 3
MIT
TypeScript
Aug 23, 2026
dsh plugin --profile web add @dsh-external/dsh-scheduleby Mappedinfo
DSH 系统级 cron 定时任务插件:规则存为 Cron 表达式,由用户 crontab 在进程外执行 headless 任务,Web 端管理规则与运行结果
★ 0
MIT
TypeScript
Sep 14, 2026
dsh plugin --profile web add @mappedinfo/dsh-cron-schedulerby Jesse-njx
Scheduled agents on a cron: run a prompt on a schedule and get the digest where you already are, with overlap/missed-run/timeout safety defaults.
★ 0
MIT
TypeScript
Aug 28, 2026
dsh plugin --profile web add @dsh-routines/bundleby weibaohui
DeepSeek Harness 插件:cron 定时事项——定时/立即执行新建 agent 会话提交提示词,全屏管理界面
★ 11
↓ 880/wk
MIT
JavaScript
Oct 31, 2026
dsh plugin --profile web add @weibaohui/dsh-tasks给 DSH 的 Claude 风格定时任务:到点新开对话跑一轮
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-routines