AI 主导工作流
启心自动化平台 的推荐使用方式：先用自然语言告诉 AI 你要什么，AI 负责拆解到具体的画面、流程、查询和代码，你负责审核确认。
典型流程
- 你描述目标。例如："给跌落试验机加一个运行看板，显示 Z 轴位置、翻转角度、当前试验次数和状态指示灯"。
- AI 读取当前 app：查看已有的设备对象、页面、流程图、变量。
- AI 拆解方案：判断改哪个页面、用什么控件、是否需要新变量。
- AI 生成配置：写入页面、绑定数据、创建动作。
- 你复核：在可视化界面检查布局、动作、文案和数据绑定。
- 保存 → 构建（如果改了流程图或代码）→ 启动 → 测试。
这意味着你是审核者和上线负责人，AI 是辅助工具。
怎么告诉 AI
好的提问结构：
目标：我要实现什么。
范围：只改哪些 page / Graph / query / 对象。
约束：哪些不能动。
验收：完成后怎么验证。
示例一：加运行看板
目标：给包装线加一个运行看板。
内容：显示三台轴的状态指示灯、当前产量数字、最近 10 条报警记录。
范围：只改页面，复用现有设备对象。不要新增设备动作。
验收：运行页能打开，轴状态实时更新，报警列表显示最近记录。
示例二：修改流程图
请检查这个 Graph 为什么构建失败。先列出每个失败节点的原因，
再只修复必要的连线和参数，不改变原来的业务顺序。
示例三：生成设备对象
请新增一个扫码枪对象。用语义方法封装读取结果，内部处理串口协议。
不要让画面或流程直接处理底层通讯。构建后确认新方法出现在可用列表中。
AI 辅助各类任务
画面和控件
可以让你 AI 帮你：
- 创建页面，添加控件
- 调整布局和样式
- 生成列表/卡片模板（component）
- 配置 repeater、table、upload、model3d
- 编写动作脚本
流程图
可以让你 AI 帮你：
- 解释现有流程图的逻辑
- 补全缺失的节点参数和连线
- 检查端口类型不匹配
- 把多步设备操作编排成 Graph method
- 添加 Wait Until 等待和超时处理
AI 在编排时会把稳定能力封在设备方法里，再用 Graph 编排调用顺序，不会把所有逻辑塞进一个节点。
自定义代码
可以让你 AI 帮你：
- 编写设备对象代码
- 修复编译错误
- 补充方法和参数注释
- 让对象的描述信息对 AI 可读（方便后续 AI 再用）
工程人员需要确认生成的代码符合现场设备协议规范。AI 不具备设备物理知识，不能替代对实际 PLC 地址、寄存器映射和通信参数的人工核对。
查询配置
可以让你 AI 帮你：
- 把外部系统调用整理成
queries.json中的查询 - 统一画面和流程中的调用方式
- 检查参数是否匹配
构建排错
可以让你 AI 帮你：
- 读取构建错误，定位到具体文件
- 按 script → Graph → object → page 的顺序排查
- 给出最小修复方案
示例提问：
这个 app 启动失败，错误是 object type not found。
请检查是 script 没构建还是对象配置有问题，给出修复步骤。
各模块中 AI 的边界
AI 可以辅助完成配置工作，但最终保存、运行和发布仍由你负责。
| 模块 | AI 适合做什么 | 不适合 |
|---|---|---|
| 画面 | 创建控件、调整布局、检查 action 绑定、生成 table/repeater 配置建议 | 决定什么信息需要展示给操作员 |
| 流程图 | 解释结构、补全参数、检查端口类型、根据报错定位节点 | 决定工艺顺序和安全联锁逻辑 |
| 查询 | 定义外部系统请求、检查参数和 URL、统一调用方式 | 决定什么时候该写数据到 MES |
| 自定义代码 | 生成代码、修复编译诊断 | 确认寄存器映射和协议细节的正确性 |
你重点复核什么
- 设备动作是否符合现场安全流程
- 权限和角色配置是否正确
- 外部查询会不会误写生产数据
- 流程图的分支条件是否覆盖异常情况
- 画面上的按钮文字和提示是否适合操作员
- 修改涉及的流程已经保存、构建、测试通过
使用建议
- 一次给 AI 一个清晰目标，不要同时改多个不相关的模块。
- 先让 AI 检查（"帮我看看这个有什么问题"），再让 AI 改（"请修复"）。
- 引用相关文件（用
@），让 AI 基于最新状态操作。 - 涉及关键设备动作时，要求 AI 先输出影响范围和依赖，确认后再生成。
- AI 生成的画面和流程，在上线前一定要在实际设备上测试。