前言¶
DeepSeek Harness（DSH）通过插件机制扩展功能。在需要定期执行智能体任务或获取结果反馈时，手动操作效率较低。dsh-cron-job 插件解决了这一痛点，它为 DSH 增加了定时任务调度与多渠道消息推送能力，允许用户通过自然语言描述任务并自动执行。
插件定位¶
这是 DeepSeek Harness 的定时任务与通讯插件。项目地址在 GitHub，许可证为 MIT，由用户 upJiang 维护。它支持将任务结果发送到微信、飞书、钉钉、企业微信、QQ、Slack、Telegram、Discord 或 WhatsApp。
安装与启用¶
在安装前，请确保已安装 DeepSeek Harness，且 Node.js 版本不低于 22.19。准备好可用的 DSH 模型和对应平台的机器人账号。
安装程序默认将插件安装到 web profile，它会替换旧版 dsh-im 通讯插件，并保留原有渠道配置和凭据引用。
npx -y github:upJiang/dsh-cron-job install
安装完成后，停止 DSH 服务并重新启动：
dsh web --host 127.0.0.1 --port 3080
刷新浏览器，访问 http://127.0.0.1:3080/ 即可使用新功能。
连接通讯账号¶
- 打开 DSH 设置中的“通讯账号”。
- 选择微信、飞书、钉钉、企业微信、QQ、Slack、Telegram、Discord 或 WhatsApp。
- 按页面提示扫码或填写平台凭据。
- 完成连接测试。
注意：各设备的账号配置独立保存，插件不会在设备之间同步密钥、Token 或登录状态。
微信主动推送依赖最近一次私聊的回复上下文。首次使用或从旧版本升级后，请先在目标会话中给机器人发送一条消息，再执行连接测试或创建微信推送任务。
核心功能¶
该插件提供以下能力：
* 定时任务调度：支持自定义执行时间。
* 多渠道推送：支持微信、飞书、钉钉、企业微信、QQ、Slack、Telegram、Discord、WhatsApp。
* 微信主动推送：基于私聊上下文进行消息推送。
* 任务测试与验证：创建前进行全链路测试，确保工作区、模型、Agent、数据源和通知目标正常。
* 任务并发控制：同一个任务不会并发执行。
* 代理支持：支持配置 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 环境变量。
创建与使用¶
- 打开 DSH 设置中的“定时任务”。
- 描述任务：用自然语言描述执行时间、要读取的内容和推送位置。也可以载入内置的 Product Hunt + GitHub Trending 示例进行修改。
- 配置参数：选择工作区、模型和推送目标，生成草稿。
- 检查与测试：检查时间、时区、提示词、工具权限和通知目标。
- 测试并创建：点击“测试并创建”，等待工作区、模型、Agent、数据源和通知目标完成真实测试。测试消息带有“定时任务创建测试”标记，任一环节失败则任务不会创建。
- 确认并启用：测试通过后，点击“确认并启用”。
管理与限制¶
在“定时任务”页面可以搜索、筛选、编辑、暂停、恢复、立即运行或删除任务。
运行机制：
* 每次运行使用独立的 DSH Session。
* 同一个任务不会并发执行。
* DSH 关闭期间错过的任务不会补跑。
网络环境：
* 如果网站只能通过代理访问，插件会优先使用 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 环境变量。
* 未设置环境变量时，插件会读取当前用户的系统代理，但不会修改系统代理设置。
总结¶
dsh-cron-job 为 DeepSeek Harness 用户提供了从任务调度到消息通知的闭环能力。通过自然语言配置与严格的测试机制，可以确保自动化任务稳定运行。
