构建流程
启心自动化平台 的源文件和运行文件是分开的。部分修改需要构建（类似 PLC 工程编译 + 下载）才能生效。
什么时候需要构建
| 修改了什么 | 需要构建？ | 怎么生效 |
|---|---|---|
| 改页面（控件、动作、文本） | 不需要 | 保存后刷新运行页即可 |
| 改变量、查询、配方 | 不需要 | 保存后重启应用或刷新即可 |
改 .qxgraph 流程图 | 需要 | 保存 → 构建 → 重启应用 |
改 .cs 自定义代码 | 需要 | 保存 → 构建 → 重启应用 |
| 改对象属性 | 不需要（部分通信参数需要重启） | 保存后根据提示操作 |
简单记：改了流程图或自定义代码就要构建。只改画面不需要。
怎么构建
有两种方式：
手动构建
- 确认所有修改已保存。
- 在编辑器顶部 Navbar 点击 Build 按钮。
- 等待构建完成，看状态提示。
自动构建
以下情况平台会自动触发构建：
- 启动或调试停止状态的应用
- ZIP/Git 导入后首次加载
- NewEngine 启动时扫描到过期的 DLL
自动构建不会弹确认框。如果构建失败，应用状态显示 加载错误。
截图占位：Navbar 的 Build 按钮和构建状态
构建状态怎么看
Navbar 的 Build 区域会显示：
| 状态 | 含义 |
|---|---|
| Build | 空闲，可以手动构建 |
| Building... | 正在构建中 |
| Build OK | 构建成功 |
| Build Failed | 构建失败，点开看诊断信息 |
应用运行状态和构建状态是分开的：
| 运行状态 | 含义 |
|---|---|
| Stopped | 未启动 |
| Running | 运行中 |
| Error | 加载或运行失败 |
正在运行中的应用不能构建。需要先 Stop 再 Build。
构建失败怎么办
构建失败意味着 .cs 代码有编译错误，或 .qxgraph 流程图有生成错误。
诊断信息在编辑器底部的 Problems 面板中显示。每条错误包括：
- 严重级别（错误/警告）
- 错误代码
- 错误描述
- 所在文件和位置
处理流程
- 点开 Problems 面板查看错误。
- 根据错误信息定位源文件（CS 代码或 Graph）。
- 修复后保存、重新 Build。
- 构建成功后启动应用验证。
常见构建错误
| 错误信息 | 原因 | 处理 |
|---|---|---|
| CS 编译错误 | 自定义代码语法错误、缺少引用 | 检查 .cs 文件，修正语法 |
| Graph 节点类型不匹配 | 端口连线类型不对 | 打开 Graph，检查标记为错误的节点 |
| 找不到对象类型 | 代码中引用了不存在的对象 | 检查对象名拼写或对象是否存在 |
| CustomScripts.dll 缺失 | 构建产物丢失 | 重新 Build |
| Graph provider 缺失 | Graph 生成器没有正常执行 | 检查 .qxgraph 文件是否合法 |
推荐的排查顺序：先看是不是代码错误 → 再看是不是 Graph 错误 → 再看是不是插件/引用问题。
用 AI 辅助排错
在 AI 面板中引用出错的文件，告诉 AI：
请检查这个 Graph 为什么构建失败。先列出失败节点和原因，
只修复必要连线和参数，不改变原来的业务顺序。
AI 可以读取构建错误信息，定位问题，帮助修复。
完整构建流程示例
以修改了一个 Graph 和一段自定义代码为例：
- 保存 Graph（
Ctrl+S）。 - 保存
.cs文件（Ctrl+S）。 - 如果应用在运行中，先 Stop。
- 点击 Build。
- 构建成功 → 点 Run 启动验证。
- 构建失败 → 查看 Problems 面板 → 修复 → 重新 Build。
现场发布前检查清单
- 所有页面已保存
- 所有 Graph 已保存
- Build 成功，没有错误
- 应用可以正常启动
- 运行页关键操作已测试
- AI 生成的动作和配置已人工复核
- Git 已提交或 ZIP 已备份