dsh-plugin-automations

Scheduled tasks for the DeepSeek Harness Web Profile: run once or on a standard six-field Cron schedule, either on time or during DeepSeek off-peak hours.

Features

Settings-page form and task list with 5-second polling.
Two execution modes: on time and when idle (valley hours).
Two schedule types: once and standard six-field Cron expressions. Cron is evaluated in the host's local timezone.
when_idle runs outside Beijing peak hours (09:00-12:00 and 14:00-18:00) and automatically defers to the next valley window.
Optional Session title templates support all task fields and Moment-style datetime formats, for example Daily Feed · {{scheduledAt:YYYY-MM-DD}}.
Durable task state through ctx.storageDomain.
One serialized scheduler pump persists running before launching the runner.
Each occurrence uses an ordinary isolated Session with the default Agent preset, model, and Host workspace root.
Fixed 30-minute execution timeout and explicit host_interrupted recovery.
Strict JSON API validation, request-size limits, same-origin checks, and a custom mutation header.
Automated messages use { kind: 'plugin', plugin: 'dsh-plugin-automations' } and never impersonate direct human input.

The full behavioral contract is documented in SDD.zh-CN.md.

Installation

`dsh plugin add` (recommended)

Install into the Web profile and restart DSH after installation.

From GitHub

dsh plugin --profile web add github:Sev7een/dsh-plugin-automations

From npm

Once the package is published to npm:

dsh plugin --profile web add dsh-plugin-automations

If you run DSH through npx, use the equivalent command:

npx @deepseek-ai/dsh plugin --profile web add github:Sev7een/dsh-plugin-automations

Verify the composed profile and restart the Web app:

dsh --profile web --dump-config
dsh web

Then open Settings → 定时任务 (Scheduled Tasks).

Local checkout (development)

git clone https://github.com/Sev7een/dsh-plugin-automations.git
dsh plugin --profile web add ./dsh-plugin-automations

Remove

dsh plugin --profile web remove dsh-plugin-automations

Usage

Execution modes

Mode	Behavior
`on_time`	Creates an isolated DSH Session and starts as soon as the task is due.
`when_idle`	Runs only outside Beijing peak hours; a task due during peak hours waits for the next valley window.

Schedule types

Schedule	Behavior
`once`	Reaches a terminal state and does not run again.
`cron`	After each terminal occurrence, computes the next matching occurrence. A failed occurrence is not retried.

HTTP API

POST /dsh-scheduled-tasks/api/v1/tasks
Content-Type: application/json
X-DSH-Scheduled-Tasks: 1
Body: { prompt, schedule, mode, sessionTitleTemplate? }
GET /dsh-scheduled-tasks/api/v1/tasks

curl -X POST http://127.0.0.1:3080/dsh-scheduled-tasks/api/v1/tasks \
  -H 'Content-Type: application/json' \
  -H 'X-DSH-Scheduled-Tasks: 1' \
  -d '{
    "prompt": "check project tests",
    "schedule": { "type": "cron", "expression": "0 0 8 * * *" },
    "mode": "on_time",
    "sessionTitleTemplate": "Daily Feed · {{scheduledAt:YYYY-MM-DD}}"
  }'

The MVP has no edit, delete, pause, cancel, retry, or pagination endpoints.

Development

npm install --legacy-peer-deps
npm run check
npm test
npm run build
npm pack --dry-run

--legacy-peer-deps is currently needed for local development because the published @deepseek-ai/dsh-storage-domain package still carries an older peer range than the current DSH Web bundle.

License

MIT

dsh-plugin-automations

项目介绍

项目信息与收录信号

数据评分

安装与使用

项目截图

仓库 README