# 快速开始：从零完成一次基本开发

本文带你用最少的步骤，体验一次完整的「让 AI 帮我改一段代码」流程。读完后你会对系统的关键概念（应用、Chat、任务、主版本）有直观感受，再去看后面的进阶文档会非常顺手。

> 阅读时间约 5 分钟。文中所有蓝色链接都会直接跳转到对应功能页，可随时点开操作、再返回继续阅读。

## 整体心智模型

```
应用（你的代码仓库 + 一个常驻 Agent）
   │
   ├── 应用主版本   ← 默认分支的代码（线上发布以这条分支为准）
   │
   ├── Chat        ← 一次性的轻量对话，问问题、试改动
   └── 任务         ← 有目标、有计划的开发工作，会跑得更久、更稳
```

简单记忆：

- **应用** = "AI 帮你做事的目标项目"，每个应用绑定代码仓库和 Agent。
- **Chat** = 一对一私聊，AI 一次只能盯一件事，适合"试试看"的小改动；多个 Chat 之间只能**串行**等。
- **任务** = 一个微信群，群里能拉多个 Chat **并行**推进同一个大需求，全部聊完后再统一合并到默认分支。

## Step 1 — 用「AI 推荐」一键创建应用

最推荐的上手方式：让平台基于你的诉求，AI 帮你挑一个开源项目并 fork 出来作为应用底座，代码仓库、基础设施一次性建好。

进入 [应用列表](#/apps) 页面，点击右上角 **+ 添加应用**，会弹出选择窗，**默认就选中了 「AI 推荐开源项目」**（带"推荐"小徽章）：

1. 保持选中 **「AI 推荐开源项目」**
2. 点 **开始对话**
3. 在跳转出来的 Chat 里用一句话描述你的诉求，例如："我想做一个支持多人协作的待办事项 web 应用"，Ctrl+Enter 发送
4. AI 会返回 3-5 个候选开源项目，每项都有简介、推荐理由和潜在风险提示
5. 选最合适的一个，点 **基于此项目创建应用** → 平台自动 fork 仓库、初始化配置

弹窗关闭后会提示「应用创建流程已启动，请等待创建状态变为『成功』」。回到应用列表，你会看到一行新数据，状态列会从 `创建中` 变为 `成功`，成功后即可开始使用。

> 如果你已经有想用的 GitHub 仓库，可以选「**从开源项目生成**」直接填 URL；想完全自定义就选「**自定义**」走完整向导。新手强烈建议先走 AI 推荐路径完整体验一遍。
>
> 在使用过程中遇到任何疑问，可以直接打开 [Chat](#/chats)，应用下拉框里默认选中的 **「default」** 就是基础通用助手，问它就行。

## Step 2 — 用 Chat 试一次小改动

进入 [Chat](#/chats) 页面：

1. 在右下角的输入框中选择刚创建好的**应用**
2. 输入一句话需求，例如："把首页标题改成'你好世界'"，按 **Ctrl + Enter** 发送
3. 系统会自动新建一个 Chat，左侧出现新条目，状态从 `等待` 变成 `执行中…`
4. 当前版本 **不流式输出**，AI 跑完后才会一次性把结果展示在右侧；执行中只看到一个跳动的省略号
5. 跑完后可以点击 **预览** 看效果，满意就点 **合并到应用主版本**，不满意就追问继续改

这就是最快的开发回路。

## Step 3 — 把"持续做的事"升级成任务

如果你想做的事比较大，例如"重构整个登录模块"，建议改用任务：

1. 进入 [任务列表](#/tasks)，点击 **+ 新建任务**
2. 填写标题、描述、归属应用，保存
3. 任务卡片会出现在列表，点开后能看到它内置的 Chat、变更历史、合并按钮
4. 任务执行过程中可以**挂起**，等需要时再继续

任务和 Chat 的区别详见 `04-chats.md`。

## Step 4 — 收尾：合并代码 + 发布生产

开发跑完只是第一步，下面这两件事才会让改动真的生效：

1. **合并代码**：在 Chat / 任务详情里点 *合并到应用主版本*（任务下还多一个 *合并到任务主版本* 用于阶段性合并）。合并后这条改动才会进入默认分支。
2. **发布生产**：进入 [应用列表](#/apps)，点击对应应用「操作」列里的 **发布**，会跳转到「发布详情」页。**这里不需要你手动选 commit**，两种方式任选其一即可：
   - **直接发布**：先在顶部「应用」筛选里选中当前应用，再点右上角 **发布生产** → 写一句发布描述 → 提交。平台会基于默认分支当前的状态触发一次新的生产发布。
   - **复用已有构建上线**：在下方表格里找一条**测试环境**、状态为 `成功`、且 Task ID / Chat ID 都为 `0` 的记录（这种记录是某次合并到默认分支后自动构建出来的），点行末的 **上线**，就能把这次构建直接切到生产。

   默认分支上的代码**只有发布过才会真的对外生效**——没发过就只是仓库里的一个 commit。

## 接下来读什么

- 想搞懂"主版本"到底是什么？见 `01-concepts.md`
- 想深入应用的配置？见 `02-apps.md`
- 想理清 Chat 和任务的边界？见 `04-chats.md`