创建第一个项目

本章目标：独立创建项目，熟悉工作区布局，理解项目的基本结构。
预计时长：30 分钟

选择合适的演示项目

为了更好地学习 VAI TEAM，我们需要一个合适的演示项目。推荐特点：

功能边界清晰 — 不要太复杂，也不要太简单
涵盖前后端 — 能体验完整的开发流程
实用性强 — 做完后真的能用

推荐项目：个人待办事项管理

我们将创建一个简单但完整的待办事项管理应用：

核心功能：

添加、编辑、删除待办事项
标记完成状态
设置优先级（高/中/低）
设置截止时间
按状态和优先级筛选

技术栈：

前端：Vue 3 + Element Plus
后端：FastAPI + SQLAlchemy
数据库：SQLite
部署：Docker

这个项目足够展示 VAI TEAM 的完整能力，但又不会过于复杂。

新建项目

进入项目创建页面

点击左侧导航的「项目列表」
如果这是你的第一个项目，会看到空状态页面
点击「新建项目」按钮

填写项目信息

在项目创建表单中填写：

项目名称：个人待办事项管理
项目描述：一个简单实用的个人任务管理应用，支持添加、编辑、删除待办事项，设置优先级和截止时间，按状态筛选查看。
项目类型：全栈 Web 应用

填写技巧：

项目名称 — 简洁明了，避免特殊字符
项目描述 — 详细描述功能需求，这会成为后续 AI 分析的重要输入
项目类型 — 根据实际需求选择，影响后续的技术栈建议

确认创建

点击「确认创建」后，系统会：

初始化项目数据结构
创建 8 个阶段的占位符
分配项目 ID 和工作区
跳转到项目工作区

认识项目工作区

创建成功后，你会进入项目的主工作区。这里是你与 AI 团队协作的主要界面。

1. 项目概览区（顶部）

显示项目的基本信息：

项目名称和描述
当前阶段 — 新项目默认在"阶段 0：业务方案"
进度概况 — 完成的阶段数 / 总阶段数
创建时间 — 项目创建时间
最后更新 — 最近一次操作时间

2. 阶段进度条（中上部）

8 个阶段的可视化进度：

[●] 阶段0  [ ] 阶段1  [ ] 阶段2  [ ] 阶段3
业务方案   需求分析   产品原型   技术方案

[ ] 阶段4  [ ] 阶段5  [ ] 阶段6  [ ] 阶段7  
任务分解   编码实现   集成测试   部署交付

● 表示当前阶段
✓ 表示已完成阶段
[ ] 表示未开始阶段

3. 主工作区（中心）

根据当前阶段显示不同内容：

阶段 0-4：显示阶段文档编辑器

需求输入框
AI 生成的文档内容
审核和推进按钮

阶段 5-7：显示任务看板

待办任务（Todo）
进行中任务（In Progress）
审核中任务（Review）
已完成任务（Done）

4. 侧边栏（右侧）

包含几个重要面板：

文档面板

查看各阶段生成的文档
支持 Markdown 格式
可以编辑和导出

团队面板

显示 AI 角色分配
查看 Agent 状态
模型使用情况

活动面板

项目操作日志
任务状态变更
Git 提交记录

5. 操作区（底部）

根据当前阶段显示相应操作按钮：

开始阶段 — 启动当前阶段的 AI 分析
重新生成 — 如果对结果不满意，重新生成
编辑文档 — 手动修改 AI 生成的内容
推进阶段 — 确认当前阶段完成，进入下一阶段
回退阶段 — 返回上一阶段重新处理

理解项目数据结构

VAI TEAM 中的项目有清晰的层次结构：

📁 项目 (Project)
├── 📋 阶段 0-7 (Stages)
│   ├── 📄 阶段文档 (Stage Documents)
│   └── 📝 阶段配置 (Stage Config)
├── 📋 任务列表 (Tasks) - 从阶段4开始
│   ├── 📄 任务文档 (Task Documents)  
│   ├── 👤 任务分配 (Assignments)
│   └── 📊 执行记录 (Execution Logs)
├── 📁 代码仓库 (Git Repository) - 从阶段5开始
│   ├── 🔀 提交历史 (Commit History)
│   └── 🌿 分支管理 (Branch Management)
└── 💾 项目快照 (Checkpoints)
    ├── 📦 数据备份 (Data Backup)
    └── 📁 代码备份 (Code Backup)

