快速上手
前置条件
- Docker & Docker Compose — 版本 20.10+ 推荐
- AI 模型 API Key — 至少一个供应商（推荐 DeepSeek，性价比高）
- 系统资源 — 最小 2GB RAM，推荐 4GB+
一键部署
1. 下载代码
bash
# GitHub
git clone https://github.com/qingfengljh/vaiteam.git
# Gitee（国内推荐）
# git clone https://gitee.com/qingfengljh/vaiteam.git
cd vaiteam2. 配置环境变量
bash
cp .env.example .env编辑 .env 文件，至少配置以下项：
bash
# 管理员账号（首次登录用）
ADMIN_USER=admin
ADMIN_PASS=your_secure_password
# JWT 密钥（随机生成）
SECRET_KEY=your_random_secret_key_here
# 模型配置（示例：DeepSeek）
DEFAULT_MODEL_PROVIDER=deepseek
DEEPSEEK_API_KEY=sk-your-deepseek-api-key
DEEPSEEK_BASE_URL=https://api.deepseek.com获取 DeepSeek API Key
- 访问 DeepSeek 开放平台
- 注册并实名认证
- 创建 API Key
- 新用户有免费额度，足够体验完整流程
3. 启动服务
bash
docker compose up -d等待镜像拉取和容器启动（首次约 2-3 分钟）。
4. 验证部署
访问 http://localhost:8080，看到登录页面即表示部署成功。
初始配置
登录系统
使用 .env 中配置的管理员账号登录。
首次登录后建议立即修改密码：右上角头像 → 改密码
配置模型供应商
- 进入「模型管理」页面
- 点击「添加供应商」
- 填写信息：
- 名称：DeepSeek
- Base URL：
https://api.deepseek.com - API Key：你的密钥
- 点击「测试连接」，确认返回成功
- 保存配置
分配角色模型
在「模型管理」→「角色配置」中：
- Leader：选择
deepseek-chat（或更强的模型） - Architect：选择
deepseek-chat - Frontend/Backend：选择
deepseek-coder（编码优化） - Tester/DevOps：选择
deepseek-chat
检查 Agent 状态
进入「Agent 管理」，确认：
- 至少有 1 个 Agent 显示「在线」状态
- 心跳时间在 30 秒内
如果 Agent 离线
检查 Docker 容器状态：docker compose ps 查看 Agent 日志：docker compose logs agent
创建第一个项目
- 点击「项目列表」→「新建项目」
- 填写项目信息：
- 项目名称：待办事项管理
- 项目描述：简单的个人任务管理应用
- 项目类型：全栈 Web 应用
- 确认创建
进入项目后，你会看到阶段 0「业务方案」等待开始。
快速体验流程
阶段 0：业务方案（5 分钟）
- 点击「开始阶段 0」
- 在需求描述框输入：
开发一个个人待办事项管理应用，包含： - 添加、编辑、删除待办事项 - 标记完成状态 - 按优先级和截止时间排序 - 简洁的 Web 界面 - 点击「生成业务方案」，等待 AI Leader 分析
- 查看生成的业务方案文档，确认无误后点击「推进到下一阶段」
阶段 1-4：快速推进（10 分钟）
继续推进阶段 1（需求分析）→ 阶段 2（产品原型）→ 阶段 3（技术方案）→ 阶段 4（任务分解）。
每个阶段：
- 点击「开始阶段」
- 等待 AI 生成文档
- 简单审核内容
- 点击「推进到下一阶段」
阶段 5：看 AI 编码（15 分钟）
进入阶段 5 后，任务会自动分配给 Agent 执行：
- 在「任务看板」中观察任务状态变化
- 点击具体任务查看执行进度
- 任务完成后审核代码产出
- 通过审核或提出修改意见
常见问题
Q: 启动后无法访问 8080 端口？ A: 检查端口是否被占用：lsof -i :8080，或修改 docker-compose.yml 中的端口映射。
Q: Agent 一直显示离线？ A: 确认 Docker 网络正常：docker network ls，重启服务：docker compose restart。
Q: 模型调用失败？ A: 检查 API Key 是否正确，网络是否能访问模型服务商。