版本变更记录

记录协议文档版本变化、影响范围与验证状态，便于研发、测试、实施统一对齐。

记录

日期	版本	变更摘要	影响协议	影响项目	兼容性	验证状态	责任人
2026-05-08	v1.1.2-docs	注册平台业务参数新增 testMode；#LOGIN-RETURN 完整下发新增第 12 字段；NCS02-C 开放协议 productCategory = 5 且 testMode = 1 时业务 MQTT 改为明文收发，普通模式继续使用 AES	注册平台+开放	NCS02-C	部分兼容：旧完整业务参数需追加 testMode；testMode = 0 继续 AES	已按 NCS02-C 代码对照；MQTTools 静态检查和实机联调通过	AI/待指定
2026-04-28	v1.1.1-docs	NCS20 纳入双协议支持矩阵；补充 Air8000T、20 路继电器、TM1650、RC522、10 颗 BL0939、掉电检测等硬件参数与外设能力文档	私有+开放	NCS20	向后兼容，协议字段不变	初次下载测试完成，待外设逐项联调	AI/待指定
2026-04-25	v1.1.0-docs	私有协议升至 V2.0.8、开放协议升至 V1.1；补齐设备生成 orderId、rateModelId 闭环、心跳/掉电摘要追加订单和费率模型、#7 迁移期尾部字段、#RATE_SET 活跃充电数、自停队列重试与恢复会话超时策略	私有+开放	NCS01/NCS02/NCS06/NCS10/NCS12	尾部追加字段，向后兼容旧解析；旧版保留归档	实机测试完成，暂未发现问题；静态回归通过	AI/待指定
2026-04-21	v1.0.0-docs	开放协议升至 V1.0，私有协议升至 V2.0.7；旧版全文归档；按 NCS 模板代码修正 #REGISTER、#RATE-*、私有 orderId、#1/#2/#7/#B/#REBOOT 字段	私有+开放	NCS01/NCS02/NCS06/NCS10/NCS12	向后兼容，旧版保留归档	已完成代码对照，待联调验证	AI/待指定
2026-04-21	v1.0.0-code	新增 core/proto_ops.lua，收敛开放/私有适配器的协议无关业务动作；同步 11 个 NCS 模板共享协议主干	私有+开放	NCS01/NCS02/NCS06/NCS10/NCS12	向后兼容，报文格式保持当前代码行为	已完成静态同步检查，待设备验证	AI/待指定
2026-04-20	v0.5.0-docs	新增协议同步自动化检查脚本，检测“改代码未改协议文档”场景	私有+开放	NCS全系	向后兼容	已完成脚本落地+文档构建	AI/待指定
2026-04-20	v0.4.0-docs	新增仓库级 PR 模板，固化代码/协议双向同步检查流程	私有+开放	NCS全系	向后兼容	已完成模板落地+文档构建	AI/待指定
2026-04-20	v0.3.0-docs	完整化指令索引，补充开放协议和私有高频指令映射	私有+开放	NCS01/NCS02/NCS06/NCS10/NCS12	向后兼容	已完成文档核对+构建	AI/待指定
2026-04-20	v0.2.0-docs	回填 NCS 协议支持矩阵，按主线代码确认双协议覆盖与待纳入项目	私有+开放	NCS01/NCS02/NCS06/NCS10/NCS12/NCS20/NDSK	向后兼容	已完成代码路径核验+文档构建	AI/待指定
2026-04-20	v0.1.0-docs	初始化内部全量协议站点与协作文档	私有+开放	NCS全系	向后兼容	已通过文档构建	AI/待指定

填写规范

1. 每次字段、指令、时序或代码共享边界变化必须新增一条记录。
2. “影响项目”至少写明受影响的 NCS 产品线。
3. “兼容性”建议使用：向后兼容、部分兼容、不兼容。
4. 变更记录应与 NCS协议支持矩阵 和 指令索引 保持一致。