143 lines
5.4 KiB
Bash
Executable File
143 lines
5.4 KiB
Bash
Executable File
#!/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 <<EOF
|
||
用法:scripts/dev.sh [--seed] [--reload]
|
||
|
||
hub http://127.0.0.1:${hub_port}(API 文档 /docs)
|
||
console http://127.0.0.1:${console_port}
|
||
|
||
--seed 启动前灌一份演示 Agent / 团队
|
||
--reload 后端带 --reload(改 Python 代码自动重启)
|
||
HUB_PORT / CONSOLE_PORT 换端口,默认 8100 / 3100
|
||
EOF
|
||
}
|
||
|
||
log() { printf '\033[36m[dev]\033[0m %s\n' "$*"; }
|
||
die() { printf '\033[31m[dev]\033[0m %s\n' "$*" >&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 已退出,日志见上方"
|