dsh-knj-scheduler: DeepSeek Harness 定时任务调度器

前言¶

DeepSeek Harness (DSH) 依托插件系统扩展功能。在开发或日常使用中，针对特定场景（如定期数据检查、自动报告生成）的重复性操作，手动执行效率低下。dsh-knj-scheduler 插件解决了这个问题，它允许用户通过 Cron 表达式或其他触发方式，自动启动提示词会话或 KNJ 工作流任务。

插件简介¶

dsh-knj-scheduler 是一个定时任务调度器插件。它解决了自动化执行的需求，支持按计划启动会话或工作流任务。该插件由 yangdongzhen590 维护，开源协议为 MIT。

核心功能¶

1. 自动触发：支持按 Cron 表达式、指定时间（一次性）或间隔分钟数自动启动提示词会话或 KNJ 工作流任务。
2. 面板入口：左侧栏提供「更多 → 调度器」入口（依赖 dsh-knj-menu 插件）。
3. 双页签与分页：面板包含「任务列表」与「执行记录」双页签，均支持 10/25/50/100 条/页的分页显示。
4. 工作目录配置：支持配置工作目录，提示词会话可指定工作区，工作流任务必须指定。
5. 集成 KNJ 工作流：可选集成 dsh-knj-workflow，支持文件入参按路径引用。
6. 状态与历史：记录执行状态（成功/失败/跳过）及耗时。执行历史保留上限 500 条。
7. 持久化：任务定义持久化于 profile 目录，重启后自动恢复。

安装与启用¶

安装该插件需要同时安装 dsh-scheduler 核心包及 dsh-knj-menu 依赖。

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

典型用法¶

1. 打开面板：在左侧栏底部点击「更多 → 调度器」。
2. 创建任务：
   • 点击「新建任务」。
   • 选择任务类型：「提示词会话」或「KNJ 工作流」。
   • 填写相关字段：提示词、工作流、标题、工作目录及文件入参路径（工作流模式下必填）。
3. 调度执行：保存任务后，系统将按计划自动调度；提示词模式创建会话，工作流模式通过 dsh-knj-workflow 启动流程任务。
4. 任务管理：对任务行进行编辑、启停、立即执行、查看历史或删除操作。
5. 查看详情：
   • 在「执行记录」中，提示词任务点击「打开会话」。
   • 工作流任务点击「查看流程任务」直达流程运行详情。

注意事项¶

1. 安全校验：写操作仅接受同源 POST/PUT/DELETE（Origin 与 Host 校验），任务定义写前需校验各项参数，采用原子写入。
2. 文件入参：文件入参只校验形状，不校验路径存在性（由 dsh-knj-workflow 启动前校验）。
3. 历史记录：执行历史仅记录状态/耗时/会话 ID 或工作流任务 ID，不记录提示词原文与会话内容。
4. 并发控制：任务执行消耗模型额度，默认不并发执行（防重入），若上一次未结束，本次触发将自动跳过。
5. 数据位置：
   • 任务定义：$DSH_HOME/profiles/<profile>/dsh-scheduler/tasks.json
   • 执行历史：$DSH_HOME/profiles/<profile>/dsh-scheduler/history.l

结语¶

dsh-knj-scheduler 通过 Cron 调度与持久化配置，为 DSH 提供了自动化执行能力。开发者可通过配置工作流和会话，实现后台任务的自动化。更多细节可查阅 GitHub 仓库。