nex_animation/scripts/dev.sh

366 lines
16 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

#!/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 <name> <cwd> <cmd...>
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 <url> <超时秒>
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