dsh-cron-panel

dsh-cron-panel

English · Español

DSH Web GUI 的定时任务面板：位于侧边栏工作区与设置之间，分区管理 DSH 定时任务与系统定时任务（crontab），支持自然语言创建、全屏详情编辑、执行记录查看。

功能

• 侧边栏面板：工作区下方、设置上方；标题右侧 ➕ 新增、▾ 收起（收起后折叠成一条小标题栏，状态持久化）

• 分区展示与状态指示：DSH 定时任务（带管理标记）与系统定时任务分开显示，列表项配备执行状态圆点（🟢 成功 / 🔴 失败 / ⚪ 未执行）

• 执行记录与一键清空：面板创建的任务自动记录日志，支持实时刷新与一键清空日志文件，避免长期运行日志膨胀

• 自然语言创建：输入「每天上午 9 点运行备份」「每 30 分钟清理临时文件」「每周一晚上 8 点」即自动解析为 cron 表达式，也可手动填写

  • 本地正则即时解析：中英文常见说法零延迟出结果，并把识别出的「要做什么」自动填入 Agent Prompt
  • LLM 兜底精修（v0.1.12 新增）：本地正则覆盖不到的语种与句式（日语、韩语、复杂表述等）自动交由默认模型解析；未配置模型或调用失败时静默回退本地正则，不打扰用户

• 全屏详情：点击任务在对话区全屏覆盖，右上角关闭；支持编辑 / 保存 / 删除 / 启停

• 下次执行预览：编辑时输入 cron 表达式自动显示「接下来 5 次运行时间」，避免表达式写错

  • 修复（v0.1.12）：此前 30 13 * * 3（每周三 13:30）等表达式会被错误预览成「每天」，源于「日 / 周」字段语义判断有误；现已按 cron 规范修正，并改为逐日推进（低频表达式如 0 0 29 2 * 不再长时间阻塞）

• Agent Prompt 自动化任务：除传统 Shell 脚本外，支持一键切换为「🤖 Agent Prompt 自动化」模式，到点由 DSH 在后台自动拉起会话执行指定的 Agent 提示词（例如每日自动代码巡检、晨间简报），并可将结果自动推送到企业微信或群聊

• 完成后主动通知：编辑任务时可配置「完成后通知」——任务执行结束后，结果自动推送到所选平台（Telegram / Discord / 企业微信智能机器人 / Email），需已安装并连接 dsh-message-gateway（QQ 官方不支持主动推送）。推送走网关的 /gateway/push，cron 命令自动追加推送段（含退出码与任务描述），无需额外配置

  • 注意（v0.1.12）：Agent Prompt 任务不触发此自动推送。agent 会话本身就会产出消息，再被通知钩子重推一次会形成重复噪音；需要提醒时请在 Prompt 内让 agent 调用推送工具

• 立即运行：任务详情里点「立即运行」直接执行一次命令（不经 cron 调度），查看退出码与输出——建完任务先验证再等调度

  • 注意（v0.1.12）：当前仅 Shell 命令支持即时执行。Agent Prompt 任务会返回提示而不真正拉起会话（避免长时间无反馈）；实时流式执行将在后续迭代提供

• 失败自动重试：可配置失败后自动重试次数与间隔（命令在子 shell 中执行，失败退出码触发重试）

• 写前自动备份：每次改写 crontab 前自动备份当前内容到 ~/.local/share/dsh-cron-backups/（保留最近 20 份），误操作随时可回滚

• 多语言：自动跟随 DSH Web 界面语言（中文 / 英文），西班牙语浏览器自动切换西班牙语，默认简体中文

• 跨平台与主题适配：

  • Windows 环境下自动兼容处理，避免 spawn /usr/bin/crontab ENOENT 异常，支持本地定时任务持久化与优雅降级
  • 全面优化明暗主题颜色对比度，完美适配浅色模式，防止文字对比度缺失

• 明暗主题跟随 DSH Web GUI

侧边栏收起态（v0.1.13 新增）

当用户折叠 workbench 侧栏时，原本的完整面板会替换为一个 36×36 主题自适应入口按钮（位于侧栏底部，紧贴设置按钮上方）。点击该按钮会弹出全屏任务列表：

• 标题栏显示总任务数 + 「+ 新增」按钮 + 关闭按钮
• 分组列出 与 ，每行带状态点（🟢 成功 / 🔴 失败 / ⚪ 未执行）
• 任意一行点击即进入 编辑；按 关闭弹窗
• 列表数据来源仍是后端 解析，与展开态完全一致
• 浅色 / 深色主题下按钮都协调（浅色用极淡灰底，深色用半透明白底）

界面预览

侧边栏面板（DSH / 系统分区 + 新增 + 收起）：

侧边栏收起态 + 任务列表弹窗（v0.1.13）：

全屏详情（编辑表单 + 执行记录，右上角关闭）：

安装

dsh plugin --profile web add dsh-cron-panel

重启 dsh web，侧边栏工作区下方出现「定时任务」面板。

本地开发时可用 dsh plugin --profile web add link:/path/to/dsh-cron-panel 以链接方式安装，修改源码后 npm run build 并刷新页面即可生效。

反馈

使用中遇到问题或有功能建议？欢迎到 GitHub Issues 反馈，帮助我们把插件做得更好。

License

MIT