技能介绍

要解决的问题

给汇川 H5U/Easy 写 PLC 程序，常见的坑不是逻辑写不出来，而是写出来的东西 AutoShop 不认。PROGRAM、VAR...END_VAR、END_PROGRAM 这些标准 IEC 结构直接放进 SBR 源文件会编译报错，因为 AutoShop 的 SBR 只保存执行体，变量、枚举、结构体、FB 实例必须真实存在于工程自己的变量表、类型表和实例对象里。另一个常见问题是：拿一段文本当作“已完成的程序”，实际工程目录里什么都没发生。

核心能力与工作方式

这个技能按任务路由到四种模式：AutoShop 原生工程候选、显式通用 L1 审查包、既有 ST 工程对象读写、MAIN.LD→ST 模板适配。默认目标是AutoShop 能打开并全量编译的原生工程候选。

需求侧只输入设备动作、控制器型号、工程绝对路径和验收条件，不需要用户手写标准 IEC POU。
生成前先跑 scripts/preflight_check.py，确认控制器、AutoShop 版本、工程类型和当前可达的 L1–L4 等级。
每次构建前必须执行 scripts/validate_autoshop_sbr_source.ps1，自定义符号要由声明清单覆盖，清单需给出工程内相对路径、实际 SHA-256 和 folder.txt 注册关系。
用户在 AutoShop 里按实际型号建好空白工程后，命中已核验的 6.2 真空白 MAIN 档案时，可以在候选副本中创建 ST 子程序并生成原生 TRUE → CALL SBR_AI_MAIN；目前仅支持 BOOL 变量，INT/REAL、数组、结构体、FB 实例仍需先在工程里准备好。
修改既有 ST 走 inspect → extract → 文本层生成补丁 → 再次授权 → write，写回时做加密—解密往返校验、尾部逐字节保持、旁路备份与原子替换，失败自动恢复备份。

交付等级只认结构化证据：L1 待导入源码包、L2 已写入对象、L3 真实全量编译通过、L4 单独授权后下载 PLC。自然语言里说“编译通过了”不算数。

适用边界与注意点

不支持其他品牌 PLC，纯 HMI 设计、机械电气选型、绕过密码、未知工程格式均不适用。
不能从零生成任意原生 LD 网络、元件或工程节点，只能输出 LD 网络规格供人工创建，或在兼容模板副本里替换 MAIN 中唯一的普通设备地址。
Easy301 只是首个完成编译 QA 的示范型号，不是白名单；其他型号必须用对应 AutoShop 环境保存、关闭重开、全量编译后再确认。
工程内部平台码不等于 PLC 对外型号，QA 要同时记录 controller_display 和 project_internal_model_code。
AutoShop 打开时只允许只读提取，写回会直接拒绝；PLC 下载、在线改写、强制 I/O、轴动作都要单独授权。