#!/usr/bin/env bash # ============================================================ # Nex Animation Studio · 一键启停(单机开发模式:SQLite + 进程内调度) # # ./scripts/dev.sh 启动前后端 # ./scripts/dev.sh stop 停止 # ./scripts/dev.sh restart 重启 # ./scripts/dev.sh status 端口 / 健康 / 当前模型 / ComfyUI 连通性 # ./scripts/dev.sh logs 同时跟踪前后端日志 # ./scripts/dev.sh logs backend 只看后端日志 # ./scripts/dev.sh start --reload 后端热重载 # # 选项:--backend-only --frontend-only --reload --no-install # --backend-port N --frontend-port N --host ADDR(默认 0.0.0.0,局域网可直接访问) # # 手工启动反复踩到的四个坑,本脚本已逐一处理: # 1) 后端必须在能读到仓库根 .env 的位置启动。.env 里配了 COMFYUI_BASE_URL 却被静默忽略时, # 平台照旧跑 mock 且不报错——这里统一用 --app-dir 从仓库根启动,路径永远唯一。 # 2) 后台进程必须自成会话,否则启动它的终端一退出就把 uvicorn/vite 一起带走(macOS 无 setsid, # 改用 python start_new_session)。 # 3) vite 端口被占会静默换端口,前端代理与 e2e 自检随之失效——这里用 --strictPort 直接报错。 # 4) 相对 media / SQLite 路径会随启动目录漂移,导致已生成的镜头在新进程里全部 404。 # ============================================================ set -euo pipefail ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" RUN_DIR="$ROOT/.local/run" LOG_DIR="$ROOT/.local/logs" PYBIN="$ROOT/.venv/bin/python" # 监听地址:默认 0.0.0.0 —— 同一网段的手机/其他设备可直接访问; # 早先默认 127.0.0.1 时,`npm run dev` 里已有的 --host 0.0.0.0 会被本脚本追加的 # --host 覆盖,前后端只绑回环,局域网访问必然连不上。 HOST="${NEX_HOST:-0.0.0.0}" # 自检 / Vite 代理用的地址:绑 0.0.0.0 时不能拿 0.0.0.0 去 curl,回退到回环。 case "$HOST" in 0.0.0.0|""|::|\[::\]) PROBE_HOST=127.0.0.1 ;; *) PROBE_HOST="$HOST" ;; esac # 本机局域网 IP(macOS:默认路由网卡 → ipconfig getifaddr),取不到就只打印回环地址。 LAN_IP="$( { iface="$(route -n get default 2>/dev/null | awk '/^[[:space:]]*interface:/{print $2; exit}')" [ -n "$iface" ] && ipconfig getifaddr "$iface" 2>/dev/null; } || true )" BACKEND_PORT="${BACKEND_PORT:-8000}" FRONTEND_PORT="${FRONTEND_PORT:-5173}" RELOAD=0 AUTO_INSTALL=1 WANT_BACKEND=1 WANT_FRONTEND=1 if [ -t 1 ]; then C_G=$'\033[32m'; C_Y=$'\033[33m'; C_R=$'\033[31m'; C_B=$'\033[36m'; C_D=$'\033[2m'; C_0=$'\033[0m' else C_G=""; C_Y=""; C_R=""; C_B=""; C_D=""; C_0=""; fi ok() { printf ' %sok%s %s\n' "$C_G" "$C_0" "$*"; } info() { printf ' %s\n' "$*"; } warn() { printf ' %s!%s %s\n' "$C_Y" "$C_0" "$*"; } die() { printf ' %sXX%s %s\n' "$C_R" "$C_0" "$*" >&2; exit 1; } head2() { printf '\n%s%s%s\n' "$C_B" "$*" "$C_0"; } # ------------------------------------------------------------------ 基础工具 port_pids() { # 谁在监听这个端口(可能为空) lsof -nP -iTCP:"$1" -sTCP:LISTEN -t 2>/dev/null | tr '\n' ' ' | sed 's/[[:space:]]*$//' || true } pid_of() { [ -f "$RUN_DIR/$1.pid" ] && cat "$RUN_DIR/$1.pid" 2>/dev/null || true; } alive() { local p="${1:-}"; [ -n "$p" ] && kill -0 "$p" 2>/dev/null; } # 在独立会话里拉起进程:stdout/stderr 落日志,返回 pid。 # 不能只写 `cmd &`——脚本一退出,整个进程组会被一起回收。 spawn() { # spawn local name="$1" cwd="$2"; shift 2 mkdir -p "$RUN_DIR" "$LOG_DIR" local pid pid="$("$PYBIN" - "$LOG_DIR/$name.log" "$cwd" "$@" <<'PY' import subprocess, sys log_path, cwd, cmd = sys.argv[1], sys.argv[2], sys.argv[3:] log = open(log_path, "ab", buffering=0) p = subprocess.Popen(cmd, stdin=subprocess.DEVNULL, stdout=log, stderr=log, cwd=cwd, start_new_session=True, close_fds=True) print(p.pid) PY )" printf '%s\n' "$pid" > "$RUN_DIR/$name.pid" printf '%s\n' "$pid" } wait_http() { # wait_http <超时秒> local url="$1" limit="${2:-90}" i=0 while [ "$i" -lt "$limit" ]; do if curl -fsS --max-time 2 -o /dev/null "$url" 2>/dev/null; then return 0; fi sleep 1; i=$((i + 1)) done return 1 } env_value() { # 从 .env 读一个键(最后一行为准,去引号) [ -f "$ROOT/.env" ] || return 0 sed -n "s/^[[:space:]]*$1=//p" "$ROOT/.env" | tail -1 | tr -d '\r"' || true } # ------------------------------------------------------------------ 依赖自检 prepare() { head2 "环境自检" command -v curl >/dev/null || die "缺少 curl" # .env:缺失就从模板复制,避免第一次跑的人对着 404 猜半天 if [ ! -f "$ROOT/.env" ]; then if [ -f "$ROOT/.env.example" ]; then cp "$ROOT/.env.example" "$ROOT/.env" warn "已从 .env.example 生成 .env(默认走 mock 适配器);要连真实模型请填 COMFYUI_BASE_URL" else die "缺少 .env 且没有 .env.example" fi else ok ".env 就绪" fi # 后端虚拟环境 if [ ! -x "$PYBIN" ]; then [ "$AUTO_INSTALL" = 1 ] || die "缺少 .venv(加 --no-install 时不会自动创建):python3 -m venv .venv && .venv/bin/pip install -r backend/requirements.txt" info "创建虚拟环境并安装后端依赖(首次约 1~2 分钟)…" command -v python3 >/dev/null || die "缺少 python3" python3 -m venv "$ROOT/.venv" || die "venv 创建失败" "$PYBIN" -m pip install -q --upgrade pip "$PYBIN" -m pip install -q -r "$ROOT/backend/requirements.txt" || die "后端依赖安装失败" ok "后端依赖已安装" elif ! "$PYBIN" -c "import uvicorn, fastapi" 2>/dev/null; then [ "$AUTO_INSTALL" = 1 ] || die "后端依赖不完整(缺 uvicorn/fastapi),且指定了 --no-install" info "补齐后端依赖…" "$PYBIN" -m pip install -q -r "$ROOT/backend/requirements.txt" || die "后端依赖安装失败" ok "后端依赖已补齐" else ok "后端依赖就绪($("$PYBIN" -V 2>&1))" fi # 前端依赖(--backend-only 时跳过:新机器上能省掉一次 npm install) if [ "$WANT_FRONTEND" != 1 ]; then info "${C_D}跳过前端依赖检查(--backend-only)${C_0}" elif [ ! -d "$ROOT/frontend/node_modules" ]; then command -v npm >/dev/null || die "缺少 npm(前端需要)" [ "$AUTO_INSTALL" = 1 ] || die "缺少 frontend/node_modules,且指定了 --no-install:cd frontend && npm install" info "安装前端依赖…" (cd "$ROOT/frontend" && npm install --no-audit --no-fund) > "$LOG_DIR/npm-install.log" 2>&1 \ || die "npm install 失败,详见 .local/logs/npm-install.log" ok "前端依赖已安装" else ok "前端依赖就绪" fi # ffmpeg 只影响质检/合成,缺失不挡启动,但要说清楚 if command -v ffmpeg >/dev/null && command -v ffprobe >/dev/null; then ok "ffmpeg 就绪" else warn "未找到 ffmpeg/ffprobe:质检与合成导出会不可用(brew install ffmpeg)" fi } # ------------------------------------------------------------------ 启动 start_backend() { head2 "后端 FastAPI :$BACKEND_PORT" local existing busy existing="$(pid_of backend)" if alive "$existing"; then ok "已在运行 pid=${existing}(跳过启动)" return 0 fi busy="$(port_pids "$BACKEND_PORT")" [ -z "$busy" ] || die "端口 $BACKEND_PORT 被进程 $busy 占用;先 ./scripts/dev.sh stop 或用 --backend-port 换端口" local pid # 从仓库根启动 + --app-dir 指向 backend/:.env、media、SQLite 相对路径都锚定仓库根, # 换目录启动不会再出现「两拨 media」「找不到已生成镜头」。 local cmd=("$PYBIN" -m uvicorn app.main:app --app-dir "$ROOT/backend" --host "$HOST" --port "$BACKEND_PORT") [ "$RELOAD" = 1 ] && cmd+=(--reload) pid="$(spawn backend "$ROOT" "${cmd[@]}")" if wait_http "http://$PROBE_HOST:$BACKEND_PORT/health" 90; then ok "健康检查通过 pid=$pid" else warn "90s 内 /health 未就绪,最后 30 行日志:" tail -30 "$LOG_DIR/backend.log" 2>/dev/null || true die "后端启动失败" fi } start_frontend() { head2 "前端 Vite :$FRONTEND_PORT" local existing busy existing="$(pid_of frontend)" if alive "$existing"; then ok "已在运行 pid=${existing}(跳过启动)" return 0 fi busy="$(port_pids "$FRONTEND_PORT")" [ -z "$busy" ] || die "端口 $FRONTEND_PORT 被进程 $busy 占用;先 ./scripts/dev.sh stop 或用 --frontend-port 换端口" # 代理目标跟着后端端口走(vite.config.ts 读 NEX_BACKEND); # --strictPort 让端口冲突直接失败,而不是悄悄换一个端口让自检脚本打空。 export NEX_BACKEND="http://$PROBE_HOST:$BACKEND_PORT" local pid pid="$(spawn frontend "$ROOT/frontend" npm run dev -- --host "$HOST" --port "$FRONTEND_PORT" --strictPort)" if wait_http "http://$PROBE_HOST:$FRONTEND_PORT/" 60; then ok "开发服务器就绪 pid=$pid" else warn "60s 内前端未就绪,最后 30 行日志:" tail -30 "$LOG_DIR/frontend.log" 2>/dev/null || true die "前端启动失败" fi } report() { head2 "已启动" [ "$WANT_FRONTEND" = 1 ] && info "${C_B}界面${C_0} http://$PROBE_HOST:$FRONTEND_PORT ${C_D}(Vite → 代理 /api、/media 到后端)${C_0}" [ "$WANT_BACKEND" = 1 ] && info "${C_B}接口${C_0} http://$PROBE_HOST:$BACKEND_PORT/docs" if [ -n "$LAN_IP" ] && [ "$PROBE_HOST" = "127.0.0.1" ]; then [ "$WANT_FRONTEND" = 1 ] && info "${C_B}局域网${C_0} http://$LAN_IP:$FRONTEND_PORT ${C_D}(同网段设备可直接打开)${C_0}" [ "$WANT_BACKEND" = 1 ] && info "${C_B}局域网${C_0} http://$LAN_IP:$BACKEND_PORT/docs" fi info "${C_B}日志${C_0} .local/logs/backend.log .local/logs/frontend.log ${C_D}跟踪:./scripts/dev.sh logs${C_0}" info "${C_B}停止${C_0} ./scripts/dev.sh stop" local model model="$(env_value VIDEO_MODEL)" info "${C_B}模型${C_0} $(env_value VIDEO_PROVIDER)/${model}${C_D}(.env 改完重启生效;页面「模型管理中心」也可切换)${C_0}" status_runtime } # ------------------------------------------------------------------ 运行状态 status_runtime() { head2 "运行状态" local row name port pid p http for row in "backend:$BACKEND_PORT" "frontend:$FRONTEND_PORT"; do name="${row%%:*}"; port="${row##*:}" pid="$(pid_of "$name")" if alive "$pid"; then printf ' %srunning%s %-9s :%-6s pid=%s\n' "$C_G" "$C_0" "$name" "$port" "$pid" elif [ -n "$(port_pids "$port")" ]; then printf ' %sbusy%s %-9s :%-6s 被本脚本之外的进程占用 (pid=%s)\n' \ "$C_Y" "$C_0" "$name" "$port" "$(port_pids "$port")" else printf ' %sstopped%s %-9s :%s\n' "$C_D" "$C_0" "$name" "$port" fi done # 后端细节:执行后端 / 当前默认模型 / ComfyUI 连通性——这三项决定「是不是真在跑真实模型」 if curl -fsS --max-time 3 -o /dev/null "http://$PROBE_HOST:$BACKEND_PORT/health" 2>/dev/null; then "$PYBIN" - "$PROBE_HOST" "$BACKEND_PORT" <<'PY' || true import json, sys, urllib.request host, port = sys.argv[1], sys.argv[2] base = f"http://{host}:{port}" def get(path): with urllib.request.urlopen(base + path, timeout=8) as r: return json.loads(r.read().decode()) try: h = get("/health") caps = h.get("ffmpeg_capabilities") or {} print(f" executor={h.get('executor')} database={h.get('database')} " f"ffmpeg={h.get('ffmpeg')} xfade={caps.get('xfade')} model_specs={h.get('model_specs')}") except Exception as exc: print(f" 健康检查失败:{type(exc).__name__}: {exc}") raise SystemExit(0) try: specs = get("/api/providers")["providers"] for p in specs: if p.get("media_type") != "video": continue flag = "默认" if p.get("is_default") else " " print(f" [{flag}] {p['provider']}/{p['model']} adapter={p['adapter']} " f"时长 {p['min_duration']}-{p['max_duration']}s 可用={p.get('available')}") except Exception as exc: print(f" 模型注册表读取失败:{type(exc).__name__}: {exc}") PY fi local comfy; comfy="$(env_value COMFYUI_BASE_URL)" if [ -n "$comfy" ]; then if curl -fsS --max-time 4 -o /dev/null "$comfy/system_stats" 2>/dev/null; then printf ' %sreachable%s ComfyUI %s\n' "$C_G" "$C_0" "$comfy" else printf ' %sunreachable%s ComfyUI %s %s真实出图会失败,只有 mock 可用%s\n' \ "$C_Y" "$C_0" "$comfy" "$C_D" "$C_0" fi fi } # ------------------------------------------------------------------ 停止 stop_one() { local name="$1" pid pid="$(pid_of "$name")" if ! alive "$pid"; then rm -f "$RUN_DIR/$name.pid" info "$name 未在运行" return 0 fi # pid 就是会话组长:按进程组回收,npm → vite 这种父子链才不会留下孤儿 vite kill -TERM -- "-$pid" 2>/dev/null || kill -TERM "$pid" 2>/dev/null || true local i=0 while alive "$pid" && [ "$i" -lt 20 ]; do sleep 0.5; i=$((i + 1)); done if alive "$pid"; then kill -KILL -- "-$pid" 2>/dev/null || kill -KILL "$pid" 2>/dev/null || true fi rm -f "$RUN_DIR/$name.pid" ok "$name 已停止(pid=${pid})" } usage() { sed -n '3,22p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//' } # ------------------------------------------------------------------ 入口 # 命令与选项顺序随意:`dev.sh start --reload`、`dev.sh --reload`、`dev.sh --reload start` 都对。 # 早先只认「第一个参数是命令」,`dev.sh --backend-only` 会被当成未知命令直接退出。 ACTION="start" EXTRA=() while [ $# -gt 0 ]; do case "$1" in start|stop|restart|status|logs) ACTION="$1" ;; --backend-only) WANT_FRONTEND=0 ;; --frontend-only) WANT_BACKEND=0 ;; --reload) RELOAD=1 ;; --no-install) AUTO_INSTALL=0 ;; --backend-port) BACKEND_PORT="${2:?--backend-port 需要端口}"; shift ;; --frontend-port) FRONTEND_PORT="${2:?--frontend-port 需要端口}"; shift ;; --host) HOST="${2:?--host 需要地址}"; shift ;; -h|--help) usage; exit 0 ;; --*) die "未知选项:${1}(--help 看用法)" ;; # 只有 logs 需要位置参数(backend / frontend);其余情况的多余参数一律当命令写错了, # 否则 `dev.sh strt` 这种手误会静默变成「启动」,用户还以为命令生效了。 *) EXTRA+=("$1") ;; esac shift done if [ "${#EXTRA[@]}" -gt 0 ] && [ "$ACTION" != "logs" ]; then die "未知命令:${EXTRA[0]}(./scripts/dev.sh --help)" fi do_start() { printf 'Nex Animation Studio · 单机开发模式(cwd=%s)\n' "$ROOT" [ "$WANT_FRONTEND" = 1 ] || [ "$WANT_BACKEND" = 1 ] || die "前后端都被关掉了" prepare [ "$WANT_BACKEND" = 1 ] && start_backend [ "$WANT_FRONTEND" = 1 ] && start_frontend report } case "$ACTION" in start) do_start ;; stop) stop_one frontend; stop_one backend ;; restart) stop_one frontend; stop_one backend; do_start ;; status) status_runtime ;; logs) case "${EXTRA[0]:-}" in backend|frontend) FILES=("$LOG_DIR/${EXTRA[0]}.log") ;; "") FILES=("$LOG_DIR/backend.log" "$LOG_DIR/frontend.log") ;; *) die "logs 只支持 backend / frontend" ;; esac for f in "${FILES[@]}"; do [ -f "$f" ] || : > "$f"; done exec tail -n 60 -F "${FILES[@]}" ;; *) die "未知命令:${ACTION}(./scripts/dev.sh --help)" ;; esac