常见问题
按主题归类。仍无法解决时，可到 GitHub Issues 提问。
连接与发送
连接测试成功，发送却失败？
连接测试只确认 TCP 端口能连上，不会发送 HJ212 报文，也不验证 MN、PW。 发送失败请看日志里的 ACK 或错误：常见是 MN 未在平台登记、密码不对、服务端处理超时。
日志显示「等待 ACK 超时」？
- 服务端较慢时，把 ACK 超时调到 10000～30000 ms
- 开了「模拟网络延迟」或「慢速传输」时，超时建议 ≥ 延迟时间 + 3000 ms
- 平台若不回应答，超时是预期现象；可先点「预览报文」确认帧本身无误
为什么提示请填写 MN？
因子组帧必须填写设备 MN。并发模式下改在右侧 MN 列表填写，且至少启用一行非空 MN。 原文推送则读报文里的 MN，连接区可以不填。
发送按钮是灰的？
因子组帧至少勾选一个因子；原文推送至少粘贴一段报文；并发模式至少启用一个已填 MN 的行，并勾选因子。
报文与解析
解析显示 CRC 校验失败？
帧被截断、手工改过数据段却没重算校验、或长度字段与实际不符，都会失败。 内容仍会尽量解析。可把同一段放到「原文推送」里只贴 body，让程序重新补 CRC 再发出。
日数据的 CN 为什么是 2031？
本程序水 / 气日报文使用 CN=2031。部分资料会写 2071，那是另一套命令划分。
联调时以对接平台要求为准，必要时用原文推送自行指定 CN。
旧设备编码 011、B01 怎么办？
发送时把「报文编码」切到「旧版编码」。解析页会把旧码映射到标准码并显示中文名称。
支持 HJ 212—2025 的数据段加密吗？
目前不支持。程序按明文组帧、明文解析，用于未强制加密的联调环境。 密钥协商与 SM4 加密尚未实现。
模拟并发
导入 MN 列表失败？
- 先下载模板，保留列名：MN、启用、数据类型
- 启用列用
1/0；数据类型用 实时 / 分钟 / 小时 / 日，或 2011 / 2051 / 2061 / 2031 - 支持
.xlsx/.xls/ CSV / TSV
安装与打包
启动后要输入什么才能进软件？
首次启动须阅读声明，在输入框准确输入「我已知晓」（不要多空格）。确认后会记在本机，下次一般不再弹出。
macOS 打包失败，提到时间戳服务器？
本地打包默认跳过开发者证书签名。不要设 MAC_SIGN=1，直接 npm run build:mac。
需要正式签名 / 公证时再使用 MAC_SIGN=1 npm run build:mac，并保证能访问 Apple 时间戳服务。