快速开始:从提需求到发布上线
Quodara 是一个用对话做开发的平台:你在 Chat 里用一句话说清要什么,平台的 AI Agent 直接改你的代码仓库,改完一键预览测试环境,再一键发布到生产域名。本文带你完整走一遍这条链路。
阅读时间约 5 分钟。文中所有蓝色链接都会跳到对应功能页,可以随时点开操作、再返回继续读。
整体心智模型
应用(一个代码仓库 + 一个常驻 Agent + 测试/生产两套环境)
│
├── 应用主版本 ← 仓库默认分支,生产发布以它为准
│
└── Chat ← 你和 Agent 的一次对话,在临时分支上干活
└─ 合并到应用主版本 ─→ 预览(测试)─→ 发布(生产)
简单记忆:应用是"让 AI 帮你做事的那个项目",Chat 是"这一次让它做什么"。
Step 1 — 新建一个应用
打开 应用 页面,点左上角 + 新建应用,弹窗里有三种方式:
- 生成空白应用(带"推荐"角标,默认选中):填个应用名、选一个平台域名、起一个生产子域名,点 创建。平台会自动建仓库、配好域名和部署,最快拿到一个能跑的空壳。
- 从开源项目生成:填应用名、GitHub 地址和分支,点 创建并让 AI 改造。平台建好应用后会自动开一个 Chat,把改造需求发给 Agent。
- 自定义:直接进 8 步配置向导,适合已经有仓库、要自己接域名和数据库的进阶用法。
新手建议先走 生成空白应用。状态从 创建中 变成 成功 后就能用了。
不知道该怎么描述需求?在 Chat 的输入框里把应用切到官方 default 助手,它会帮你把想法拆成可执行的方案,也能回答平台使用类问题。
Step 2 — 在 Chat 里提第一个需求
进入 Chat:
- 在底部输入框选中刚建好的应用
- 输入一句话需求,例如"把首页标题改成《今天喝什么》,配色换成暖橙色"
- 按 Ctrl + Enter 发送
发送后左侧会出现一条新 Chat,状态依次是 等待 → 执行中 → 完成。执行过程中,消息区会实时显示 Agent 正在做的步骤(读了哪些文件、跑了什么命令),不用干等。
输入框里还有两个常用能力:@ 可以引用某个应用或某个文件,📎 可以上传附件(截图直接粘贴也行)。
Step 3 — 预览与发布
Agent 改完代码后,消息底部会出现一排按钮:
- 👀 预览:把这次改动部署到测试环境,点开就能看到效果
- 🚀 发布:确认没问题后,发布到生产域名
如果想让改动进入仓库默认分支,再点输入框旁边的 合并到应用主版本。
代码只有发布过才会真的对外生效。合并只是把改动并进默认分支,没发布之前,生产域名上跑的还是上一次发布的版本。
Step 4 — 不满意就接着聊
Chat 不是一问一答就结束的:
- 效果不对,直接在同一个 Chat 里追问"标题再大一点""这个按钮挪到右边"
- 跑偏了可以点 ⬛ 终止,原来那条消息会回填到输入框,改完再发一次
- 需要你做选择时,Agent 会直接在消息里给出交互卡片,勾一勾、填一填再提交即可
这就是 Quodara 上最基本的开发回路:说需求 → 看步骤 → 预览 → 发布。
接下来读什么
- 想搞清楚"应用主版本""常驻 Agent"到底指什么:
01-concepts.md - 想把自己的仓库、域名、数据库接进来:
02-apps.md - 想用好 Chat 的附件、
@引用、产物和报告:03-chats.md - 想弄明白预览和发布的区别:
04-publish.md - 想做微信小程序、安卓 App 或小红书小工具:
09-multi-target.md - 想让它出图、出音乐、出视频:
10-media.md - 想让它处理 Word / Excel / PPT / PDF:
11-documents.md
