Sev7een/dsh-plugin-automations

English | 简体中文

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