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)

Config (override in the profile patch)

- id: farm
  config:
    dataDir: /abs/path   # default $DSH_HOME/storages/dsh-farm
    ringLines: 5000
    stopGraceMs: 3000