feat(scripts): 新增本地调试与示例启动脚本，并登记进 apps/README
新增 4 个脚本，统一子命令风格（start/stop/restart/status/logs/run）： - scripts/dev-gateway.sh：方式 B，只起 Gateway(:8001)，用 backend/.venv 虚拟环境， 自动加载 .env、释放端口、等待就绪；带 PID/日志文件，可查状态与跟随日志。 - scripts/dev-full.sh：方式 A，复用 serve.sh 守护模式起全量栈(Gateway+前端+nginx)， 补齐 serve.sh 缺失的 status 与 logs；restart 默认跳过依赖安装，统一入口 :2026。 - apps/examples/http-chat/run.sh：自动探测网关(:2026 优先，回退 :8001)， 优先 uv 临时环境带 requests(--no-project，不污染系统)，无 uv 时回退 venv+pip。 - apps/examples/embedded-chat/run.sh：自动定位 backend、加载 .env 后用 uv run 运行， 内嵌 SDK 模式无需起服务。 apps/README.md 增加「本地调试脚本」与「运行示例」两节，说明上述脚本用法。 全部脚本均已本地实跑验证：全量栈三服务 HTTP 200，两个示例多轮对话正常。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
1445043649
Executable
+151
@@ -0,0 +1,151 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# 本地调试全量栈管理脚本（方式 A：Gateway + Frontend + Nginx）
|
||||
# ------------------------------------------------------------------
|
||||
# 复用仓库已有的 scripts/serve.sh（处理 config-upgrade / postgres extras /
|
||||
# nginx 临时目录 / 依赖同步 / 端口等待），在其守护进程模式之上补齐
|
||||
# status 和 logs，子命令风格与 scripts/dev-gateway.sh 保持一致。
|
||||
#
|
||||
# 服务与端口：
|
||||
# Gateway localhost:8001 (REST API + agent runtime)
|
||||
# Frontend localhost:3000 (Next.js)
|
||||
# Nginx localhost:2026 (统一入口 / 反向代理) ← 浏览器访问这个
|
||||
#
|
||||
# 用法：
|
||||
# ./scripts/dev-full.sh start # 后台启动整套（首次会装依赖）
|
||||
# ./scripts/dev-full.sh stop # 关闭整套
|
||||
# ./scripts/dev-full.sh restart # 重启整套
|
||||
# ./scripts/dev-full.sh status # 三个服务的端口 / 健康检查
|
||||
# ./scripts/dev-full.sh logs [服务] # 跟随日志，默认三个一起；可指定 gateway|frontend|nginx
|
||||
# ./scripts/dev-full.sh run # 前台运行（= make dev，Ctrl-C 全停，gateway 带热重载）
|
||||
#
|
||||
# 环境变量：
|
||||
# SKIP_INSTALL=1 跳过依赖安装，重启更快
|
||||
#
|
||||
set -euo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
|
||||
SERVE="$REPO_ROOT/scripts/serve.sh"
|
||||
|
||||
# 服务清单：名称:端口:日志文件:健康检查路径（空=只查端口）
|
||||
SERVICES=(
|
||||
"Gateway:8001:gateway.log:/api/v1/auth/setup-status"
|
||||
"Frontend:3000:frontend.log:/"
|
||||
"Nginx:2026:nginx.log:/"
|
||||
)
|
||||
|
||||
# ── 工具函数 ──────────────────────────────────────────────────────
|
||||
_port_pid() { { lsof -ti tcp:"$1" 2>/dev/null || true; } | head -1; }
|
||||
|
||||
_any_running() {
|
||||
for svc in "${SERVICES[@]}"; do
|
||||
local port="${svc#*:}"; port="${port%%:*}"
|
||||
[ -n "$(_port_pid "$port")" ] && return 0
|
||||
done
|
||||
return 1
|
||||
}
|
||||
|
||||
_serve_flags() {
|
||||
# serve.sh 守护模式启动；可选跳过依赖安装
|
||||
local flags="--dev --daemon"
|
||||
[ "${SKIP_INSTALL:-0}" = "1" ] && flags="$flags --skip-install"
|
||||
echo "$flags"
|
||||
}
|
||||
|
||||
# ── 子命令 ────────────────────────────────────────────────────────
|
||||
cmd_start() {
|
||||
if _any_running; then
|
||||
echo "检测到已有服务在运行 —— 如需重启用：$0 restart"
|
||||
cmd_status || true
|
||||
return 0
|
||||
fi
|
||||
echo "→ 后台启动全量栈（serve.sh $(_serve_flags)）"
|
||||
[ "${SKIP_INSTALL:-0}" = "1" ] || echo " 首次启动会执行 uv sync + pnpm install，可能较慢；重启可加 SKIP_INSTALL=1"
|
||||
# shellcheck disable=SC2046
|
||||
bash "$SERVE" $(_serve_flags)
|
||||
echo
|
||||
cmd_status || true
|
||||
}
|
||||
|
||||
cmd_stop() {
|
||||
if ! _any_running; then
|
||||
echo "未在运行"
|
||||
return 0
|
||||
fi
|
||||
echo "→ 关闭全量栈（serve.sh --stop）"
|
||||
bash "$SERVE" --stop
|
||||
}
|
||||
|
||||
cmd_status() {
|
||||
local all_up=0
|
||||
printf "%-10s %-7s %-9s %s\n" "服务" "端口" "状态" "健康"
|
||||
printf "%-10s %-7s %-9s %s\n" "----" "----" "----" "----"
|
||||
for svc in "${SERVICES[@]}"; do
|
||||
local name port log path rest
|
||||
name="${svc%%:*}"; rest="${svc#*:}"
|
||||
port="${rest%%:*}"; rest="${rest#*:}"
|
||||
log="${rest%%:*}"; path="${rest#*:}"
|
||||
local pid; pid="$(_port_pid "$port")"
|
||||
if [ -z "$pid" ]; then
|
||||
printf "%-10s %-7s %-9s %s\n" "$name" "$port" "✗ 停止" "-"
|
||||
all_up=1
|
||||
else
|
||||
local code="-"
|
||||
if [ -n "$path" ]; then
|
||||
code="$(curl -s -o /dev/null -w "%{http_code}" "http://localhost:$port$path" 2>/dev/null || echo 000)"
|
||||
case "$code" in 200|429|301|302|307) code="✓ HTTP $code";; 000) code="⚠ 无响应";; *) code="⚠ HTTP $code";; esac
|
||||
fi
|
||||
printf "%-10s %-7s %-9s %s\n" "$name" "$port" "● 运行 ($pid)" "$code"
|
||||
fi
|
||||
done
|
||||
if [ "$all_up" = "0" ]; then
|
||||
echo
|
||||
echo " 🌐 统一入口: http://localhost:2026"
|
||||
fi
|
||||
return "$all_up"
|
||||
}
|
||||
|
||||
cmd_logs() {
|
||||
local target="${1:-}"
|
||||
cd "$REPO_ROOT"
|
||||
local files=()
|
||||
if [ -n "$target" ]; then
|
||||
local f="logs/${target}.log"
|
||||
[ -f "$f" ] || { echo "暂无日志：$f（可选 gateway|frontend|nginx）" >&2; return 1; }
|
||||
files=("$f")
|
||||
else
|
||||
for svc in "${SERVICES[@]}"; do
|
||||
local log; log="${svc#*:}"; log="${log#*:}"; log="${log%%:*}"
|
||||
[ -f "logs/$log" ] && files+=("logs/$log")
|
||||
done
|
||||
[ ${#files[@]} -gt 0 ] || { echo "暂无日志文件（logs/ 为空）" >&2; return 1; }
|
||||
fi
|
||||
echo "→ 跟随日志（Ctrl-C 退出，不影响服务）：${files[*]}"
|
||||
tail -n 30 -f "${files[@]}"
|
||||
}
|
||||
|
||||
cmd_run() {
|
||||
if _any_running; then
|
||||
echo "已有后台实例在运行，先 $0 stop" >&2
|
||||
exit 1
|
||||
fi
|
||||
echo "→ 前台运行全量栈（= make dev，Ctrl-C 全停）"
|
||||
exec bash "$SERVE" --dev
|
||||
}
|
||||
|
||||
# ── 分发 ──────────────────────────────────────────────────────────
|
||||
case "${1:-status}" in
|
||||
start) cmd_start ;;
|
||||
stop) cmd_stop ;;
|
||||
restart) cmd_stop; echo; SKIP_INSTALL="${SKIP_INSTALL:-1}" cmd_start ;;
|
||||
status|"") cmd_status ;;
|
||||
logs) shift || true; cmd_logs "${1:-}" ;;
|
||||
run) cmd_run ;;
|
||||
-h|--help|help)
|
||||
sed -n '2,33p' "$0" | sed 's/^# \{0,1\}//' ;;
|
||||
*)
|
||||
echo "未知命令: $1" >&2
|
||||
echo "可用: start | stop | restart | status | logs [服务] | run" >&2
|
||||
exit 1 ;;
|
||||
esac
|
||||
Reference in New Issue
Block a user