在 DSH Web GUI 中直接管理定时任务,是智能体开发者常见的诉求。现有的 crontab 管理方式通常需要手动编辑文件,既繁琐又容易出错。dsh-cron-panel 插件提供了一个可视化的面板,直接集成在侧边栏中,用于统一管理 DSH 定时任务和系统 crontab。
插件简介¶
dsh-cron-panel 是 DSH Web GUI 的一个客户端插件,由用户 a792883583 维护。它位于侧边栏工作区下方、设置上方,主要解决在 Web 界面分区查看和管理 DSH 定时任务与系统 crontab 的问题。
核心功能¶
- 侧边栏面板:面板标题右侧提供「新增」按钮,支持收起折叠,收起后显示为小标题栏。
- 分区展示与状态:DSH 定时任务与系统
crontab分开显示。列表项配有圆点指示执行状态(成功 / 失败 / 未执行)。 - 自然语言创建:支持输入常用语言自动解析为 cron 表达式(中英文,17+ 常见模式),也支持手动填写。
- 全屏详情与编辑:点击任务全屏覆盖编辑区,支持编辑、保存、删除、启停操作。
- 下次执行预览:编辑时输入 cron 表达式,自动显示接下来 5 次的运行时间。
- Agent Prompt 自动化:支持一键切换为 Agent 模式,后台自动拉起会话执行提示词。
- 执行与通知:支持任务「立即运行」直接执行;支持配置完成后推送到 Telegram、Discord、企业微信或 Email。
- 容错与备份:支持失败自动重试(可配置次数与间隔);每次改写
crontab前自动备份到~/.local/share/dsh-cron-backups/(保留最近 20 份)。 - 适配性:自动跟随 DSH 界面语言;支持明暗主题;Windows 环境下有兼容处理。
安装与启用¶
使用官方插件管理器安装:
dsh plugin --profile web add dsh-cron-panel
安装完成后,需要重启 dsh web 服务才能在侧边栏看到面板。
典型用法¶
- 快速创建:在面板输入「每天上午 9 点运行备份」,系统自动解析为 cron 表达式。
- 验证执行:新建任务后,点击「立即运行」查看输出和退出码,确认无误后再等待定时调度。
- 自动化通知:配置「完成后通知」,结果会自动推送到 Telegram、Discord、企业微信或 Email(需确保已连接
dsh-message-gateway)。
注意事项¶
- 企业微信或群聊推送需要先安装并连接
dsh-message-gateway。 - QQ 官方不支持主动推送功能。
- 安装后务必重启
dsh web。