基本概念

读完这篇，你就能说清 Quodara 里最核心的几个词：应用、常驻 Agent、Chat、应用主版本，以及测试环境和生产环境的关系。它们贯穿平台的每一个页面。

应用（App）

应用 = 你希望 AI 帮你开发和运维的一个项目。每个应用自带四样东西：

• 代码仓库：Agent 实际改代码的地方，可以是平台建的，也可以是你自己的 GitHub 仓库
• 常驻 Agent：跑在云端的执行体，负责克隆代码、理解需求、改动、提交、触发部署
• 两套环境：测试环境和生产环境各有独立的域名、数据库和配置
• 运行时配置：域名、数据库、对象存储、日志、监控等，由平台按环境下发给应用

应用列表在 应用 页面，有三个标签页：我的、收藏、看板。

常驻 Agent

Agent 不是一个只会补全代码的模型，它在一个真实的容器里工作：能读写仓库文件、装依赖、跑命令、查日志、生成图片和视频、调用你装的 Skill 和 MCP。

你不需要自己部署 Agent，创建应用时平台就把它配好了。你在 Chat 里发的每条消息，都是交给这个应用的 Agent 去执行。

Chat

Chat 是你和 Agent 的一次持续对话，也是平台上唯一的开发入口。

• 每个 Chat 绑定一个应用，创建时在输入框里选
• Chat 开始干活前，会先以应用主版本为基础拉一条临时分支，改动都在这条分支上
• 一个 Chat 可以来回聊很多轮，上下文一直保留
• 状态有四种：等待 / 执行中 / 完成 / 终止，左侧列表可以按状态筛选

侧栏第一项 new chat 就是新建对话，最近的对话列在它下面，还能按 Recent / Collect 切换。Chat 也不一定由你手动发起——定时任务到点会替你新建一个，见 08-schedule.md。

应用主版本

应用主版本指的是代码仓库的"默认分支"，通常是 main。它是生产发布的源头，但不一定等于线上正在跑的版本：

• Chat 干完活，点「合并到应用主版本」，改动才进入默认分支
• 点「发布」，默认分支当前的状态才被构建、部署到生产域名
• 所以线上版本 = 默认分支上某一次被发布过的状态，可能落后于最新提交

类比 GitHub：把应用主版本当作 main 分支理解即可。

测试环境与生产环境

两套环境的数据不互通，在测试环境造的数据不会出现在生产。

周边概念

• 我的 Skill：给 Agent 装的技能包，让它会做某类专门的事
• 我的 MCP：给 Agent 接的外部工具服务
• 营销阵地：你的账号定位和各平台档案，写营销内容时 Agent 会照着用
• OKR 与 待办：你的目标和小事清单，Agent 做事时会参考
• 秘钥管理：调用 Quodara 接口用的 API Token
• 商店：订阅套餐、使用兑换码

这些入口都收在 个人中心 的功能列表里，侧栏不再逐个列出。

一张图回顾

   你 ──提需求──► Chat（临时分支）
                   │
                   ├─ 👀 预览 ──► 测试环境（test 域名）
                   │
                   └─ 合并到应用主版本 ──► 默认分支 ──🚀 发布──► 生产环境

下一步推荐：02-apps.md