dsh-farm
DSH 服务农场：注册、启动、停止、重启和监视长期运行的项目服务。左侧边栏入口 + 概览抽屉（按工作区分组、实时日志跟踪、搜索、导出）；为代理提供 farm_status/start/stop/restart/logs/register 工具；每个工作区可选择使用 farm.yaml 声明。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-farm@0.1.0Farm 以 dsh-farm 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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.
dsh plugin --profile <name> add /path/to/dsh-farm
Restart the DSH web surface afterwards.
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.
/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).autoRestart retries an abnormal exit up to 5 times with exponential
backoff (1s → 16s).$DSH_HOME/storages/dsh-farm/logs/<id>.log./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 |
- id: farm
config:
dataDir: /abs/path # default $DSH_HOME/storages/dsh-farm
ringLines: 5000
stopGraceMs: 3000