# Chat：和 Agent 一起把事做完

Chat 是 Quodara 上唯一的开发入口，也是产出文档、图片、视频和报告的地方。这篇把输入框、消息区和顶栏上的每一个能力讲清楚，让你不用猜哪个按钮做什么。

## 新建一个 Chat

侧栏第一项 **new chat** 就是新建对话，也可以直接打开 [Chat](#/chats)；同样一段话交给**定时任务**，到点会自动建一个对话跑起来（见 `08-schedule.md`）：

1. 在底部输入框里选中要操作的**应用**
2. 打字描述需求
3. **Ctrl + Enter** 发送

选官方 **default** 应用时，它是一个通用助手：既能回答平台使用问题，也能帮你做文档、素材、营销内容和方案对比，不绑定任何代码仓库。

## 输入框上的能力

- **`@` 引用**：输入 `@` 会弹出候选，可以引用**某个应用**、**本次对话产出的文件**、**你上传的文件**。引用应用时 Agent 会自动去读它的仓库和部署配置，比你复述一遍准确得多。
- **📎 附件**：支持多选上传，截图也可以直接粘贴进输入框。上传的文件会同步给 Agent，产物回传后出现在消息下方。
- **合并到应用主版本**：把这个 Chat 的改动并进仓库默认分支。
- **⬛ 终止**：中断当前执行，原来那条消息会回填到输入框，改完再发一次。

## 执行过程中能看到什么

发送后消息状态依次是 `等待` → `执行中` → `完成`（中断则是 `终止`）。

Chat **不是逐字流式输出**，但也不用干等：执行期间消息区会实时展示 Agent 的**执行步骤**——读了哪些文件、跑了什么命令、调用了哪个能力。步骤面板还没有内容时，会先显示一个等待动画。

## 消息里可能出现什么

Agent 回复的消息不只有文字，常见的还有：

- **交互卡片**：需要你做选择、填表单或确认风险时，Agent 会直接在消息里给出卡片，勾选提交即可，不用自己组织文字回答
- **产物列表**：生成的图片、音乐、视频、Word / Excel / PPT / PDF 等文件，图片直接大图预览，其余以文件名形式列出，点击下载
- **交互报告**：数据分析、调研、评审这类长内容会渲染成带目录和图表的报告卡片，点开在右侧面板里看，也可以分享出去
- **👀 预览 / 🚀 发布**：这条消息改动了哪些应用，就为哪些应用各出一排按钮
- **合并请求 / 部署记录**：点开可以看到这次部署的日志和结果

图片、音乐、视频怎么要、怎么改见 `10-media.md`；Word / Excel / PPT / PDF 和交互报告见 `11-documents.md`。

## 顶栏上的四个动作

| 按钮 | 作用 |
|---|---|
| 收藏此 Chat | 收藏后在侧栏 **Collect** 标签页里找得到 |
| 分享至 Blog | 把这次对话发到 Explore，别人无需登录也能看 |
| 长图分享 | 把整个对话导出成一张长图，方便发朋友圈或群里 |
| 提交工单 | 带着当前对话上下文找人工客服 |

## 怎么把需求说清楚

同样一句话，说法不同结果差很多。几条实用建议：

1. **说目标，不要说实现**："让用户能按日期筛订单"比"加一个 date picker"更好，Agent 会自己选合适的实现。
2. **一次一件事**：一条消息里塞五个不相关的改动，出问题时很难定位是哪一步坏的。
3. **带上证据**：页面不对就截图粘进来，报错就把 Console 里的红字贴上，比描述"打不开了"有效得多。
4. **先预览再合并**：预览是免费的验证机会，别跳过它直接发布。
5. **让它先给方案**：大改动可以先说"先别写代码，给我两个方案对比"，确认方向后再动手。

## 常见疑问

**Q：Chat 终止后还能继续吗？**
A：能。终止只是打断这一次执行，对话上下文和分支都还在，再发一条消息就接着做。

**Q：同一个应用可以同时开几个 Chat 吗？**
A：可以，但每个 Chat 在各自的临时分支上干活，改到同一批文件时合并会冲突，建议错开。

**Q：上传的文件会一直保留吗？**
A：对话里的附件和产物都留在这个 Chat 下，随时能回来下载；要长期给应用使用的素材，让 Agent 放到应用的对象存储里。

下一步推荐：`04-publish.md`