模型版本管理不能仅靠文件名，必须固化完整可复现的推理上下文；应结合DVC+Git追踪模型、结构化记录元数据（model_card.yaml）、并增加数字签名与校验以保障可信性。
模型版本管理为什么不能只靠文件名
把模型存成 model_v1.pth、model_v2_fixed.pth 看似简单，实际会快速失控。训练环境差异（PyTorch 1.12 vs 2.0）、数据预处理逻辑变更、甚至随机种子微调，都可能让“v2”在另一台机器上复现失败。版本管理的核心不是标记序号，而是**固化完整可复现的推理上下文**。
用 DVC + Git 实现轻量级模型追踪
DVC（Data Version Control）专为大文件（如模型权重、数据集）设计，不把二进制文件塞进 Git，而是用 Git 管理元信息（.dvc 文件），用远程存储（S3、MinIO、本地路径）存真实模型。操作流程清晰：
- 初始化：运行
dvc init（自动生成 .dvc/ 目录和配置） - 追踪模型：执行
dvc add models/bert-base-finetuned.pt→ 生成models/bert-base-finetuned.pt.dvc，Git 提交该 .dvc 文件 - 推送模型：运行
dvc push将实际权重上传至远程存储 - 复现时：先
git checkout experiment-202405，再dvc pull下载对应版本模型
优势在于：Git 历史里能直接看到某次 commit 关联了哪个模型哈希；团队成员只需拉代码 + dvc pull，无需手动下载或校验 md5。
模型元数据必须结构化记录
仅靠 DVC 还不够——它不描述“这个模型是干什么的”。建议在每次训练完成时，自动生成一个 model_card.yaml 并随模型一同提交。内容至少包括：
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
立即学习“Python免费学习笔记（深入）”；
- task: "ner" / "image-classification"
- metrics: { "val_f1": 0.892, "test_acc": 0.921 }
- training_config: { "lr": 2e-5, "batch_size": 16, "max_len": 128 }
- data_version: "dataset-v3.2.1"（同样用 DVC 管理数据）
- framework_version: "transformers==4.38.2, torch==2.1.2"
可写个简单 Python 脚本，在训练脚本末尾自动 dump 这个字典，避免人工遗漏。
生产部署前加一道模型签名与校验
上线模型前，用私钥对模型文件做数字签名，部署服务启动时用公钥验证。这不是过度设计——它能拦截中间人篡改、误覆盖、CI/CD 流水线异常等风险。
- 签名：用
openssl dgst -sha256 -sign private.key -out model.pt.sig model.pt - 校验：服务加载模型前执行
openssl dgst -sha256 -verify public.key -signature model.pt.sig model.pt - 把 model.pt.sig 和 model_card.yaml 一起纳入 DVC 管理，确保签名与模型强绑定
签名本身很小，不影响部署效率，却给模型生命周期加上关键可信锚点。
