# 1. 克隆项目（包含 submodules）
git clone --recursive https://github.com/yourusername/ai-flow.git
cd ai-flow

# 或者已克隆项目后，更新 submodules
git submodule update --init --recursive

# 2. 更新所有 submodules 到最新版本
git submodule update --remote --recursive

# 3. 配置环境变量
cp env.example .env
# 编辑 .env 文件，填入 OPENROUTER_API_KEY 等配置

# 使用启动脚本（推荐）
chmod +x run-compose.sh
./run-compose.sh -o 001 -f 001

# 验证服务
curl http://localhost:8000/status

# 使用外部 llms 服务
./run-compose.sh -o 001 -f 001 -l false

# 指定端口
./run-compose.sh -o 001 -f 001 -p 8080

# 详细文档见 DEPLOY.md

# 更新所有 submodules 到最新版本
git submodule update --remote --recursive

# 更新特定 submodule
git submodule update --remote ai-coder

# 更新 submodule 并自动合并本地修改
git submodule update --remote --merge

# 提交 submodule 更新
git add .gitmodules ai-coder llms op-mcp claude-code-router claude-agent-sdk-python
git commit -m "chore: update submodules"

# 初始化并拉取所有缺失的 submodules
git submodule update --init --recursive

# 修复特定缺失的 submodule
git submodule update --init ai-coder

# 完全重新同步 submodules（清理并重新克隆）
git submodule sync --recursive
git submodule update --init --recursive --force

# 检查 submodule 状态
git submodule status

# 1. Submodule 显示为 modified 但没有实际修改
# 重置 submodule 到记录的提交
git submodule update --recursive

# 2. Submodule 版本冲突
# 先更新主项目，再更新 submodules
git pull
git submodule update --init --recursive

# 3. 清理未使用的 submodule
# 先从 .gitmodules 删除相关配置，然后：
git submodule deinit -f <path>
git rm -f <path>
rm -rf .git/modules/<path>

# 添加新的 submodule（会自动更新 .gitmodules 和添加到索引）
git submodule add -b <branch> <repository-url> <path>

# 示例：添加 claude-agent-sdk-python
git submodule add -b main [email protected]:SeSiTing/claude-agent-sdk-python.git claude-agent-sdk-python

git submodule add -b dev [email protected]:daas/op-agent.git op-agent

# 提交新添加的 submodule
git add .gitmodules claude-agent-sdk-python
git commit -m "chore: add claude-agent-sdk-python submodule"

cp env.example .env

# 查看状态
curl http://localhost:8000/status

# API 文档
open http://localhost:8000/docs