附录 E 常见问题 FAQ
E.1 工程相关
Q：最近工程打开提示"工程目录不存在或已被移动"？ A：工程目录被移动、改名或删除。点该记录的「移除」，再用「打开工程」选到正确目录。
Q：编辑工程改名后打不开了？ A：改名会重命名目录。如果同级已有同名目录，操作会失败。先在资源管理器里清理冲突目录，或换名。
Q：导出工程后，导出的文件能直接双击打开吗？ A：不能。导出的是 JSON 快照文件，用于备份与迁移，不是可执行工程。还原需要在支持导入的宿主里操作。
Q：删了最近记录，工程文件还在吗？ A：在。移除只删记录，不删磁盘文件。
E.2 设备与控制器
Q：可绑设备列表是空的？ A：依次检查：设备是否开机；是否与本机在同一局域网；设备上的 Triton 控制面板是否在运行；防火墙 / 交换机是否拦截广播；点「重新搜索」再试一轮。弹窗第三行的排查信息可以发给技术支持。
Q：设备在列表里但是灰的、选不了？ A：它已被别的工程或本工程其它控制器 / 工位占用。同一台设备只能绑定一处。
Q：能搜到设备，但提示"版本较低、无法接入"？ A：设备固件版本不满足要求，需要先升级。
Q：添加控制器时提示"控制器已创建，但硬件拓扑写入失败"？ A：控制器已经建好了。不要重复新建，进设备 Tab 编辑该控制器，重新填写拓扑并保存。
Q：为什么我在编辑控制器时删不了工位，或者按钮是灰的？ A：只剩一个工位时垃圾桶会置灰（提示「至少保留一个工位」），控制器至少要有一个工位。多于一个时是可以删的，但删除会连带删掉该工位的变量表、配置包版本与流程，删前务必确认。「从设备生成工位」这类批量入口只在新建控制器时提供，编辑态刻意不出现，因为它会整体覆盖工位集合。
Q：换型号后轴/IO 分配全空了？ A：换型号会重建拓扑并清空分配。这是设计行为，换型号后需要重新分配。
E.3 分配
Q：轴/IO 分配表里没有可分配的行？ A：该控制器型号没有本体 IO/轴，且没有添加扩展从站。回控制器编辑里补拓扑。
Q：改了分配，为什么工位配置里的参数没了？ A：资源换工位后，原工位上的参数不会自动搬迁（也不删除，只是不再生效）。需要到新工位的配置页重新配置。
Q：批量分配后还要点保存吗？ A：不用。批量分配确认即落库。逐行改才需要点「保存」。
Q：分配表里的点位名称和变量名不一致，看着很乱？ A：用「输入、输出点名称对齐变量名称」按钮批量改名。
E.4 工位配置
Q：某个分类下的字段全是灰的 / 没有行？ A：该工位没有分配到对应资源（轴 / IO）。先去分配表分资源。
Q：配置项改了但状态栏没有「未保存」标签？ A：标签在配置项标题右侧，不在顶栏。如果确实没有标签，说明该编辑器没有接入改动检测；仍建议点一次「保存」确认。
Q：切走工位时提示有未保存内容？ A：三个按钮：「保存」逐个保存改动项后离开；「跳转」只放行这一次（改动不落库，也不清掉未保存标记，回来还能继续改）；「取消」留在当前页。
Q：生成配置时弹出「未保存改动（1/3）」是什么？ A：这是生成前的逐项确认。选「保存」则该页改动进入本次配置包；选「跳过」则按已落库数据生成，本次改动不打包。
Q：「默认待保存」（橙色）和「未保存」（红）什么区别？ A：橙色是系统按拓扑自动铺好的配置底稿（分配轴 / IO 后常见），还没写入工位配置；红是你手工改过还没保存。两者都要保存后才算进配置包。默认值是为了分配完资源后不用从空白表手填。
Q：生成配置失败？ A：常见原因：型号拓扑不完整、工位没有分配资源却启用了对应配置、拓展配置里有未发布项。按提示处理后重试。
Q：提示"配置文件已生成，但压缩包为空"？ A：后端打包失败。先重试；持续失败需要查看接口返回信息或联系后端。
Q：推送配置报"系统内部错误"？ A：最常见是配置包为空或设备不在线。先确认设备在线，再确认版本包非空。
Q：配置包版本能删吗？会影响设备吗？ A：能删，删除不可恢复，删除后无法再推送该版本。设备上已经生效的配置不受影响。
E.5 变量表
Q：新增变量时 ID 下拉是空的，提示"当前区间变量已被占用"？ A：本页所有 ID 都定义了。翻到下一页，或换一个分类。
Q：为什么有的变量类型改不了？ A：ID 1~2000 是系统保留区，固定布尔；输入点、输出点分类下也固定布尔。
Q：批量改完类型后没生效？ A：批量操作只改表格，需要点「保存当前页」。
Q：关掉「下发到 Janus」后平台上的变量没了？ A：这是设计行为，关闭会删除平台侧的数据定义。平台在用该变量时请谨慎。
Q：导出的变量比表格里少？ A：导出只包含已填名称、已填发送间隔、或已下发 Janus 的变量。
Q：导入后变量类型不对？ A：导入会做类型转换，并弹出强制转换的警告清单。按清单逐条改回正确类型并保存。
E.6 流程
Q：新建流程时确认按钮一直是灰的？ A：流程名称或类型没填。名称还需要满足长度 ≤ 50、不含特殊字符。
Q：流程名称能用中文和空格吗？ A：可以，只要不含特殊字符、长度不超限。
Q：拖了功能块但保存不了？ A：先看异常项面板，通常是必填参数没填或连线不完整。
Q：对齐 / 分布 / 自动连线按钮是灰的？ A：对齐和间距需要选中 ≥ 2 个节点，分布需要 ≥ 3 个；自动连线需要 ≥ 2 个。
Q：撤销不回来怎么办？ A：撤销栈只记录本次编辑会话的历史，保存后重新打开流程时历史会清空。重要改动前建议先用「版本」留一个版本。
Q：异常提示能忽略吗？ A：只有旧版本流程迁移提示这类问题带「已知悉」按钮，点了就不再提示（表示已人工核对）。参数缺失、未连线这类校验问题没有忽略入口，必须改好；带异常推送在设备侧可能执行不符合预期。
E.7 推送
Q：流程推送成功但设备没动？ A：检查：流程自启动是否打开；启动变量是否正确写入；工位配置包是否也下发了（轴参数、IO 映射可能是旧的）；设备是否处于自动模式。
Q：改了轴参数，只推了流程，为什么没生效？ A：流程推送不带工位参数。需要重新「生成配置」并「推送配置包」。
Q：推送弹窗里我的流程没勾上？ A：只有「当前流程」与「近期已推」的流程默认勾选，新建流程需要手动勾。
Q：一次能推几个流程？ A：单工位流程列表的推送弹窗里可以勾任意多个，属于批量推送模式。
Q：推送能撤销吗？ A：不能。推送是覆盖式的，回退只能重新推送旧版本（流程可用「版本」找回，配置包可用历史版本重新推送）。