worktreelisted

# Git Worktree 创建 创建独立的 worktree 用于并行开发，避免污染主工作目录。 ## 使用流程 ### 1. 确认参数 需要以下信息： - **分支名称**: 新功能/修复的分支名（如 `feature/add-login`, `fix/user-auth`） - **基础分支**: 从哪个分支创建（默认 `main`） - **worktree 目录**: 统一放在 `../AgentsMesh-Worktrees/<branch-name>` ### 2. 创建 Worktree ```bash # 1. 获取最新代码 git fetch origin # 2. 创建 worktrees 目录（如不存在） mkdir -p ../AgentsMesh-Worktrees # 3. 创建 worktree 和新分支 # 分支名中的 / 替换为 - 作为目录名 git worktree add -b <branch-name> ../AgentsMesh-Worktrees/<dir-name> origin/<base-branch> # 4. 进入 worktree 目录 cd ../AgentsMesh-Worktrees/<dir-name> # 5. 验证状态 git status git log --oneline -3 ``` ### 3. 初始化开发环境 [必须执行] > **⚠️ 重要**：此步骤为**必须执行**，不可跳过或询问用户是否执行。 > Worktree 创建后必须立即初始化开发环境，确保环境可用。 ```bash # 进入 deploy/dev 目录 cd deploy/dev # 一键启动完整开发环境 ./dev.sh ``` 脚本会自动： - 根据 worktree/分支名生成隔离的 `.env` 配置（端口自动偏移，避免冲突） - 启动 Docker 后端服务（PostgreSQL、Redis、MinIO、Backend、Nginx、Runner） - 执行数据库迁移和初始化测试账号 seed 数据 - 启动本地前端（Next.js + Turbopack，性能更好） ### 4. 完成后输出 创建完成后，告知用户： ``` 已创建 worktree: - 路径: /Users/xxx/Works/AIO/AgentsMesh-Worktrees/feature-user-auth - 分支: feature/user-auth (基于 origin/main) 开发环境: - 前端: http://localhost:3000 - API: http://localhost:<port>/api - 测试账号: dev@agentsmesh.local / devpass123 - Adminer: http://localhost:<adminer-port> - MinIO: http://localhost:<minio-port> 常用命令: - 前端日志: tail -f deploy/dev/web.log - 后端日志: cd deploy/dev && docker compose logs -f backend - 停止环境: cd deploy/dev && ./dev.sh --clean 完成开发后: - 提交代码: git add . && git commit -m "..." - 推送分支: git push -