李傲天做这次“帧对比”项目的时候，我一开始真没太当回事。无非是把2024年固件版本和2026年固件版本跑出来的帧记录拉在一起，把里面的变量挨个比一遍，看看谁变了、谁删了、谁又冒出来了。结果第一版脚本跑出来的结果几乎全是红色的“差异”，细看又全是假阳性，最后定位到的问题不是数值编码变了，不是变量单位变了，而是路径字段一会儿给绝对路径、一会儿给相对路径，搞得同一个源文件被识别成了两个毫不相关的东西。这篇文章想把这次的排查思路、路径处理逻辑和版本适配经验完整记录下来，给同样在做跨版本帧数据对比、变量字典核对、源文件定位这类工作的朋友做个参考。
1. 为什么“帧里带个变量路径”会让对比翻车
先说清楚这里说的“帧”是什么。在很多工程场景里，帧不一定是以太网帧或者CAN总线帧那种底层数据包，它也可以是某个采集程序周期性打出来的数据快照：一次完整的采集周期内，系统把一批可观测变量塞进同一个结构体或同一行JSON里，再连同时间戳、帧ID一起输出，这就是一帧数据。帧是一个“集装箱”，变量是里面的货物，路径是货物上贴的标签。问题恰恰出在这张标签上。
2024年版本输出的帧记录，变量用的是小写风格命名，路径字段叫source_abs，给的是开发机上完整的绝对路径，比如D:/workspace/v2024/calib/sensors/temp.json。2026年版本升级之后，命名规范变成了带模块前缀的大写风格，字段也改成了origin，而且存的是相对路径，比如calib/sensors/temp.json。
第一版对比脚本直接按“变量名+值”去diff，结果惨不忍睹：变量名对不上，值又因为2026版从“直接给物理值”改成了“给原始整数再乘scale系数”，几乎没有一个能匹配上。更麻烦的是，哪怕我想用路径来兜底，由于一个是绝对路径一个是相对路径，字符串比对天然就是失败的。
这个翻车过程让我明白了一件看起来很基础但很容易忽略的事：版本数据对比真正要比的不是“两个字符串是否相同”，而是“两帧记录里的业务实体是否指向同一个来源”。变量名可以重命名，字段可以拆掉重组，目录结构可以调整，但那个“来源”必须有一种稳定表达。帧记录里的路径，是我当时能找到的最接近“来源”的锚点。
1.1 变量名并不是稳定的身份标识
为什么不能只靠变量名？2024版里叫temp的变量，在2026版里可能叫CAL_TEMP或者engine_temperature，一旦参与了模块化改造，改名几乎是必然的。反过来，同一个变量名也可能在不同模块下反复出现，比如status这个变量名很常见，你不带前缀、不带路径，根本不知道它在说哪个status。
脚本第一版只认名字，输出差异表的时候把老变量、新变量、同变量改名、同名不同义全部混在一起，人眼没法看。所以我后来把它拆成了三个层面：
- 名字层：显示用，给人看的；
- 值层：对比用，但要做缩放、容差处理；
- 来源层：判定“同一个东西”用的关键。
来源层的技术落地就是路径。但路径本身也有两种形式上的陷阱，这就是下面要展开的绝对路径和相对路径问题。
1.2 跨版本项目重构会引入路径“漂移”
除了格式差异，2024年到2026年之间，源码目录结构也被调整了。有些变量定义文件的相对位置从legacy/calib/temp.json移动到了core/sensors/temperature/default.json，还有一部分变量定义则彻底从独立配置并入了二进制元数据里，不再单独暴露一个可视化路径。
如果对比脚本简单地要求两个版本路径完全一致，那么所有发生过文件移动的变量都会被判定成“删除+新增”，这会严重干扰真正变更的判断。你无法分辨“只是挪了位置”和“真的改了含义”。所以，路径对比不能只做全等判断，还要做一定程度的归一化判断，比如只看文件相对仓库根路径的位置，忽略版本目录名本身。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 先把模型定下来：帧、变量、源路径三者的关系
避免瞎比较的最好方式，是在开始写代码之前先定义一张关系表。这个项目里，我把帧记录模型固定成三个层次，后面所有解析、对比逻辑都围绕这张表来走。
帧（FrameEntry）级别需要记录：
frame_id：两版本都存在的互斥标识，用于对齐采样时刻；timestamp：采集时间，只做参考展示；version_tag：来源版本，例如v2024或v2026；variables：该帧携带的变量列表。
变量（VariableEntry）级别需要记录：
display_name：原文件里看到的变量名，不修改；stable_key：经过归一化后得到的稳定标识，供后续对比；physical_value：统一换算成物理值后的浮点数；raw_value：原始编码值；scale：2026版常见的缩放系数；unit：单位，如rpm、degC；- 来源路径三件套：原始路径、绝对化后的路径、仓库内相对化后的路径。
这个冗余设计不是多余的。原始路径方便追溯；绝对化路径方便人工打开IDE定位；相对化路径则是自动对比时真正用于“找同一个东西”的键。这