用途:在满足框架契约的前提下,把模型层迁移到 MindSpeed-MM FSDP2,并保持源模型语义。适用于需要创建模型插件、新增或修复 model_id 注册与 ModelHub 兼容、适配 from_pretrained 与 _from_config 加载签名、处理特殊 token 与 embedding resize 的场景。不适用于数据预处理或 dataloader 调整、仅涉及 YAML 映射的任务,以及仅为验证阶段的问题分诊。
主要能力:提供注册契约、构建契约、语义契约、训练契约四类必检项;输出模型插件实现、带通过/失败状态的迁移检查清单,以及每处非复用改动的理由说明。
使用方式:输入包括源模型入口文件、目标 model_id、必需的特殊 token 行为、目标配置中的 FSDP2 约束与 runtime_assets.model_path。实施前须校验 runtime_assets.model_path 存在且可读,并对照最相似案例抽取签名模式;实施后产出 model_contract_checklist.md 与 signature_compat_report.md。若 from_pretrained 或 _from_config 任一不兼容,须停止后续阶段。
限制:禁止把 from_pretrained 写成仅单参数签名;禁止仅靠代码阅读判定兼容,须提供调用证据;禁止在未确认 token-id 对齐时修改 token 常量;禁止删除源模型关键后处理逻辑而无等价替代。修改范围仅限模型插件区域,不引入对源仓包路径的外部硬依赖。退出标准为模型可通过 ModelHub 按目标 model_id 构建、加载签名冲突已解决、清单结论均有证据支撑。渐进式资源包括 checks/model-acceptance.md、checks/model-contract-gates.md、errors/model-error-dictionary.md、errors/triage-severity.md、examples/minimal-io.md,仅在需要详细判据时读取。