AI Copilot 智能搭建
AI Copilot 是 Zion 编辑器内置的 AI 搭建助手。用自然语言描述你想要什么，它会先规划再动手，把结果直接写进你的项目——数据表与关系、行为流、第三方 API、AI 智能体，以及前端页面。不需要本地工程环境，也不需要写代码。
AI Copilot 与 Vibe Coding + Zion 全自动搭建 解决的是不同问题：Vibe Coding 通过 Zion Plugin 在你自己的代码编辑器里驱动 AI 生成代码；AI Copilot 在 Zion 平台内驱动 AI 配置无代码资源，前后端一次搭好。
AI Copilot 能搭建什么
数据模型与自定义类型
在数据标签页中创建数据表、字段、关系，以及枚举和自定义对象类型。这里最适合让它一次性规划整套结构——用户、商品、订单三张表及其外键关联——而不是一张一张地加。
也可以创建公式字段：字段值不落库，每次读取时由同一行的其他字段实时算出，因此不会过期。公式字段不能设为必填、不能设默认值，也不支持图片 / 视频 / 文件 / JSON 类型。字段刚创建出来时公式是空的，此时算作项目错误，AI Copilot 会紧接着把公式补完。普通字段与公式字段之间只能在字段尚未部署到后端时互相切换，已部署的字段只能删除后重建。可参考公式参考。
行为流
在行为 → 行为流中搭建行为流，包括条件分支、循环、数据库读写、调用 API、AI 节点等。AI 可以把多个节点编排成完整业务闭环，例如「提交订单 → 扣减库存 → 发送通知」。
第三方 API 与 Webhook
在行为 → API 中配置第三方 API 的请求方法、路径、参数与返回结构，把外部服务接入项目——也可以直接从对方的在线文档或 OpenAPI / Swagger 描述导入。它还能在行为流的触发器中创建 Webhook：被外部调用时触发指定行为流的 HTTP 端点。
权限与密钥
在设置 → 权限管理中设计角色与权限：创建角色，配置表 / 列 / 行权限，以及行为流、API、AI、支付的调用权限。涉及多种用户身份、数据隔离或 403 报错时，可以直接让它来梳理。
它也能登记项目的 Secret（API key、token 等敏感值），供行为流和 API 配置按引用使用。需要填写具体的值时，它会在编辑器里弹出输入框请你键入，明文不经过对话，因此不必也不应该把密钥粘贴给它。
AI 智能体
在行为 → AI 中搭建 AI 智能体：配置模型、温度、轮次、提示词、输入参数与输出结构，产出一个可以直接调用、也可以继续手工打磨的草稿智能体。
前端页面与主题
在设计标签页中搭建前端页面与组件：创建组件、调整层级与排版、设置样式，并把组件绑定到数据库查询、页面变量、全局变量或当前登录用户。
颜色、字号、圆角这类值也可以让它落到设置 → 主题的全局主题上，而不是写死在单个组件里，后续改主题即可整体生效。
每轮对话结束后，AI Copilot 会给出一条已创建 N 项内容的汇总，按表 / 行为流 / API / AI 智能体分组，点击任意一项即可跳转到对应编辑器查看和继续修改。
线上验证与排错
能验证什么
AI Copilot 不仅能描述改动，还能直接验证自己改动的效果（针对已部署的后端运行）：
- 查询和统计线上数据表，必要时也能按需读写数据，用来准备一次验证所需的数据；
- 调试运行行为流的草稿版本，逐节点查看输入、输出、耗时和报错，与编辑器里的行为流调试器一致；
- 调用已部署的行为流，以校验真实调用方拿到的结果；
- 在 Run Code 沙箱里试跑一段 JavaScript，确认代码节点的实际返回；
- 以指定身份重复同一次读取，核对该身份实际能看到哪些数据（不指定身份时使用管理员通道，会绕过行列权限）；
- 用你提供的凭证登录一个真实账号，再以该身份读取；
- 试运行草稿 AI 智能体；
- 查询服务端运行日志（行为流、网关、SQL 生成、GraphQL 等），按 traceId 还原一次请求的完整链路，用来定位线上报错。
注意事项
在让它跑线上验证之前，有四件事需要先知道：
- 线上验证针对已部署的后端。若草稿有未同步改动，验证结果不代表草稿行为，Copilot 会在结果中提示。
- 调试运行行为流、试跑 Run Code 默认在结束时回滚数据库写入；调用已部署行为流不会回滚，其中的外部操作（第三方 API、邮件短信、支付等）会真实发生。
- 写入、修改或删除数据表中的数据，以及 Copilot 为某个角色铸造的账号，都真实作用于你的应用，不会自动清理，也无法撤销。
- 试运行草稿 AI 智能体会产生真实的模型调用，消耗项目的 AI points，且无法回滚。
会话的能力边界
一个 AI Copilot 会话绑定在你打开的那一个 app 上。它能改什么，取决于这个 app 是否带着可编辑的后端 schema：
- 后端 app，或单客户端项目：完整能力。数据模型、自定义类型、行为流、权限、外部 API、Webhook、密钥、AI 智能体、主题、支付都能改，也能同步后端。
- 多客户端项目里的某个客户端 app：搭建这个 app 的页面与组件、绑定数据。它面对的后端是已部署的那一份，因此只能运行、调试和查看日志，不能修改后端的任何配置，也不能同步后端。
- 只有 app 级权限、没有项目后端权限：同样只能搭建当前 app 的页面与组件、绑定数据；对已部署的应用，只能以它自己注册或登录得到的身份访问，不能走管理员通道，也看不了运行日志。
输入框底部工具条最左侧有一个人像标识，悬停显示这次会话的两个字段：可编辑范围（项目 / 仅前端）和后端访问角色（管理员 / 普通用户）。上面三种情况依次是「项目 + 管理员」「仅前端 + 管理员」「仅前端 + 普通用户」。会话还没跑过第一轮时不显示——那时这两个字段还没确定。
改完数据模型、行为流、API、权限、密钥或 AI 智能体之后，需要同步后端，线上运行的才是新 schema。AI Copilot 可以自己发起同步（限可编辑范围为「项目」的会话），在针对线上验证之前它通常会这么做。
如何使用
打开 AI Copilot
入口在编辑器顶栏右侧的 AI Copilot 按钮，快捷键 ⌘ \（Windows 为 Ctrl \）。面板打开后：
- 面板标题栏的浮动面板 / 停靠面板图标可以在「贴着编辑器停靠」和「浮在编辑器之上」之间切换，浮动面板可拖动和缩放；
- 同一栏还有余额、跟随 AI 修改、会话历史、开始新会话和关闭按钮。
选择模式
模式在输入框底部工具条的模式下拉中切换：
| 模式 | 作用 | 典型用法 |
|---|---|---|
| 研究 | 答疑、查询现状、给出方案建议，不修改项目 | 「我的订单表和用户表应该怎么建关系？」 |
| 搭建 | 生成和修改项目资源，每处改动都要你确认 | 「帮我建一个订单表，并加一个提交订单的行为流」 |
| 自动确认 | 同「搭建」，但改动直接应用，不逐条询问 | 计划已经谈清楚、只想让它一口气做完时 |
一般的用法是：先用研究摸清项目现状、把方案谈拢，再切到搭建让它动手。
选择模型与思考强度
输入框底部工具条中间的选择器用来切换本次会话使用的模型和思考强度（无 / 最低 / 低 / 中 / 高 / 极高 / 最高）。思考强度越高，AI 在回答前推演得越充分，结果通常更周全，消耗也越多。模型列表中会标注每个模型相对 Luna（1x）的积分倍率——标记为 2x 的模型，完成同样的工作会消耗两倍积分。
切换到其他厂商的模型会让 AI 丢失本次对话中已有的推理过程和工具调用记录（你的消息和 AI 的回复会保留），切换前会弹窗提示。需要保留完整上下文时，请改为新建会话。
发送消息
输入框右下角的 + 可以附带图片一起发送——想要的布局截图、出问题的界面截图都可以。
任务运行时不必等它结束。随时输入并发送，消息会进入排队队列：AI 会在当前这一步工具调用结束后再取走它，因此新消息落在两步之间，不会打断正在进行的操作。
排队中的消息显示在输入框上方，标注「已排队，当前步骤结束后发送」。每条消息右侧的 ×（移出队列）可以在它被取走前撤回；如果点击时 AI 恰好已经取走了这条消息，撤回会失败并提示「来不及撤回了，这条消息已经发给 AI」——此时它已经进入对话，只能通过停止任务来改变方向。
排队消息保存在服务端而不是浏览器标签页，因此刷新页面或断线重连后，尚未执行的排队消息仍会显示。
停止当前任务
运行时输入框右下角是两个独立按钮：发送始终是发送，旁边会多出一个停止按钮（暂停图标，提示为「停止当前步骤」）。发送不会停止任务，停止也不取决于输入框里有没有内容。光标在输入框内时按 Esc 同样可以停止当前任务。
停止会丢弃所有尚未取走的排队消息；已经被 AI 取走的消息会留在对话里。
跟随 AI 修改
在面板标题栏开启跟随 AI 修改后，AI 每完成一处改动，编辑器视图会自动跳转到对应位置，方便你实时核对它在做什么。点击任意位置，或再次点击该图标停止跟随，即可回到手动操作。
长会话与断线
对话过长时，AI Copilot 会自动精简上下文，并在对话中插入一条已精简上下文的提示，会话照常继续。网络断开时面板顶部显示「连接已断开，正在自动重连…」，恢复后继续接收后续进展。搭建过程中有不少步骤要由编辑器实际执行，因此请保持这个标签页打开。
Copilot AI Points
AI Copilot 的搭建消耗 Copilot AI Points。它属于账号而不属于某个项目，因此同一份余额可以用于你参与的所有项目。每次向 Copilot 发送消息都会产生一次或多次模型调用，按模型厂商的公开定价计费。
余额显示在面板标题栏，随搭建实时更新：偏低时显示为琥珀色，接近用尽时显示为红色。每轮回答下方也会标注本轮和本次会话累计消耗的点数。
余额用完时搭建会停止，并显示 Copilot AI Points 已用完。当前进度已保存，对话停留在原处；充值、等待下周免费额度补充，或由项目所有者划拨项目 AI points 之后，重新发送消息即可继续。
- 查看余额、变动明细与充值入口：见我的钱包 · Copilot AI Points。
- 把项目的 AI points 划拨给 Copilot：见管理项目资源 · 划拨项目 AI points 给 Copilot。
AI Copilot 创建的每一项资源都会归类到会话的「待确认变更」列表中（表 / 行为流 / API / AI 智能体 / 前端页面），你可以点击任意一项跳转到对应编辑器查看和继续修改。
跟随 AI 修改
搭建过程中可开启「跟随 AI 修改」：AI 每完成一处改动，编辑器视图会自动跳转到对应位置，方便你实时核对它在做什么。随时可停止跟随，回到手动操作。
线上验证能力
AI Copilot 不仅能描述改动，还能直接验证自己改动的效果（针对已部署的后端运行）：
- 查询和统计线上数据表；
- 调试运行行为流的草稿版本；
- 调用已部署的行为流；
- 以指定身份重复同一次读取，核对该身份实际能看到哪些数据（不指定身份时使用管理员通道，会绕过行列权限）；
- 用你提供的凭证登录一个真实账号，再以该身份读取；
- 试运行草稿 AI 智能体。
未登录与已登录看到的数据往往不同，Copilot 会拿这两者对比：
| 身份 | 说明 |
|---|---|
| 匿名 | 完全不带凭证，等同于未登录的访客，也是唯一持有「匿名用户」角色的身份 |
| 登录账号 | 用你提供的凭证登录的真实账号，持有「登录用户」角色及其自身的项目角色 |
只有登录账号能验证依赖项目自定义角色的权限规则，因此 Copilot 可能会向你索要某个真实账号的用户名与密码。凭证只用于这一次登录，是否提供由你判断。
- 线上验证针对已部署的后端。若草稿有未同步改动，验证结果不代表草稿行为，Copilot 会在结果中提示。
- 调试运行行为流默认在结束时回滚数据库写入；调用已部署行为流不会回滚，其中的外部操作（第三方 API、邮件短信、支付等）会真实发生。
- 写入数据表，以及 Copilot 为某个角色铸造的账号，都真实存在于你的应用中，不会自动清理，也无法撤销。
- 试运行草稿 AI 智能体会产生真实的模型调用，消耗项目的 AI 积分，且无法回滚。
搭建 AI 积分与充值
AI Copilot 的搭建消耗搭建 AI 积分（账号级，可用于你参与的所有项目）。每次向 Copilot 发送消息都会产生一次或多次模型调用并按模型公开定价计费；不同模型的积分倍率不同（以 Luna 为 1）。
- 查看余额、购买记录与充值入口：见我的钱包 · 搭建 AI 积分。
- 把项目的 AI 积分划拨给 AI Copilot：见管理项目资源 · 划拨项目 AI 积分。
AI points 灵活互通
单个项目的 AI 智能体 AI points，可转为 AI Copilot 搭建所需的 AI points，资源不浪费，使用更自由。
搭建 AI 积分与项目管理页中的 AI Point 资源是两回事：项目 AI Point 用于已发布应用内的 AI 功能（AI 智能体、向量化与向量搜索），搭建 AI 积分用于 AI Copilot 的规划与生成。