start.sh

#!/usr/bin/env bash
# kaoyan-engine 一键启动 (Linux/macOS)
# 用法: ./start.sh    （首次自动装依赖，自动打开浏览器）
set -e
cd "$(dirname "$0")"

echo "=============================================="
echo "   kaoyan-engine 一键启动"
echo "   不需要手动装环境，运行本脚本即可"
echo "=============================================="
echo

# 1. 自动探测 Python（项目 venv 优先，其次系统 python3）
PY=""
if [ -x ".venv/bin/python" ]; then PY=".venv/bin/python"
elif command -v python3 >/dev/null 2>&1; then PY="python3"
else
    echo "[错误] 未找到 Python3，请先安装: sudo apt install python3 python3-venv"
    exit 1
fi
echo "[1/3] 已找到 Python: $($PY --version)"

# 2. 检查并自动安装依赖（首次较慢）
echo
echo "[2/3] 检查依赖..."
if ! "$PY" -c "import fastapi, uvicorn, pydantic, pydantic_settings, python_multipart, httpx, fitz, PIL, rapidocr_onnxruntime" >/dev/null 2>&1; then
    echo "      缺少依赖，正在自动安装（首次较慢，请耐心等待）..."
    "$PY" -m pip install -r requirements.txt
    echo "      依赖安装完成。"
else
    echo "      依赖齐全，无需安装。"
fi

# 3. 首次运行生成 .env
if [ ! -f ".env" ]; then
    cp .env.example .env
    echo
    echo "[提示] 已自动生成 .env，填入 KAOYAN_LLM_API_KEY 可调用真实 LLM；"
    echo "      不填也能启动（自动回退 mock 模式）。"
fi

# 4. 端口检查（8000 被占用则换 8001）
PORT="${PORT:-8000}"
if ss -tln 2>/dev/null | grep -q ":$PORT "; then
    echo
    echo "[提示] $PORT 端口被占用，自动改用 8001。"
    PORT=8001
fi

# 5. 启动服务 + 自动打开浏览器
echo
echo "[3/3] 启动服务:  http://127.0.0.1:$PORT"
echo "      按 Ctrl+C 停止服务。"
echo
(sleep 2 && xdg-open "http://127.0.0.1:$PORT" >/dev/null 2>&1) &
exec "$PY" -m uvicorn app.main:app --host 127.0.0.1 --port "$PORT"