前言¶
在 DeepSeek Harness（DSH）里做智能体，常见需求是「每隔一段时间自动执行同一段提示词」——例如日报汇总、定时巡检、周期性整理上下文。若只靠手动开会话或外部 cron 调 API，要么容易忘，要么会话状态纠缠、结果不好对照。
下面介绍社区插件 dsh-scheduled-tasks（npm 包名 @istarry/dsh-scheduled-tasks）：在 DSH 进程内维护任务列表，到点绑定指定 Agent 预设与提示词，每次触发新开一个会话执行，并保留运行记录。维护者为 iStarryDust，在插件目录中归类为「工作流」。
这是什么¶
一句话：给 DSH 加一套定时任务——每个任务包含名称、绑定的 Agent 预设、提示词、周期（cron 式）和启用开关；到点后调度引擎创建新会话跑提示词，并把执行时间与结果写入历史。
插件以 MIT 许可发布，当前主包版本为 0.1.1（见仓库 package.json）。README 写明实测环境为 DSH 0.2.0-rc.2；peer 依赖包括 @deepseek-ai/cordis、@deepseek-ai/schemastery 等，细节见各子包 package.json。
核心功能¶
任务模型¶
每个任务具备：
- 名称
- 绑定的 Agent 预设
- 提示词
- 周期（cron 表达式）
- 启用开关
到点执行方式¶
每次触发都会开启一个全新的会话，而不是在旧会话上续写。因此上下文干净，多次运行之间更易对比、复现。
运行记录¶
每次执行会记录时间、结果与错误。历史条数按 runHistoryLimit 保留，默认 500 条。
设置页¶
通过配套 UI 包可在 DSH 设置中管理：
- 任务列表
- 运行历史
- 创建 / 编辑任务对话框
包结构¶
| 包 | 职责 |
|---|---|
@istarry/dsh-scheduled-tasks |
调度引擎：任务存取、触发、创建会话 |
@istarry/dsh-client-ui-settings-scheduled-tasks |
设置页：任务列表、运行历史、编辑对话框 |
安装入口包会聚合上述依赖；引擎通过 cordis.patch.yml 接入 DSH 插件体系。
安装与启用¶
在已安装 DSH CLI 的环境中执行：
dsh plugin add @istarry/dsh-scheduled-tasks
装完后重启 DSH 服务，再在设置页中创建任务并打开启用开关。
典型用法¶
README 未给出单独的配置文件示例；实际操作路径是：安装 → 重启 → 在设置页新建任务。可按下面思路配置一条任务：
- 选择要使用的 Agent 预设（与平时手动会话一致）。
- 填写要在到点时执行的 提示词（完整、可独立理解，因为每次都是新会话）。
- 填写 cron 周期（例如工作日早上九点可用常见五段 cron 表达式）。
- 打开 启用，保存后在「运行历史」中观察首次触发是否正常。
触发成功时，应能在历史里看到对应时间与结果；若失败，错误信息也会落在同一条记录中，便于排查提示词或预设问题。
权限、存储与调度边界¶
- 任务定义与运行记录保存在 harness home（
~/.dsh）下。 - 每次触发会创建新会话并消耗模型额度；任务数量多、周期密时，消耗会明显增加。
- 调度仅在 DSH 进程存活时生效：进程关闭期间到点的任务不会补跑。
安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证；插件以当前 DSH 进程权限运行，任务里的提示词与所选 Agent 预设等同于你在 UI 里手动发起的一次会话。
适用场景与注意¶
较适合：需要固定周期、固定提示词、且希望每次执行互不污染上下文的自动化（定时摘要、定时检查类工作流等）。
需注意：
- 依赖 DSH 常驻；不适合「机器关机也要准点补跑」的强 SLA 场景。
- 周期与提示词设计要克制，避免高频任务带来不必要的模型调用。
- 社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，版本与星标以各站点当时展示为准（目录线索星标为 0）。
结尾¶
dsh-scheduled-tasks 把「Agent 预设 + 提示词 + cron」收进 DSH 插件里，用新会话执行并留痕，适合在 Harness 生态里做轻量定时工作流。进一步了解可访问插件目录页与仓库：
- 目录页：https://www.skillhub.cn/plugins/iStarryDust/dsh-scheduled-tasks
- GitHub：https://github.com/iStarryDust/dsh-scheduled-tasks
