dsh-knj-scheduler

dsh-knj-scheduler

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

• 入口：左侧栏底部「更多 → 调度器」（菜单入口由 dsh-knj-menu 提供，已声明为 npm 依赖，安装命令见下）
• 面板：任务列表 / 执行记录双页签，各自带刷新按钮
• 任务列表与执行记录均分页显示（每页 10/25/50/100 条），分页条固定在面板底部
• 触发方式：Cron 表达式 / 指定时间（一次性，触发后自动停用）/ 间隔分钟数；表单实时预览下次执行时间
• 任务可配置工作目录：提示词会话可指定工作区；工作流任务必须指定工作目录
• 可选集成 dsh-knj-workflow：选择已保存的工作流后，到点按当时最新定义创建并启动流程任务
• 执行历史仅记录工作流「已成功启动」或启动失败；详细阶段/最终状态在「流程运行」中查看，并可点「查看流程任务」直达
• 执行状态流转：执行中 → 成功 / 失败 / 跳过（上一次未结束自动跳过，防重入），记录耗时
• 任务定义持久化于 profile 目录，重启自动恢复；执行历史保留上限 500 条

安装

dsh plugin --profile web add dsh-scheduler dsh-knj-menu

npm 包 dsh-scheduler，源码仓库 dsh-knj-scheduler。

侧边栏入口由 dsh-knj-menu 提供，上面一条命令同时安装两者（已作为 npm 依赖声明，版本自动配套）。

使用

1. 左侧栏「更多 → 调度器」打开面板
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 可解析），原子写入（写坏保留旧文件）
• 执行历史不记录提示词原文与会话内容，仅记录状态/耗时/会话 id 或工作流任务 id
• 任务执行真实消耗模型额度，且每个任务默认不并发执行（防重入）

License

MIT