NCS协议支持矩阵

用于跟踪 NCS 产品线对私有协议和开放协议的支持状态。当前结论来自仓库内 NCS 产品模板代码。

支持状态说明

• 已支持：模板包含 private_adapter.lua、open_adapter.lua、proto_router.lua，并已同步共享协议主干。
• 冻结：设备已停产或换代，仅维持私有协议维护，不再接收开放协议新功能同步。现有 open_adapter.lua 保留但不再更新。
• 待纳入：仓库存在项目目录，但尚未纳入当前双协议统一适配结构。
• 外设差异：协议主干一致，仅保留 SDK 或硬件接入差异。

支持矩阵

产品线	模板项目	私有协议 V2.0.8	开放协议 V1.1	说明
NCS01	NCS01-B	已支持	冻结	已停产；NCS01-B 由 NCS01-C 替代，NCS01-T 无替代
NCS01	NCS01-T	已支持	冻结	即将换代
NCS01	NCS01-C	已支持	已支持	NCS01-B 换代产品
NCS02	NCS02、NCS02-B	已支持	冻结	已停产，由 NCS02-C 替代
NCS02	NCS02-C	已支持	已支持	协议主干一致
NCS06	NCS06	已支持	冻结	已停产，由 NCS06-B 替代
NCS06	NCS06-B	已支持	已支持	协议主干一致
NCS10	NCS10、NCS10-B	已支持	已支持	协议主干一致；产品定位替代 NCS12 系列
NCS12	NCS12、NCS12-B、NCS12-C	已支持	冻结	已停产，产品定位由 NCS10 替代；NCS12-C 仅保留 mobile 显式 require 的 SDK 差异
NCS20	NCS20	已支持	已支持	协议主干已纳入；当前差异集中在 20 路外设层
NDSK	当前仓库目录	待纳入	待纳入	未命中统一 protocols/*_adapter.lua 结构

共享协议主干

以下文件应在标记为「已支持」的模板中保持一致，除明确外设差异外不得分叉：

层级	文件	说明
protocols	open_adapter.lua	开放协议字段解析和响应拼装（冻结项目不参与同步）
protocols	private_adapter.lua	私有协议字段解析和响应拼装
protocols	adapter_utils.lua	协议通用报文辅助；NCS12-C 仅保留 mobile require 差异
core	proto_ops.lua	协议无关业务动作统一层
core	proto_ctx.lua	私有/开放协议上下文与参数恢复
core	proto_router.lua	根据 productCategory 选择协议适配器
core	charge_engine.lua	充电状态、会话一致性、计费和自停核心
core	data_model.lua	运行态、会话费率模型和持久化数据结构
business	charge_sched.lua	心跳、自停重试、重连补发和恢复会话超时处理

冻结项目同步策略

标记为「冻结」的项目（NCS01-B、NCS01-T、NCS02、NCS02-B、NCS06、NCS12、NCS12-B、NCS12-C）：

1. open_adapter.lua 保留现有代码，但不再接收开放协议新功能同步。
2. private_adapter.lua、charge_engine.lua 等私有协议相关文件仍可接收安全修复与缺陷补丁。
3. shared_manifest.json 中对应开放协议条目应标记为 frozen，阻止自动同步覆盖。
4. 若冻结项目需要紧急私有协议补丁，同步操作应跳过 open_adapter.lua 相关文件。

取证来源

• 搜索路径：NCS*/Software/*/protocols/open_adapter.lua、private_adapter.lua、adapter_utils.lua。
• 搜索路径：NCS*/Software/*/core/proto_ops.lua、proto_router.lua、proto_ctx.lua、charge_engine.lua。
• 当前已同步 12 个 NCS 模板，覆盖 NCS01/NCS02/NCS06/NCS10/NCS12/NCS20；NCS20 已完成 2026-04-28 初次下载测试，待外设逐项联调。
• 2026-06-15：标记 NCS01-B、NCS01-T、NCS02、NCS02-B、NCS06、NCS12、NCS12-B、NCS12-C 开放协议为「冻结」，仅维持私有协议维护。