前言¶
在 DeepSeek Harness(dsh web)中做定时任务时,常见需求不只是让脚本到点运行,还包括执行结果可查、输出可回看、任务完成后可推送,以及 Agent / Skill 会话能集中整理。已有做法往往要在系统 crontab 或外部任务调度中配置,再单独处理输出和通知。chicheng-cron 把这类定时任务放进 dsh web 的侧栏入口里配置和查看。
这是什么¶
chicheng-cron 是 DeepSeek Harness(dsh web)的定时任务插件,维护者为 534119219,许可证为 MIT。它用 cron 表达式定时执行 Shell / Python / Node.js 脚本、Skill 或 Agent 任务,并支持推送通知、会话整理与移动端适配。
核心功能¶
侧栏入口位于「新会话」按钮下方,名为「定时任务」。
任务类型包括:
1、Shell 脚本:Windows 使用 cmd.exe,其他平台使用 /bin/sh。
2、Python 脚本:自动探测 python / py / python3。
3、Node.js 脚本:使用当前 Node 运行时。
4、Skill 任务。
5、交给 Agent 的任务。
调度支持标准 5/6 字段 cron、@hourly 到 @yearly 与 @every,使用本地时间计算,并在重启后自动恢复。
推送通知可对接 chicheng-push 与 messaging-core,并支持模板占位符。
Agent / Skill 的运行会话可归入「定时任务」工作区;也可配置成功后自动归档会话。
执行历史会记录状态、退出码、耗时、推送结果与归档标记,并支持通过弹窗查看输出。
移动端适配包括窄屏单页导航、执行历史默认收起、16px 输入防 iOS 缩放与安全区适配。
安装与启用¶
先安装插件:
dsh plugin --profile web add github:534119219/chicheng-cron
安装后重启 dsh web,左侧栏「新会话」下方会出现「定时任务」按钮。
典型用法¶
1、点击侧栏「定时任务」,新建任务。
2、选择任务类型,填写名称、cron 表达式、脚本或提示词、工作目录和超时。
3、按需配置完成后推送通知、Agent / Skill 会话归入「定时任务」分组、成功后自动归档会话。
4、保存后按 cron 自动执行;也可使用「立即执行」手动触发,并在执行历史中查看结果与输出。
数据与限制¶
任务与历史保存在:
$DSH_HOME/cron/store.json
运行输出保存在:
$DSH_HOME/cron/runs/
Agent / Skill 任务通过以下命令执行:
dsh --profile headless
它会复用:
$DSH_HOME/settings.yaml
中的模型配置。
如果 dsh web 未运行时错过了某个调度时间点,不会补跑。
适用场景与注意¶
适合需要在 dsh web 中维护定时脚本、Skill 或 Agent 任务,并查看执行历史与输出的开发者。
插件会执行 Shell / Python / Node.js 脚本、Skill 或 Agent 任务,并以当前 dsh 进程权限运行;安装前应检查源码与 MIT 许可证,再确认任务内容、工作目录和超时设置。
链接¶
GitHub:https://github.com/534119219/chicheng-cron