端侧 AI · 交付
生产环境如何固定本地模型版本
发布与派生数据绑定精确 artifact identity，直到显式迁移。
主查询：固定本地模型版本 · 核验：2026-09-16 · 事实卡：COVE-MODEL-02, ARCH-01
先给结论
生产环境的本地模型版本必须与发布数据严格绑定到精确的 artifact identity，在未执行显式迁移流程前，禁止通过任何推断手段覆盖或变更该标识。这种绑定关系贯穿模型加载与运行的完整生命周期，确保线上行为与历史记录一致，杜绝因标识漂移引发的隐性故障。
需要先收集的证据
至少把下面三项与同一个 artifact、运行时和任务绑定：
- artifact manifest
- App release 映射
- 升级回滚测试
若缺一项，就把它写成未知，不要用模型参数、芯片宣传或网上截图代替。
实施流程
运维过程中需持续记录并对比三项核心证据：artifact manifest 明确记录模型与发布版本的对应关系；App release 映射反映客户端或服务端版本与模型产物的关联；升级回滚测试则用于验证版本切换与回退路径的可靠性。所有变更只有在上述证据完整留存并核验通过后，方可推进。
- 固定来源与 revision
- 记录长度与 digest
- 下载到临时文件
- 安全续传与验证
- 完成后再切换
- 提供修复与回滚
最容易写错的地方
- 跟随可变 latest
- 静默迁移派生数据
实践中常见的两类错误模式必须严格规避：一是跟随可变的 latest 标签拉取模型，导致运行版本与发布意图脱节；二是对派生数据进行静默迁移，使得旧版本数据在未声明的前提下被新模型消费。基于现有记录可以确认，遵循 artifact identity 绑定的发布过程能够避免上述风险，任何超出记录的版本一致性结论均无法在本机制内成立。
最小复现记录
| 层 | 必须记录 |
|---|---|
| 设备 | 型号、芯片、系统、RAM 档位 |
| 软件 | App 版本与 git commit |
| 模型 | 家族、变种、revision、格式、长度、hash、量化 |
| 运行时 | 版本、请求后端、实际后端证据 |
| 任务 | fixture、输入 hash、prompt hash、输出规则 |
| 结果 | 完成、失败、取消、回退与恢复 |
发布检查单
- 目标查询已在开头直接回答。
- 所有数字都能回到事实卡或原始记录。
- artifact、runtime、设备与任务没有混淆。
- 失败、取消、清理与回退都被测试。
- 隐私和网络边界单独说明。
- 结论只适用于记录中的配置。
事实来源与延伸
本页使用奇连 AI 的端侧事实卡镜像，性能结论等待 Cove 原始 benchmark 数据。