前言¶
在 DeepSeek Harness (DSH) 的使用中，自动化工作流是提升效率的关键。现有方案往往需要手动触发，或者依赖复杂的脚本。dsh-tasks 插件通过 cron 表达式解决了这个问题，它将“定时执行提示词”的能力下沉到插件层，让用户可以像管理普通任务一样管理 AI 工作流。
是什么¶
dsh-tasks 是由用户 weibaohui 维护的 DSH 工作流插件。它的核心作用是：利用 cron 表达式定时执行提示词，到点自动创建一个新的 agent 会话并执行，用户也可以随时手动立即执行该任务。
核心功能¶
插件提供了以下能力：
* cron 定时执行：每个任务由标题、提示词和 cron 表达式构成，到点自动创建会话。
* 可视化定时选择器：提供快捷模板（如“工作日每天 9:00”）或逐级选择器，选定后实时预览最近 5 次执行时间，确保周期配置正确。
* 手动立即执行：列表中的任务可一键“立即运行”，无需等待 cron 到点。
* 绑定工作区与指定模型：任务可选择绑定特定工作区（会话继承目录），也可指定执行模型（默认跟随全局）。
* 会话自动命名：执行出的会话以“任务标题 · 时间”命名，便于在侧栏区分。
* 管理界面：提供全屏管理页，支持新建、编辑、启用/停用、删除。
* 执行记录：保留最近 20 次执行历史，支持展开追溯，成功记录可一键“打开对话”回看。
* 通知推送：支持在任务开始/完成/失败时推送到 IM（需依赖 dsh-im 等插件），完成通知可附带执行结论（截取末尾 1000 字）。
* 免打扰时段：支持配置起止时间，跨零点友好，时段内推送自动跳过。
安装与启用¶
通过 npm 包安装：
dsh plugin --profile web add @weibaohui/dsh-tasks -w
安装完成后，需要重启 dsh web 进程才能生效。
使用方法¶
- 打开 Web UI，进入 设置 页面，左侧点击 定时任务 section 即可进入管理面板。
- 点击新建任务，依次填写：
- 标题：任务名称。
- 提示词：需要 AI 执行的具体指令。
- cron 表达式：如0 9 * * 1-5表示工作日每天 9 点。
- 绑定工作区（可选）：指定会话挂载的目录。 - 保存后，任务将按 cron 规律执行。在列表页，可以随时进行 立即执行、编辑、停用或删除操作。
通知与免打扰¶
任务执行结果支持推送到 IM 渠道，但需要先安装 IM 投递插件（如 dsh-im）。
1. 在 IM 投递插件中配置至少一个目标。
2. 回到定时任务设置页底部，启用通知并勾选事件（开始/完成/失败）。
3. 勾选“完成通知附带执行结论”，推送将包含 agent 的最终回复内容。
4. 开启“免打扰”并设置起止时间，可过滤时段内的通知。
适用场景与注意¶
该插件适合需要定期整理待办、生成日报或沉淀知识的场景。
注意：插件以当前 DSH 进程的权限运行。安装前建议检查其源码与许可证（MIT），确保符合你的使用规范。
后记¶
经过上面的步骤，你已经完成了定时任务的配置。这个插件通过 cron 表达式和可视化工具，将 DSH 的 Agent 能力从“即时响应”扩展到了“定时响应”，是构建自动化工作流的基础组件。
