AI 构建器操作手册：界面、会话与开发全流程
逐个区域拆解 AI 构建器工作台：顶栏每个徽章的含义、聊天输入框的全部语法（@ 指定智能体、# 引用模块、粘贴图片）、五个快捷指令的适用场景，以及从新建会话到模块交付的每一步。人与 AI 自动化流程都可照此逐步执行。
本手册把 AI 构建器的每个操作拆到「点哪里、会看到什么、下一步做什么」的粒度。无论操作者是人工还是自动化程序，按本文的步骤都能得到确定的结果。修改已有模块的细节见修改与编辑模块；指令措辞技巧见给 AI 下指令的模式库。
一、进入构建器的三条路径
- 新建开发：侧边栏「AI → AI Studio」→ 右上角「新建会话」，或主页「AI 生成页面」卡片；
- 继续开发：AI Studio 的「模块」标签 → 找到模块卡片 → 点「打开」，会自动接上该模块最近的工作会话；
- 详情页进入：模块卡片点「详情」→ 概览页的「Launch Builder Workspace / 继续编辑」按钮。
会话是构建器的工作单元：一次开发的所有对话、页面版本、发布记录都归属一个会话。会话可跨多天、多模块复用，列表在 AI Studio 的「会话」标签维护。
二、工作台界面逐区拆解
从模块列表「打开」进入后，工作台分三块：顶栏、左侧对话区、右侧预览区。
顶栏（从左到右）
| 元素 | 含义 | 你能做什么 |
|---|---|---|
模块名徽章（如 inventory） | 当前工作台绑定的模块 | 点击返回模块列表 |
| 状态徽章（草稿/测试中/已发布） | 模块生命周期当前位置 | 状态含义见模块的测试与发布 |
版本号（如 v13） | 模块当前交付版本 | 每次成功交付自动递增 |
| 会话目标文字 | 本会话的需求一句话摘要 | 只读 |
| 已连接圆点 | 与构建服务的实时连接状态 | 断开时页面会自动重连 |
| 手机/电脑图标 | 预览目标平台切换 | 切换后预览区按对应端渲染 |
| 「跟随默认 ▾」 | 本会话使用的模型 | 打开后可为整个会话指定模型 |
| 「N 项待修」红标 | 模块错误账本的未解决计数 | 点击打开错误账本面板 |
| 「发布」按钮 | 进入发布流程 | 详细步骤见发布文档 |
模型选择是会话级的：选定后本会话及其全部子任务都用该模型。
左侧对话区
空会话时显示五个快捷指令入口与「继续已有模块」列表；开始对话后，AI 的执行过程（委派了哪个智能体、改了哪些文件、评审结论）全程流式展示。输入框能力：
- @ 指定智能体：输入
@弹出智能体列表，可指定由哪个角色主导本次任务； - # 引用模块：输入
#弹出模块列表，把其他模块的上下文带给 AI（跨模块联动场景必用）； - Ctrl+V 粘贴图片：原型截图、手绘草图直接粘贴，AI 按图实现；
- Excel 按钮：上传表格冷启动建模块，流程见用 Excel 一步建模块；
- Enter 发送，Shift+Enter 换行；语音按钮按下后说话，自动转写为文字。
右侧预览区
实时渲染模块当前版本的页面（数据来自测试库）。顶部「预览 / 测试」切换打开方式；预览随每次 AI 交付自动刷新，无需手动操作。
三、开发一个新模块的逐步流程
- 新建会话，用一句话说清业务（模板见指令模式库）。有存量数据时先传 Excel。
- 发送并观察执行。AI 会依次完成：数据建模 → 后端接口 → 管理页面 → 自动质检。每一步的产出都实时可见。
- 预览确认。右侧预览自动更新后，实际点一遍：新建、修改、筛选、删除。数据是测试数据，随便操作。
- 对话修正。哪里不符合预期，直接在对话里指出（一次一件事），AI 当场修改。
- 进入测试。模块会创建一个仅管理员可见的测试入口，在隔离测试库上验证（状态徽章变为「测试中」）。
- 发布。点顶栏「发布」，选择菜单位置、确认预检结论后上线，流程详见模块的测试与发布。
四、五个快捷指令的适用场景
| 指令 | 什么时候用 | 示例说法 |
|---|---|---|
| 修复问题 | 错误账本有未解决项，或页面表现异常 | 「修复问题：列表筛选后合计行不刷新」 |
| 新增功能 | 给模块加新能力 | 「新增功能：按车间导出 Excel」 |
| 修改功能 | 已有能力的表现不对 | 「修改功能：购入日期默认今天」 |
| 删除功能 | 移除不要的东西 | 「删除功能：列表里的创建时间列」 |
| 自由对话 | 问状态、要解释、规划下一步 | 「现在这个模块有哪些接口？」 |
点快捷指令只是帮你起头，说明文字仍要自己补充——指令发出后与普通消息无异。
五、模块详情页（只读仪表盘）
模块列表点「详情」进入只读视图，三个页签：
- 概览：模块标识、版本、风险等级、生成物统计（数据模型/接口/页面是否已生成、版本总数）、沙箱运行时状态（可手动 Start、看 Error Logs）、版本日志时间线；
- 数据与接口：当前数据模型字段与对外接口清单；
- 页面预览：当前版本页面的渲染效果。
六、注意事项
- 一次会话可以交付多个模块，但建议一个业务域一个会话，上下文更聚焦；
- 「已连接」变红再发送消息可能丢失，等自动重连后再操作；
- 预览里的数据是测试库数据，与生产互不影响；发布后另有数据初始导入机制；
- 版本号只增不减，回滚不会删除历史版本，随时可以再滚回来；
- 普通构建成员看不到发布按钮的完整权限时（发布需超管），做到测试就绪后交由管理员发布即可。