chore: split local development services

2026-09-19 12:22:22 +08:00
parent 8d35318c7e
commit 09f3784e73
6 changed files with 72 additions and 59 deletions
@@ -64,16 +64,24 @@ docker compose down
 systemctl --user stop creatorhub-browser-gateway.service
 ```

-## 本地开发（热加载）
+## 本地开发（分开启动）
+
+首次安装前端依赖：

 ```bash
 npm --prefix web ci
-pnpm dev
 ```

- `pnpm dev`：同时运行 Go control-plane 和 Vite HMR；
- `pnpm dev:backend`：启动 PostgreSQL 依赖，检查宿主机 native gateway 后运行 control-plane；
- `pnpm dev:frontend`：单独运行前端。
+分别在四个终端运行：
+
+```bash
+pnpm env       # PostgreSQL 依赖
+pnpm gateway   # native browser gateway
+pnpm backend   # Go control-plane，Air 自动重载
+pnpm frontend  # Vite 前端，支持 HMR
+```
+
+`pnpm backend` 不会自动启动数据库或 gateway；先启动 `env` 和 `gateway`。`pnpm gateway` 直接运行当前用户的 native gateway，不要求安装 systemd 服务。修改 `browser_gateway` 的 Python 文件后，重启该命令；新增或删除前端路由后，重跑 `pnpm --dir web run routes:generate`。

 服务地址：