suyu_two/docs/ai/handoff.md

Current Handoff

• Goal: 完成综合平台编程器的结构化梯形图、HMI、离线仿真和 Modbus RTU 真机链路
• Branch: main
• Current status: 第 1~10 步的软件实现与自动化测试已完成，待连接 XDH-60T4-E 进行真机安全验证和整理最终交付资料

当前能力

• 梯形图条件使用递归 Node / Series / Parallel 表达式树，可表示 A OR (B AND C) 和嵌套串并联
• 编辑器使用固定行列网格和正交连线，支持当前节点后串联、单节点并联、连续节点范围并联、删除节点或网络以及设置输出线圈
• 画布只选择可见节点，不暴露内部表达式容器；橡皮框或多选连续节点后可直接建立并联支路
• 执行器递归求值并生成节点、表达式、网络轨迹，离线运行时画布显示导通路径和故障位置
• HMI 和梯形图直接配置 M/D 地址，不依赖预先创建的数据点
• ActiveRegisterRepository 在离线虚拟仓库与 PLC 缓存仓库之间切换
• PlcCommunicationService 使用 Qt SerialBus 异步连接、轮询和单点写入，UI 不阻塞
• 真机连接收集 HMI 和梯形图实际引用地址，按 M/D 分区并合并相邻地址读取
• 真机模式要求首次读取完成，不复制离线值，不运行 PC 软件逻辑执行器
• 通信错误停止轮询并保留最后一次有效缓存，状态栏和日志显示错误
• 主窗口静态控件已迁入 main_window.ui，PLC 参数由独立配置对话框收集后再发起连接

关键决策

• 工程格式继续使用 1.0，当前文件只保存 HMI 和梯形图表达式树，不保留 dataPoints 结构及兼容代码
• 不读取旧的 stages/branches 结构，不添加旧格式迁移和兼容层
• 梯形图编辑结构而不是自由线段，避免悬空线、环路和多个输出路径
• 网格仅作为编辑投影，不进入工程格式；服务层把连续范围操作转换为规范化表达式树
• 条件节点继续使用 std::variant 的独立配置类型，不向通用节点添加无关字段
• HMI、梯形图和通信共享 M0~M4000、D0~D4000 地址范围
• 已删除统一数据点表、主窗口数据点 Dock 和属性区数据点下拉框；软元件注释功能待后续按信捷业务单独设计
• PLC 读写使用从 0 开始的原始 Modbus 地址
• HMI 写请求不乐观修改 PLC 缓存，由下一次轮询确认真实值
• 真机运行时 PLC 内部程序是控制源，软件逻辑执行器保持停止

自动化验证

以下测试均已完成干净构建并通过：

• domain_tests
• logic_editor_service_tests
• offline_simulation_service_tests
• project_management_tests
• hmi_editor_service_tests
• runtime_mode_service_tests
• plc_runtime_tests
• main_window_tests

main_window_tests 还覆盖 PLC 配置参数往返、独立配置弹窗入口，以及主窗口不再内嵌串口参数控件。

本轮已完整删除统一数据点业务，包括领域模型、服务、主窗口 Dock、属性区下拉框、JSON 字段和独立测试工程。当前开发阶段不保留 dataPoints 旧结构的迁移或兼容逻辑。主窗口测试明确验证已删除控件不存在，PLC 轮询测试改为验证从 HMI 实际绑定收集地址。

本轮梯形图编辑重构还验证了：固定网格渲染、水平/垂直正交布线、工具栏直接建立并联支路，以及连续范围 A AND ((B AND C) OR D) 的结构变换和非连续范围拒绝。

Qt Release 应用已完成干净构建，并执行了启动与正常退出冒烟验证。git diff --check 无空白错误。

待完成事项

1. 在 PLC STOP 状态确认 COM2 参数和 RS-485 A/B 接线
2. 用安全测试地址读取 M0、D0
3. 写入 M0、D0 并由 PLC 监控和下一次轮询确认
4. 验证断线、超时和重新连接流程
5. PLC 切换 RUN 后执行完整 HMI 与设备联动测试
6. 整理测试记录、构建说明和演示工程

建议下一步

运行 Release 应用，配置实际 COM 口、站号、波特率和校验方式，在 PLC STOP 状态完成 M0、D0 首次安全读写。未确认设备程序与负载安全前不要在 RUN 状态写控制地址。