suyu_two/docs/ai/handoff.md

当前开发交接

更新日期：2026-08-26。本文件只保留当前工作区、本轮验证和下一步。

当前状态

• 当前窗口需求.md 的多字数值扩展已完成：现有 Int16/Float32 链路已扩展为 Int16/Int32/Float32/Float64
• HMI 数值显示/输入、编辑态数据监控、运行态自由监控、离线初始值、工程 JSON、地址冲突检查、PLC 轮询和 Modbus 写入均使用同一套类型与连续字规则
• 项目仍只生成和运行本地 HMI/梯形图仿真，不生成、编译或下载 PLC 程序；真机本地梯形图轨迹仍只读 PLC 缓存并在临时仓库推算
• 本轮没有实现 Int64、无符号数、二/八/十六进制、ASCII、POU 变量监控、信捷原版寄存器网格或自定义监控偏移
• TouchWin 没有原生 Double64 数值控件；本项目的 Double (Float64) HMI 是基于 PLC 连续四个 D 的增强能力

类型与地址规则

类型	占用字数	起始地址	输入规则
Int16	1	D0~D4000	-32768~32767 的整数
Int32	2	D0~D3999	-2147483648~2147483647 的整数
Float32	2	D0~D3999	有限 IEEE-754 单精度值
Float64	4	偶数 D0~D3996	有限 IEEE-754 双精度值

• 多字值固定按信捷顺序保存：低地址是低 16 位，地址递增时依次保存更高的 16 位
• Int32Codec、Float32Codec、Float64Codec 和统一数值 variant 负责类型化读写；底层仓库仍只保存原始 16 位字
• Float32 显示 9 位有效数字，Double 显示 17 位有效数字；浮点输入使用 C locale 并支持科学计数法，NaN、Inf 和溢出值拒绝
• Double 奇数首地址、Int32/Float32 的 D4000、Double 的 D3997 及其他越界范围在领域层拒绝

HMI、监控与工程

• HMI 属性面板和运行输入支持四种 D 类型；Int16/Int32 使用整数输入，Float32/Double 使用科学计数法文本输入
• HMI 多字绑定按完整字范围检查：相同地址和相同类型允许重复绑定，部分重叠或同起始地址不同类型拒绝
• MOVE、ADD、SUB 仍是 16 位整数指令，禁止写入任何 Int32、Float32 或 Float64 HMI 值占用的 D
• 编辑态数据监控和运行态自由监控继续共用 RegisterMonitorService；Int32/Float32 批量步长为 2，Double 步长为 4，类型列显示完整占用范围
• 多字离线初始值按连续字块完整捕获；停止仿真后恢复 Int32/Float32/Double 的全部占用字
• 监控表最多 64 行，PLC 上限按去重后的实际 16 位 M/D 地址计数，最多 256 个；候选监控集合会在提交前验证，失败不留下部分监控点
• 工程 JSON 仍是严格 formatVersion: "2.0"，dataType 新增 int32 和 float64；未知的 int64 等枚举直接拒绝

PLC 通信

• 仓库增加通用 readWords/writeWords 连续字接口；虚拟仓库完整校验后一次复制，PLC 仓库保留 Int16 单字通道并为 2~4 字值使用多字通道
• Int16 继续写一个 Holding Register；Int32、Float32 和 Double 分别把 2 个或 4 个连续字放在一次多寄存器请求中发送
• 轮询元数据从 Float32 起始地址泛化为连续 RegisterWordRange；每个读块最多 120 字，拆块边界不会切开 2 字或 4 字值
• 地址和多字范围在当前异步回复结束后一起切换；候选配置失败时运行模式和监控模型都恢复旧状态
• PLC 缓存仍只在真实轮询读回后更新，不以写请求受理代替设备确认

最近验证

• 13 个 Release Functional 测试目标全量通过
• 新增回归覆盖 Int32 最小/最大值和负数、Float32 20.0 字序、Double 1.0 字序、Double 偶数地址、NaN/Inf、JSON 往返、HMI 复制粘贴、多字冲突和 16 位梯形图写入保护
• 监控回归覆盖四类型批量步长、完整轮询地址、离线初始值捕获、停止仿真恢复、64 行与 256 实际地址上限的候选拒绝
• PLC 回归覆盖 Int16 单字路径、Int32/Double 一次多字回调、Double D118~D121 不跨 120 字边界、无法合法拆分的重叠范围拒绝和地址集合原子切换
• Qt Release 主程序已重新构建到 build/release/release/integrated_platform.exe，离屏启动 3 秒正常保持事件循环
• git diff --check 通过；工作区只有 runtime_mode_service_tests.cpp 的 CRLF/LF 转换提示，没有空白错误
• 当前 Windows 没有枚举到串口设备，无法使用 COM3 / 9600 / 8E1 / 站号 1 做真实 PLC 多寄存器写入，因此本轮没有伪造真机结果

工作区与下一步

• 当前改动尚未提交 Git
• 开始本轮前已有的 docs/工程格式说明.md、docs/用户使用/数量边界确认方案.md 和旧交接修改均已保留并增量合并，没有回退来源不明的改动
• 设备可用后在 PLC STOP 状态先读取一组连续 D 原值，分别验证 Int32、Float32、Double 的一次多寄存器写入与读回，再恢复全部原值并读回确认
• 人工打开 HMI 页面和数据监控，检查四类型下拉框、Double 偶数地址提示、长数值显示和不同系统缩放下的输入框布局