DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-cron

A

dsh-cron

Manifest valid

DSH 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.

UI (client)hasBundlePatchMachine translated

定时任务(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
HTTPPOST /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)

键默认说明
enabledtrue关掉则整插件不注册
dataHome空空 = <DSH_HOME>/schedule
writabletrue面板是否可写
tickMs20000扫描间隔
catchUpSec3600补跑容差(秒),超出的到点记 missed
maxLatenessSec3600老字段名,等同 catchUpSec(两者都在时以 catchUpSec 为准)
missedNotifytrue漏跑是否发 Discord 通知
missedNotifyCooldownSec1800同一任务漏跑通知的冷却
missedLookbackMinutes4320漏跑回看窗口(分钟,默认 3 天)
missedCatchUpOncefalse超出容差也只补跑最近一次(休眠后不想整批作废时开)
timeoutMs300000单个脚本超时
pythonCommandpython.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

chicheng-cron

by 534119219

DSH 定时任务插件:侧栏「定时任务」入口,cron 定时执行 shell / python / node 脚本、Skill 与 Agent 任务;支持 chicheng-push 与 messaging-core 推送通知、会话归档、移动端适配。

Workflow & AutomationManifest valid

★ 7

MIT

JavaScript

Aug 26, 2026

dsh plugin --profile web add chicheng-cron

by csiroqa

DeepSeek Harness(DSH)定时任务 + 状态监控插件:按 cron 时间表自动触发 Agent 执行任务,/status 与设置页仪表盘查看系统与 harness 综合状态。Scheduled tasks (cron) + status monitoring plugin for DeepSeek Harness.

Development & InfrastructureManifest valid

★ 3

MIT

TypeScript

Aug 23, 2026

dsh plugin --profile web add @dsh-external/dsh-schedule

by Mappedinfo

DSH 系统级 cron 定时任务插件:规则存为 Cron 表达式,由用户 crontab 在进程外执行 headless 任务,Web 端管理规则与运行结果

Manifest valid

★ 0

MIT

TypeScript

Sep 14, 2026

dsh plugin --profile web add @mappedinfo/dsh-cron-scheduler

by 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.

Workflow & AutomationManifest valid

★ 0

MIT

TypeScript

Aug 28, 2026

dsh plugin --profile web add @dsh-routines/bundle

by weibaohui

DeepSeek Harness 插件:cron 定时事项——定时/立即执行新建 agent 会话提交提示词,全屏管理界面

Workflow & AutomationManifest valid

★ 11

↓ 880/wk

MIT

JavaScript

Oct 31, 2026

dsh plugin --profile web add @weibaohui/dsh-tasks

给 DSH 的 Claude 风格定时任务:到点新开对话跑一轮

Workflow & AutomationManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-routines