Skip to main content
Y

dsh-knj-scheduler

yangdongzhen590/dsh-knj-scheduler

Cron task scheduler for DSH: on schedule, automatically creates a new session and injects your prompt as its first message, with task history and manual run/stop controls. Also runs KNJ workflows: pick files directly (stored as persistent snapshots, re-handed to the workflow on every fire) or reference them by path. Its panel is registered in the settings page (settings.section), so no separate menu plugin is required.

Install

dsh plugin --profile web add github:yangdongzhen590/dsh-knj-scheduler

README

dsh-knj-scheduler

定时任务调度器插件:按 Cron 自动启动提示词会话或(可选)KNJ 工作流任务。 Scheduled tasks for DeepSeek Harness — start a prompt session or, optionally, a KNJ workflow task on a cron schedule.

  • 入口:设置 →「定时任务」(设置页左侧导航新增一行,点开即是任务面板;不再依赖侧栏菜单插件)
  • 面板:任务列表 / 执行记录双页签,各自带刷新按钮
  • 任务列表与执行记录均分页显示(每页 10/25/50/100 条),分页条固定在面板底部
  • 触发方式:Cron 表达式 / 指定时间(一次性,触发后自动停用)/ 间隔分钟数;表单实时预览下次执行时间
  • 任务可配置工作目录:提示词会话可指定工作区;工作流任务必须指定工作目录
  • 可选集成 dsh-knj-workflow:选择已保存的工作流后,到点按当时最新定义创建并启动流程任务
  • 工作流的「文件」入参支持按路径引用:工作流里声明了文件类型入参时,表单会为每个这样的参数渲染一个路径输入框(必填项标 *)。路径在每次触发时读取(不做快照):相对路径由工作流插件按任务工作目录解析成绝对路径,文件不存在会导致本次启动失败并记录可操作错误(历史里可见)。值随任务定义持久化,切换回「提示词会话」时自动清除
  • 执行历史仅记录工作流「已成功启动」或启动失败;详细阶段/最终状态在「流程运行」中查看,并可点「查看流程任务」直达
  • 执行状态流转:执行中 → 成功 / 失败 / 跳过(上一次未结束自动跳过,防重入),记录耗时
  • 任务定义持久化于 profile 目录,重启自动恢复;执行历史保留上限 500 条

安装

dsh plugin --profile web add dsh-scheduler

npm 包 dsh-scheduler,源码仓库 dsh-knj-scheduler。 入口由宿主设置页的 settings.section 槽位提供,无需额外安装菜单插件。

使用

  1. 设置 →「定时任务」打开面板(设置弹窗里内联显示,Esc 或右上角关闭设置)
  2. 「新建任务」:选择「提示词会话」并填写提示词;或选择「KNJ 工作流」、工作流、流程任务标题、必填工作目录、可选的用户故事编码,以及所选工作流声明的文件入参路径(有声明时才出现;相对路径按工作目录解析,触发时读取)
  3. 保存后按计划调度;提示词模式创建会话,工作流模式通过已安装的 dsh-knj-workflow 启动流程任务
  4. 工作流每次触发均解析最新已保存的定义;调度器不会等待或镜像流程最终状态
  5. 任务行可:编辑 / 启停 / 立即执行 / 查看单任务历史 / 删除
  6. 「执行记录」中,提示词任务可点「打开会话」;工作流任务可点「查看流程任务」直达流程运行详情

配置(可选)

在 cordis.yml 的插件行中可覆盖:

- id: dsh-scheduler
  config:
    dataDir: /path/to/custom/data   # 默认 $DSH_HOME/profiles/<profile>/dsh-scheduler
    historyRetention: 500           # 执行历史保留条数
    timezone: Asia/Shanghai         # Cron 时区(默认系统本地时区)

数据位置

  • 任务定义:$DSH_HOME/profiles/<profile>/dsh-scheduler/tasks.json
  • 执行历史:$DSH_HOME/profiles/<profile>/dsh-scheduler/history.jsonl

安全

  • 写操作仅接受同源 POST/PUT/DELETE(Origin 与 Host 校验)
  • 任务定义写前校验(提示词模式需提示词;工作流模式需工作流、标题和工作目录;文件入参必须是「参数名 → 非空字符串」的对象,且只适用于工作流任务;Cron 可解析),原子写入(写坏保留旧文件)
  • 文件入参只校验形状,不校验路径是否存在(该文件可能稍后才由别的流程产出);存在性由 dsh-knj-workflow 在启动前校验,缺文件时本次启动失败
  • 执行历史不记录提示词原文与会话内容,仅记录状态/耗时/会话 id 或工作流任务 id
  • 任务执行真实消耗模型额度,且每个任务默认不并发执行(防重入)

License

MIT

Related plugins