前言¶
DeepSeek Harness 作为插件化平台,其 Agent 通常仅在用户主动发起对话时响应。若需实现“到点执行”或“周期性检查”,现有方案较为繁琐。dsh-cron 插件通过在对话中自然语言创建任务,并在指定时间自动触发,解决了这一问题。它将任务提示注入原会话,Agent 执行后直接回复结果,并自带 Web 管理面板。
核心能力¶
- 对话式创建:用户在对话中直接描述任务(如“每周一早上 9 点提醒我交周报”),Agent 自动解析并创建。
- Web 管理面板:提供任务列表与执行记录抽屉,支持查看、编辑、暂停、删除任务及历史。
- 四级通知:包含未读徽标、页面 Toast、提示音、系统通知,确保执行结果可见。
- 工具集成:提供
cron_list,cron_add,cron_update,cron_remove,cron_history等模型工具。 - 调度规则:支持
at(一次性)、every(间隔)、daily(每日定点)、cron(标准表达式)。 - 持久化:执行记录持久化,重启后不会重发。
安装¶
使用官方命令安装。
dsh plugin --profile web add github:ZhuoSir/dsh-cron
典型用法¶
用户可直接在对话中输入:
* “每周一早上 9 点提醒我交周报”
* “每半小时检查一次构建”
* “总结今天的待办事项,给我一份晨报”
支持的调度规则:
* at:ISO 8601 时间。
* every:秒数,最小 10。
* daily:HH:MM 格式。
* cron:5 段标准 Cron。
注意事项¶
- 资源消耗:每次触发都是真实模型调用,消耗 Token。
- 权限:仅读写特定本地文件(
cron-tasks.json、cron-history.jsonl),HTTP API 仅限本地来源。 - 兼容性:DeepSeek Harness >= 0.1.0-rc.6, Node.js >= 22。
总结¶
dsh-cron 插件为 DeepSeek Harness 提供了原生的定时任务能力,适合需要自动化周期性任务的场景。插件由 ZhuoSir 维护,许可证为 MIT。