| 1 | # 项目初始化 |
| 2 | |
| 3 | 首次下载项目后，需要配置环境并启动前后端服务。 |
| 4 | |
| 5 | ## 使用场景 |
| 6 | |
| 7 | 当用户给出以下指令时使用： |
| 8 | - "初始化项目" |
| 9 | - "配置项目" |
| 10 | - "部署项目" |
| 11 | - "安装项目" |
| 12 | - "开始项目" |
| 13 | - "setup project" |
| 14 | - "deploy" |
| 15 | |
| 16 | ## 前置检查 |
| 17 | |
| 18 | ```bash |
| 19 | # 检查 Python 版本（需要 3.9+） |
| 20 | python3 --version |
| 21 | |
| 22 | # 检查 Node.js 版本（需要 18+） |
| 23 | node --version |
| 24 | |
| 25 | # 检查 npm 版本 |
| 26 | npm --version |
| 27 | ``` |
| 28 | |
| 29 | ## 一键初始化（推荐） |
| 30 | |
| 31 | 从仓库根目录进入 `video-claw/video-claw` 后执行： |
| 32 | |
| 33 | ```bash |
| 34 | # macOS / Linux |
| 35 | cd video-claw/video-claw |
| 36 | chmod +x install.sh |
| 37 | ./install.sh |
| 38 | ``` |
| 39 | |
| 40 | Windows 执行： |
| 41 | |
| 42 | ```bat |
| 43 | cd video-claw\video-claw |
| 44 | install.bat |
| 45 | ``` |
| 46 | |
| 47 | 安装脚本会完成后端依赖、`config.yaml` 初始化、前端依赖安装和前端 build。安装完成后，提醒用户编辑 `video-claw/backend/config.yaml` 填入 API Key，或启动前端后通过侧边栏底部「设置」页面配置。 |
| 48 | |
| 49 | ## 手动初始化步骤 |
| 50 | |
| 51 | ### 步骤1：初始化后端 |
| 52 | |
| 53 | 参考 [init_backend.md](init_backend.md) |
| 54 | |
| 55 | ### 步骤2：初始化前端 |
| 56 | |
| 57 | 参考 [init_frontend.md](init_frontend.md) |
| 58 | |
| 59 | ### 步骤3：验证服务 |
| 60 | |
| 61 | ```bash |
| 62 | # 检查后端运行 |
| 63 | curl http://localhost:8000/api/health |
| 64 | |
| 65 | # 检查前端运行 |
| 66 | curl http://localhost:3000 |
| 67 | ``` |
| 68 | |
| 69 | ## 常见问题 |
| 70 | |
| 71 | | 问题 | 解决方法 | |
| 72 | |------|----------| |
| 73 | | 后端启动失败 | 检查 Python 版本，确保 3.9+，检查 `config.yaml` 配置 | |
| 74 | | 前端 build 失败 | 删除 node_modules 和 .next，重新 `npm install` | |
| 75 | | 端口被占用 | `lsof -ti :8000 | xargs kill` 或 `lsof -ti :3000 | xargs kill` | |
| 76 | | 依赖安装慢 | 使用国内镜像源 | |
| 77 |