yangyongzhen / dsh-scheduler

dsh-scheduler

DeepSeek Harness 定时任务插件：cron 表达式 / 一次性时间点触发，执行 shell 命令或投递 webhook，命令结果可选推送到 ServerChan / 钉钉 / 飞书 / 通用 Webhook。

安装

dsh plugin --profile <name> add dsh-scheduler
# 或从本地 checkout 安装
cd ~/dsh-scheduler && dsh plugin --profile <name> add .

配置

在 profile 的 cordis.patch.yml（或 --patch overlay）中：

- id: scheduler
  config:
    enabled: true
    jobs:
      - id: daily-report          # 每天 09:00 跑一次脚本，结果发 ServerChan
        cron: '0 9 * * *'
        timezone: 'Asia/Shanghai'
        task:
          type: command
          command: 'bash report.sh'
          channel:
            type: serverchan
            url: 'https://sctapi.ftqq.com/<SENDKEY>.send'
      - id: heartbeat             # 每 5 分钟 POST 一次心跳
        cron: '*/5 * * * *'
        task:
          type: webhook
          url: 'https://example.com/hook'
          payload: { text: 'dsh alive' }
      - id: deploy-window         # 一次性任务：到点执行
        at: '2026-08-16T09:00:00+08:00'
        task:
          type: webhook
          url: 'https://example.com/hook'

字段说明

字段	说明
jobs[].cron	5/6 位 cron 表达式（可含秒字段）；与 at 二选一
jobs[].at	ISO 8601 时间戳，一次性任务；与 cron 二选一
jobs[].timezone	可选，IANA 时区名（如 Asia/Shanghai），仅 cron 生效
jobs[].task.type	command（执行 shell 命令）或 webhook（POST JSON）
jobs[].task.command	要执行的命令；cwd 可选工作目录
jobs[].task.channel	可选，命令结果投递通道：serverchan / dingtalk / feishu / generic
jobs[].task.url / payload	webhook 端点与 JSON 载荷（自动附加 job 与 at 字段）

使用

插件提供模型可见工具 scheduler_status：列出所有已配置任务、下一次执行时间、上次执行状态与结果。Agent 在对话中询问「有什么定时任务」即可自动调用；任务本身按调度自动触发，无需人工干预。

• cron 任务错过执行窗口（如系统休眠）不会回补刷屏：触发后直接推进到下一次未来时刻。
• 命令执行有 120s 超时与 1 MiB 输出上限；投递失败只记录状态，不影响插件运行。
• 单次执行有重入保护，超长命令不会造成同任务并发。

开发

pnpm install && pnpm build
node --import tsx test/scheduler.test.mjs   # 引擎单测（假时钟 + 本地 webhook sink）

License

MIT