前言¶
DeepSeek Harness(DSH)的生态核心在于插件化扩展。DSH 自身包含一个轻量级的 schedule 扩展,主要用于在活跃对话中设置提醒或定时提示。当需要执行持续的后台任务(如定期检查 API 健康状况、同步数据库或生成每日早报)时,这种即时对话式的调度方式显得不足。
@goodandready/dsh-cron 是为此类需求设计的插件。它为 DeepSeek Harness 提供了一个原生的全栈调度和后台自动化引擎,支持通过可视化界面或自然语言指令管理定时任务。
插件介绍¶
该插件由 GooDAnDReaDY 维护,开源协议为 MIT。
核心定位:为 DeepSeek Harness 提供的定时 cron 任务、后台自动化和代理执行引擎。
运行环境:需要 Node.js 20+ 环境。
核心功能¶
该插件提供以下主要能力:
-
丰富的可视化任务管理器
在 DSH 侧边栏提供时钟图标入口,点击可展开任务列表。面板支持按状态筛选(全部、活跃、暂停、已完成)。用户可以查看每个任务的下次运行时间、历史执行记录(含状态、耗时、输出)、统计数据(运行次数、Token 消耗)以及总成本。支持手动触发、暂停/恢复、删除任务。 -
交互式“Create with DSH”工作流
提供对话框式入口,用户可以通过自然语言描述需求(例如“检查开放 PR 并起草评论”)。插件会启动一个专门的 Agent 会话,协助将需求转化为具体的 Cron 表达式和任务配置。 -
自主 AI 工具调用
Agent 可以通过统一的cron工具(包含 create, list, get, update, pause, resume, run, delete 等动作)来管理后台自动化,无需为每种操作单独编写 Schema。 -
健壮的调度器与原子存储
基于croner库实现,支持 Cron 表达式和自然间隔语法(如15m,1h)。任务配置以原子化方式持久化存储,具备运行历史记录和成本追踪功能。 -
六种执行运行时
支持以下执行环境:- Shell
- Node.js
- Python
- HTTP/Webhook
- Remote SSH
- Docker
-
多渠道通知与模板
任务执行结果可同时分发至 9 个渠道,包括 Telegram、dsh-kanban、Discord、Slack、ntfy、Bark、PushPlus、voice (dsh-tts) 和 Gitea。支持使用{variable}模板引用变量,并通过 DSH 凭证名称引用敏感信息。
安装与依赖¶
本插件作为 DSH 插件安装,运行时依赖以下 DSH 核心模块:
@deepseek-ai/cordis >= 4.0.1
@deepseek-ai/dsh-agent >= 0.1.0-rc.6
@deepseek-ai/dsh-llm >= 0.1.0-rc.6
@deepseek-ai/dsh-session >= 0.1.0-rc.6
@deepseek-ai/dsh-settings >= 0.1.0-rc.6
@deepseek-ai/dsh-tools >= 0.1.0-rc.6
schemaster
典型用法¶
该插件适用于以下自动化场景:
* 检查开放 PR 并起草审查评论
* 定期检查 API 健康状况
* 数据库同步
* 生成每日早报
* 错误跟踪器的分类
适用场景与注意¶
该插件适合需要在后台长期运行、定期触发或需要跨环境执行的任务开发者。由于任务在当前 DSH 进程权限下运行,建议在安装前检查源码与许可证(MIT),确保符合安全与合规要求。
结尾¶
通过 @goodandready/dsh-cron,开发者可以在 DSH 中构建具备持续运营能力的自动化系统。更多细节可参考其GitHub 仓库。