English | 中文
dsh-auto-scheduler
A DeepSeek Harness (DSH) plugin for timed autonomous work: fill in a goal and a time window in the sidebar panel, and DSH automatically creates a session and starts working at the start time, then interrupts the agent and stops the session at the stop time (the session stays in the list for review).
Features
- Host-side scheduler: timers live inside the dsh web host process, so they fire even when no browser tab is open (the dsh web process itself must be running; missed windows are skipped).
- Auto start / auto stop: creates a Web GUI session and sends the task at the start time; cancels the active turn and stops the session at the stop time.
- Two modes:
default: the agent may ask the user; every other setting keeps deployment defaults.silent: never asks the user (ask_user_question tool disabled + silent persona), danger-full-access permissions, keeps working until the task is done (still stopped externally at the stop time).
- ds valley/peak presets: one-click quick fill for Beijing time 12:00-14:00 and 18:00-09:00 (UTC+8).
- Timezone handling: the panel displays/edits in your system timezone and converts to UTC for storage; valley presets are converted to your local timezone for display.
- Repeat: once / daily.
Install
Manual (recommended)
dsh plugin --profile web add github:Cheng-xiu/dsh-auto-scheduler#v0.1.4
This is the only command needed; dsh plugin add registers the plugin bundle automatically.
One-click script (Windows)
Download the installer and run it (or clone the repo and run install.cmd):
curl -o install.cmd https://raw.githubusercontent.com/Cheng-xiu/dsh-auto-scheduler/v0.1.4/install.cmd
install.cmd :: optional: install.cmd <profile>, default profile is web
One-click script (macOS / Linux)
curl -o install.sh https://raw.githubusercontent.com/Cheng-xiu/dsh-auto-scheduler/v0.1.4/install.sh
chmod +x install.sh && ./install.sh # optional: ./install.sh <profile>
Restart dsh web afterwards. The "Auto Work" (自动工作) entry then appears in the sidebar.
Usage
- Open the "Auto Work" sidebar panel.
- Fill in the goal, mode (default/silent), start/stop times, and repeat — or click a valley-period preset.
- Save. When the time arrives, DSH creates a session and sends the task; the panel shows live status and the next-run countdown.
- "Run now" triggers a run immediately (stop time = now + original duration).
Data & security
- Schedules persist host-side in
DSH_HOME/dsh-auto-scheduler.json (default ~/.dsh/dsh-auto-scheduler.json).
- Panel APIs accept only loopback requests or hosts granted via
--trusted-host; anything else gets 403.
- Silent mode means unattended full-permission execution — use it only for tasks you trust.
How it works
- The host ticks every 20 seconds and drives sessions through the exact same path the Web GUI uses (
apiProxy.sessions.create/prompt/cancel).
- Silent mode uses the bundled agent preset
dsh-auto-scheduler-silent (a fork of the standard preset with a silent persona and the question tool disabled), synced to ~/.dsh/.agent-presets/ at startup.
- Sessions are titled "[Auto] " so they are easy to find in the session list.
Troubleshooting
- No sidebar entry after restart: run
dsh --profile web --dump-config | findstr auto-scheduler; if the row is missing, re-run the install command. Client panels are injected at boot — a restart is mandatory after install/upgrade.
- pnpm store or allowBuilds error: this package has no build scripts and no dependencies; follow the pnpm hint printed by
dsh plugin add (e.g. add the printed key to allowBuilds in the profile's pnpm-workspace.yaml) and re-run.
- Missed schedule: the dsh web process must be running at the scheduled time; missed windows are skipped by design.
License
MIT
