定时任务编排 wynoob/dsh-task-orchestrator

dsh-task-orchestrator

Codex 风格的定时自动任务编排插件。
设置好任务名称、提示词和调度规则后，插件会在到期时间自动新建一个 DSH 会话让 agent 执行该提示词，并记录每次运行结果。

目录

- 功能
- 安装
- 使用
- 「已安排」视图
- 对话中创建任务
- 模型与 Provider 选择
- 工具参考
- 存储
- HTTP API
- 限制
- 开发
- License

功能

- 定时自动任务：支持 5 字段 cron（分 时 日 月 周）以及 @hourly / @daily / @weekly / @monthly、@every 5m / @every 1h / @every 1d 快捷写法。
- 固定间隔任务：every_minutes（至少 5 分钟），从创建时间对齐。
- 时区感知：cron 按 IANA 时区计算下一次运行时间（如 Asia/Shanghai）。
- 新会话执行：每次运行通过 ctx.agents.create 创建独立 DSH 会话，执行完成后落盘并释放。
- 模型工具：task_orchestrator_create / list / update / delete / run / runs，可直接在对话里创建和管理任务。
- Codex 风格 UI：会话视图顶部新增「已安排」入口（对话 / 轨迹旁），点击直接进入任务管理；每个任务行右侧有「⋯」操作菜单（立即运行 / 暂停 / 删除），删除带确认弹窗。
- 模型下拉：创建 / 编辑任务时，provider 与模型自动读取当前 desktop 可读的模型目录（llm.models），无需手动输入。
- 设置页入口：DSH 设置 → 任务编排，同一个管理界面。
- HTTP API：/api/task-orchestrator/（仅接受 loopback 请求），供客户端 UI 使用。

安装

本地安装

dsh plugin --profile desktop add /path/to/dsh-task-orchestrator

从 GitHub 安装

发布到 GitHub 后，可以直接按仓库地址安装：

dsh plugin --profile desktop add "github:wynoob/dsh-task-orchestrator#main"

dsh plugin 底层转发给 pnpm，因此本地路径、github:、file:、link: 等包规格都支持。只有声明了 dsh.bundle.patch 的包才会成为 active profile layer。

安装后重启 DSH（或重新加载插件）。本地安装会以 link 依赖方式挂载，请保留源码目录。

使用

「已安排」视图

打开任意会话后，在会话视图顶部点击「对话 / 轨迹」旁边的 「已安排」 tab，即可进入任务管理界面：

- 左上「创建」新建任务
- 任务行右侧「⋯」→ 立即运行 / 暂停（启用） / 删除
- 删除会先弹确认框
- 选中任务后，右侧详情栏显示任务提示词、运行于 / 项目 / 模型 / 频率 / 重复 / 下次运行 / 最近状态，以及运行历史记录
- 底部「建议」区提供三个预置任务：每日简报、每周回顾、跟进监控，点击可预填创建表单

也可以从 DSH 设置 → 任务编排 进入同一界面。

对话中创建任务

帮我创建一个每天早上 9 点（Asia/Shanghai）运行的任务，名称“每日测试”，提示词是“运行 pnpm test，把失败用例整理成报告”，运行目录 /Users/me/project

模型会调用：

{
"name": "每日测试", "prompt": "运行 pnpm test，把失败用例整理成报告", "cron": "0 9 * *", "time_zone": "Asia/Shanghai", "cwd": "/Users/me/project" }

模型与 Provider 选择

创建 / 编辑任务时：

- 插件调用 llm.models 拉取当前 desktop 可读的模型目录
- Provider 下拉：显示所有可用 provider
- Model 下拉：显示该 provider 下的模型列表
- 切换 provider 会自动把 model 重置为该 provider 的第一个模型
- 如果模型目录不可用，表单会回退为手动输入并给出提示

工具参考

| 工具 | 说明 |
| task_orchestrator_create | 创建定时自动任务。cron 与 every_minutes 二选一。 |
| task_orchestrator_list | 列出所有任务及其调度状态、最近运行结果、下次运行时间。 |
| task_orchestrator_update | 更新任务。只传需要修改的字段。 |
| task_orchestrator_delete | 删除任务及其运行记录。 |
| task_orchestrator_run | 立即运行一次任务（不等调度时间）。 |
| task_orchestrator_runs | 查看最近运行记录，可按 task_id 过滤。 |

task_orchestrator_create 参数

| 参数 | 类型 | 必填 | 说明 |
| name | string | ✅ | 任务名称 |
| prompt | string | ✅ | 任务提示词，到期时作为新会话的第一条用户消息执行 |
| cron | string | 二选一 | 5 字段 cron 或 @hourly / @daily / @weekly / @monthly / @every 5m / @every 1h / @every 1d |
| every_minutes | integer | 二选一 | 固定间隔分钟数，至少 5 |
| time_zone | string | | IANA 时区，如 Asia/Shanghai、UTC |
| cwd | string | | 运行目录的绝对路径 |
| provider | string | | 模型 provider，默认使用系统默认模型 |
| model | string | | 模型名，默认使用系统默认模型 |
| enabled | boolean | | 是否启用，默认 true |

存储

任务和运行记录保存在：

$DSH_HOME/storages/dsh-task-orchestrator/tasks.json

HTTP API

| 方法 | 路径 | 说明 |
| GET | /api/task-orchestrator/tasks | 列出任务 |
| POST | /api/task-orchestrator/tasks | 创建任务 |
| PATCH | /api/task-orchestrator/tasks/:id | 更新任务 |
| DELETE | /api/task-orchestrator/tasks/:id | 删除任务 |
| POST | /api/task-orchestrator/tasks/:id/run | 立即运行任务 |
| GET | /api/task-orchestrator/runs?task_id=:id | 查询运行记录 |

所有端点仅接受 loopback 请求（127.0.0.1 / localhost / [::1]），供 DSH 客户端 UI 使用。

限制

- 任务只在 DSH 应用运行期间触发；应用未启动时不会补跑错过的 cron（固定间隔任务最多补跑最近一次）。
- cron 调度精度为分钟。
- DST 夏令时缺口内的时间会被跳过；重叠时间取算法确定的其中一个时点。
- 删除任务会同时删除其运行记录。

开发

纯 JS ESM，无构建步骤：

lib/
├── index.js # 宿主插件：任务存储、调度器、agent 运行器、模型工具、HTTP API ├── client.js # 浏览器端 UI（window.__ModuleLoader__ 格式） └── types/ # TypeScript 类型声明 cordis.patch.yml # bundle patch：注册到 desktop profile

本地开发流程：

语法检查
node --check lib/client.js
node --check lib/index.js

安装到 desktop profile（link 依赖，改动即生效）
dsh plugin --profile desktop add /path/to/dsh-task-orchestrator

重启 DSH 或重新加载插件

License

MIT