fix(dev): prevent duplicate backend launch and forward shutdown signals

2026-10-07 11:01:18 +08:00
parent e50bed9ad8
commit 960af8d40a
3 changed files with 154 additions and 3 deletions
@@ -80,6 +80,8 @@ npm run backend   # Go control-plane，Air 自动重载
 npm run frontend  # Umi Max 前端，支持 HMR
 ```

+`npm run backend` 依赖 Linux 的 `flock`（util-linux），同一工作目录只允许一个后台进程；重复启动会明确报错并退出，重启前请在原终端按 Ctrl+C。不要绕过启动脚本直接运行 Air，以免多个进程同时重编译和启动同一个程序。
+
 `npm run backend` 不会自动启动数据库或 gateway；先启动 `db` 和 `gateway`。`npm run gateway` 直接运行当前用户的 native gateway，不要求安装 systemd 服务。修改 `browser_gateway` 的 Python 文件后，重启该命令。

 服务地址：
@@ -96,6 +98,7 @@ npm run frontend  # Umi Max 前端，支持 HMR
 最小检查：

 ```bash
+node --test scripts/dev-backend.test.mjs
 go test ./...
 go vet ./...
 go build ./cmd/control-plane