dsh-farm 🚜
DSH service farm plugin: register, start, stop, restart and watch long-running
project services — the agent can do it through tools, you can do it through the
web UI.
Install
dsh plugin --profile <name> add /path/to/dsh-farm
Restart the DSH web surface afterwards.
What you get
-
UI: a 🚜 button at the sidebar foot with a running-services badge;
clicking it opens the overview drawer — services grouped by workspace with
status dots, start/stop/restart buttons, and a log view with live follow
(SSE), substring search and download/export.
-
Agent tools: farm_status / farm_start / farm_stop /
farm_restart / farm_logs(service, tail, search) /
farm_register(name, workspace, command, ...). Say "帮我把 dev server
注册到 farm 并启动" in a session and the agent does the rest.
-
farm.yaml (optional, per workspace, commit-friendly):
services:
dev-server:
command: pnpm dev
# cwd: sub/dir # optional, resolved against the workspace
autoRestart: true
env:
PORT: 5173
Declared services appear in the UI and farm_status automatically
(source: yaml); the file is always the source of truth.
Behavior notes
- Services are spawned as children of the DSH process (
/bin/sh -c), so they
are reclaimed when DSH exits. Dynamic registrations persist across restarts
in $DSH_HOME/storages/dsh-farm/services.json (state does not).
- Stop = SIGTERM, then SIGKILL after a 3s grace.
autoRestart retries an abnormal exit up to 5 times with exponential
backoff (1s → 16s).- Logs: 5000-line in-memory ring per service plus an append-only file under
$DSH_HOME/storages/dsh-farm/logs/<id>.log.
HTTP API (localhost only, prefix /farm)
| Route | Meaning |
|---|
GET /farm/services?workspace= | list (farm.yaml entries merged in) |
POST /farm/services | register/update a dynamic service |
GET /farm/services/:id | one service |
DELETE /farm/services/:id | unregister (stops if running) |
POST /farm/services/:id/start|stop|restart | lifecycle |
GET /farm/services/:id/logs?tail=&search=&export=1 | logs, export=1 downloads |
GET /farm/services/:id/logs/stream | SSE live follow |
Config (override in the profile patch)
- id: farm
config:
dataDir: /abs/path # default $DSH_HOME/storages/dsh-farm
ringLines: 5000
stopGraceMs: 3000