阶段文档

每个阶段会产生特定的文档：

阶段	文档类型	内容示例
0	业务方案	需求概述、目标用户、核心功能
1	需求分析	功能清单、用户故事、验收标准
2	产品原型	页面结构、交互流程、UI 描述
3	技术方案	架构设计、技术选型、接口定义
4	任务分解	可执行任务、依赖关系、工作量估算
5-7	执行记录	代码变更、测试结果、部署日志

任务系统

从阶段 4 开始，项目会产生具体的执行任务：

python

# 任务状态流转
draft → pending → assigned → running → reviewing → done
                                          ↓
                                     failed / blocked

每个任务包含：

任务描述 — 要做什么
输入材料 — 依赖的文档或代码
输出要求 — 期望的产出
分配角色 — Frontend/Backend/Tester 等
执行 Agent — 具体执行的 Agent 实例

项目配置选项

创建项目后，还可以进行一些个性化配置：

技术栈偏好

在项目设置中可以指定：

前端框架：Vue 3 / React / Angular
UI 组件库：Element Plus / Ant Design / Naive UI
后端框架：FastAPI / Flask / Django  
数据库：SQLite / PostgreSQL / MySQL
部署方式：Docker / 传统部署

代码规范

可以设置项目级的代码规范：

代码风格：PEP8 / Google Style / Airbnb
注释语言：中文 / 英文
测试覆盖率：60% / 80% / 90%
Git 提交规范：Conventional Commits

模型配置

可以为当前项目覆盖全局模型配置：

Leader：使用更强的模型（如 GPT-4o）
Architect：使用架构专用模型
其他角色：使用默认配置

项目状态检查

创建项目后，建议检查以下状态：

✅ 项目基础信息

[ ] 项目名称和描述正确
[ ] 当前阶段显示为"阶段 0"
[ ] 进度条正常显示

✅ 工作区布局

[ ] 能看到阶段进度条
[ ] 主工作区显示阶段 0 的编辑器
[ ] 右侧边栏正常显示

✅ 功能可用性

[ ] 文档面板可以打开
[ ] 团队面板显示角色信息
[ ] 活动面板显示创建记录

✅ 操作按钮

[ ] 能看到"开始阶段 0"按钮
[ ] 其他操作按钮状态正确

常见问题

Q: 创建项目后页面空白？

A: 可能是浏览器兼容性问题，尝试刷新页面或使用 Chrome/Firefox 最新版本。

Q: 看不到"开始阶段"按钮？

A: 检查模型是否配置正确，Agent 是否在线。没有可用的 AI 模型时，无法开始阶段处理。

Q: 项目创建失败？

A: 检查项目名称是否包含特殊字符，描述是否过长。查看浏览器控制台是否有错误信息。

Q: 想修改项目信息怎么办？

A: 点击项目概览区的"编辑"按钮，可以修改项目名称和描述。但项目类型创建后无法修改。

下一步

项目创建完成后，你可以：

开始第一个阶段 — 阶段 0-4：方案到任务
了解阶段流程 — 工作流与阶段
学习任务管理 — 任务设计

建议

不要急着开始阶段 0，先花几分钟熟悉工作区的各个区域。这样后续操作会更加顺手。

本章输出

完成本章后，你应该能够：

[x] 独立创建一个新项目
[x] 熟悉项目工作区的各个区域
[x] 理解项目-阶段-任务的层次关系
[x] 知道如何查看项目状态和配置选项

现在你已经有了一个完整的项目环境，可以开始体验 VAI TEAM 的核心功能了！

创建第一个项目 ​

选择合适的演示项目 ​

推荐项目：个人待办事项管理 ​

新建项目 ​

进入项目创建页面 ​

填写项目信息 ​

确认创建 ​

认识项目工作区 ​

1. 项目概览区（顶部） ​

2. 阶段进度条（中上部） ​

3. 主工作区（中心） ​

4. 侧边栏（右侧） ​

文档面板 ​

团队面板 ​

活动面板 ​

5. 操作区（底部） ​

理解项目数据结构 ​

阶段文档 ​

任务系统 ​

项目配置选项 ​

技术栈偏好 ​

代码规范 ​

模型配置 ​

项目状态检查 ​

✅ 项目基础信息 ​

✅ 工作区布局 ​

✅ 功能可用性 ​

✅ 操作按钮 ​

常见问题 ​

下一步 ​

本章输出 ​