agenthub/scripts/dev.sh

143 lines
5.4 KiB
Bash
Executable File
Raw Permalink 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
# 一键起本地开发环境: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 已退出,日志见上方"