#!/usr/bin/env bash # 一键起本地开发环境:AgentHub hub(FastAPI)+ 控制台(Next.js)。 # # ./scripts/dev.sh 缺依赖时自动补装(backend venv、pnpm install) # ./scripts/dev.sh --seed 顺便灌一份演示 Agent / 团队,控制台立刻有东西看 # ./scripts/dev.sh --reload 后端带 --reload,改 Python 代码自动重启 # # Ctrl-C 一起停掉两个进程;端口已被占用时会拒绝启动,不会抢别人正在跑的实例。 # 容器版不在这儿:deploy/docker-compose.yml。 set -euo pipefail here="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" root="$(cd "${here}/.." && pwd)" backend="${root}/backend" frontend="${root}/frontend" venv="${backend}/.venv" hub_port="${HUB_PORT:-8100}" console_port="${CONSOLE_PORT:-3100}" usage() { cat <&2; exit 1; } seed=0 reload="" for arg in "$@"; do case "$arg" in --seed) seed=1 ;; --reload) reload="--reload" ;; -h | --help) usage exit 0 ;; *) echo "未知参数:$arg" >&2 usage >&2 exit 2 ;; esac done # --- 前置检查 --------------------------------------------------------------- command -v node >/dev/null 2>&1 || die "需要 Node 20+(控制台)" command -v pnpm >/dev/null 2>&1 || die "需要 pnpm:npm i -g pnpm 或 corepack enable" command -v lsof >/dev/null 2>&1 || die "需要 lsof 检查端口占用" # 端口被占时把「谁占的、为什么杀不掉」说清楚:被 launchd 托管的进程 kill -9 也会被立刻拉起 port_guard() { local port="$1" pids pid pids="$(lsof -nP -iTCP:"$port" -sTCP:LISTEN -t 2>/dev/null)" || return 0 [ -n "$pids" ] || return 0 for pid in $pids; do log "端口 ${port} 被 PID ${pid} 占用:$(ps -o command= -p "$pid" | cut -c1-88)" done # 再确认是谁在拉它:launchd 任务里的 PID 能对上,就说明 kill -9 也会被重新拉起 for pid in $pids; do label="$(launchctl list 2>/dev/null | awk -v p="$pid" '$1 == p {print $3; exit}')" [ -n "$label" ] || continue die "PID ${pid} 是 launchd 任务 ${label} 看护的:kill -9 也会被立刻重新拉起。 注销任务才会真停:launchctl bootout gui/$(id -u)/${label} 或换一对端口:HUB_PORT=8200 CONSOLE_PORT=3200 $0" done die "先停掉上面这些进程,或换一对端口:HUB_PORT=8200 CONSOLE_PORT=3200 $0" } for p in "$hub_port" "$console_port"; do port_guard "$p"; done # --- 后端:venv + 依赖 + 建表/凭证 ----------------------------------------- if [ ! -x "${venv}/bin/agenthub" ]; then py="" for cand in python3.13 python3.12 python3.11 python3; do command -v "$cand" >/dev/null 2>&1 || continue "$cand" -c 'import sys; sys.exit(0 if sys.version_info >= (3, 11) else 1)' && py="$cand" && break done [ -n "$py" ] || die "需要 Python 3.11+ 建 backend/.venv" log "创建 backend/.venv(${py})" "$py" -m venv "$venv" fi if [ ! -x "${venv}/bin/agenthub" ]; then log "安装后端依赖(pip install -e backend)" "${venv}/bin/python" -m pip install --quiet --upgrade pip >/dev/null "${venv}/bin/python" -m pip install --quiet -e "$backend" >/dev/null || die "后端依赖装失败:可在 backend/ 里手动 pip install -e .(国内可加 -i https://pypi.tuna.tsinghua.edu.cn/simple)" fi log "初始化数据库与 hub 凭证" (cd "$backend" && .venv/bin/agenthub init >/dev/null) if [ "$seed" = 1 ]; then log "灌演示数据(agenthub seed)" (cd "$backend" && .venv/bin/agenthub seed >/dev/null) fi # --- 前端依赖 --------------------------------------------------------------- if [ ! -d "${frontend}/node_modules/next" ]; then log "安装前端依赖(pnpm install)" (cd "$frontend" && pnpm install) fi # --- 起两个进程 ------------------------------------------------------------- api_key="$(sed -n 's/.*"api_key"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' \ "${root}/data/hub-credentials.json" 2>/dev/null | head -1)" log "hub → http://127.0.0.1:${hub_port}(API 文档 /docs)" log "console → http://127.0.0.1:${console_port}" [ -n "$api_key" ] && log "控制台 API Key:${api_key}(页面右上角「配置 API KEY」粘贴)" log "Ctrl-C 一起停止" (cd "$backend" && exec .venv/bin/agenthub serve --port "$hub_port" $reload) & hub_pid=$! (cd "$frontend" && exec ./node_modules/.bin/next dev -p "$console_port") & console_pid=$! stop() { trap - EXIT INT TERM # next 由 node 起子进程,先清一层子进程再收父进程,别留孤儿占着端口 for pid in "$console_pid" "$hub_pid"; do pkill -TERM -P "$pid" 2>/dev/null kill -TERM "$pid" 2>/dev/null done wait "$console_pid" "$hub_pid" 2>/dev/null return 0 } trap 'stop; exit 130' INT TERM trap stop EXIT # 任一进程挂了就把另一个也收掉,避免「控制台在跑、hub 已经死了」这种半死状态 while kill -0 "$hub_pid" 2>/dev/null && kill -0 "$console_pid" 2>/dev/null; do sleep 1 done kill -0 "$hub_pid" 2>/dev/null || die "hub 已退出,日志见上方" die "console 已退出,日志见上方"