Introduction¶

When using DeepSeek Harness (DSH) for daily agent development, common needs go beyond manually initiating a conversation: you might want to generate a progress summary at a fixed time every day, or perform routine inspections and generate reports at scheduled times, while also needing to view the system and harness status of the current DSH process.

csiroqa/dsh-schedule is a DSH plugin that combines these two things: automatically triggering Agent tasks according to a cron schedule, and viewing status via the /status command and the dashboard on the settings page.

What This Is¶

csiroqa/dsh-schedule is a scheduled task + status monitoring plugin for DeepSeek Harness (DSH), maintained by csiroqa and licensed under MIT.

It primarily solves two types of problems:

• Automatically trigger Agent tasks according to a cron schedule, such as daily summaries, scheduled inspections, and automatic reports.
• View comprehensive system and harness status via the /status command and the settings page dashboard.

Core Capabilities¶

Scheduled Tasks¶

The plugin supports triggering tasks according to a 5-field cron schedule, with the field order being:

minute hour day month week

For example:

0 9 * * *

means 9:00 AM every day. Triggering is minute-level precise, and the same task does not run concurrently.

When the scheduled time arrives, the plugin will:

• Create a one-time Agent;
• Place the working directory under the corresponding workspace;
• Follow the model selected on the settings page, or as specified by the config;
• Execute the task content;
• Persist session logs to disk;
• Register the execution results back into the task records.

Task records are persisted to:

$DSH_HOME/schedule.json

This file uses atomic writes and is safer on startup.

Task management supports the following commands:

/schedule list
/schedule add
/schedule remove
/schedule pause
/schedule resume
/schedule run

The “Scheduled Tasks” tab on the settings page also provides the same operations.

Single runs have a timeout protection mechanism; by default, tasks are automatically force-stopped after 30 minutes to prevent them from hanging.

Status Monitoring¶

The plugin provides the /status command, which can display:

• Process uptime;
• CPU;
• Memory;
• Disk;
• Active sessions;
• Agents;
• Plugins;
• Models.

The “Status” tab on the settings page provides a real-time dashboard that refreshes every 5 seconds, with the option to pause the refresh, and displays CPU, memory, and disk usage bars.

Installation and Enablement¶

Prerequisites¶

The following requirements must be met before installation:

• Node.js >= 22;
• pnpm;
• A local checkout of the deepseek-harness source code;
• Plugin dependencies pointing to ../deepseek-harness via link:.

Supported platforms: Windows / macOS / Linux (Node >= 22).

Installation Commands¶

First, clone and build the plugin:

git clone https://github.com/csiroqa/dsh-schedule.git
cd dsh-schedule
pnpm install
pnpm build

After the build is complete, install the current directory into the web profile:

# POSIX
dsh plugin --profile web add link:$(pwd)

# Windows
dsh plugin --profile web add link:E:\path\to\dsh-schedule

Restart after installation:

dsh web

Then perform a hard refresh in the browser:

Ctrl+F5

Typical Usage¶

Here are a few common entry points.

Managing Tasks in the Sidebar¶

View tasks:

/schedule list

Add a task that executes at 9 AM daily:

/schedule add 0 9 * * * Summarize yesterday's progress at 9 AM daily

Managing Tasks on the Settings Page¶

Navigate to:

Settings > Plugins > Scheduled Tasks

You can:

• Visually add tasks;
• Run immediately;
• Pause;
• Resume;
• Delete.

Viewing Status¶

View comprehensive status within a session:

/status

View the real-time dashboard on the settings page:

Settings > Plugins > Status

Applicable Scenarios and Considerations¶

Suitable for the following scenarios:

• Need to automatically summarize progress daily;
• Need to perform scheduled inspections or checks;
• Need to automatically generate reports;
• Need to view DSH’s CPU, memory, disk, sessions, Agents, plugins, and model status in one place.

Things to note before use:

• Scheduled tasks will automatically execute unattended at the set time;
• Tasks use the current DSH account’s permissions and can read/write files and execute commands;
• Only add task content you trust;
• The /dsh-schedule/* endpoints only listen on the local machine (DSH defaults to loopback binding); do not expose the DSH port to the public internet;
• The plugin is MIT Licensed; when using, modifying, referencing, or incorporating it, you should retain the LICENSE file and copyright notice, and indicate the source (this repository link);
• Developed and verified against the DSH 0.1.1-rc.2 source checkout, and tested working in the @deepseek-ai/dsh@0.1.1-rc.2 environment;
• Before installing, it is recommended to check whether the source code, license, and dependency references meet your environment requirements.

Links¶

Repository address:

https://github.com/csiroqa/dsh-schedule

The directory page provided by the plugin listing (subject to the actual site):

https://www.skillhub.cn/plugins/csiroqa/dsh-schedule