合并受阻
Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
PR Approval Progress
⚠️ This PR does not yet meet the following requirements:lgtm (requires ≥ 2 person(s) per module)、approve (requires ≥ 1 person(s) per module)
Module Approval Details
| module | lgtm status | approve status |
|---|---|---|
| docs | ❌ (0/2)(You can also ask: 王海涛, 陈志国, 贾丽欣, LQ1206, kali00) | ❌ (0/1)(You can also ask: 王海涛, 朱彦儒, cxiaolong, bigdog1206, 陈志国) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
qiuruiyu531, thanks for your pull request. All authors of the commits have signed the CLA. 👍
变更摘要
本次 PR 新增了 MindSpeed MM Megatron 后端模型迁移指南文档 docs/zh/features/megatron_developer_migration_guide.md，总计 651 行。该指南以 pretrain_vlm.py 和 examples/qwen2.5vl（7B）为主线，端到端覆盖 Megatron 后端下的模型迁移全流程，与已合入的 FSDP2 迁移指南形成双后端对称文档体系。文档内容涵盖后端路线识别、组装式模型接入、数据接入、启动与并行配置、权重转换及精度对齐等关键环节，面向首次接触仓库的开发者提供可操作的迁移参考。
主要改动
- 新增 Megatron 后端迁移指南文档：创建
docs/zh/features/megatron_developer_migration_guide.md，提供从后端路线识别到精度对齐的完整迁移流程，覆盖Megatron与FSDP2后端的选择对比及仓内案例索引。 - 组装式模型接入说明：系统描述组件库 + 组装类 +
layer_specs的模型构建方式，以及model.json、pipeline_num_layers、freeze等关键配置项的用法。 - 数据接入与启动配置指导：说明
data.json配置、模板/collator 登记点，以及 TP/PP/CP/GBS 并行策略推导、分布式优化器和融合算子的启动脚本配置方法。 - 权重转换与精度对齐方法：介绍
mm-convert工具、转换器结构与TP patterns，并给出确定性计算的跑通确认与精度对齐方案。
What this PR does / why we need it?
新增 MindSpeed MM Megatron 后端模型迁移指南
docs/zh/guides/development/megatron_model_migration_guide.md。对应社区任务 issue：https://gitcode.com/Ascend/MindSpeed-MM/issues/383（交付件 1：迁移指南）
实践文档 issue#481
性能优化文档 issue482
指南以
pretrain_vlm.py+examples/qwen2.5vl（7B）为主线，端到端覆盖：后端路线识别（vs FSDP2）、迁移前准备与仓内案例索引、训练入口与五大回调、组装式模型接入（组件库 + 组装类 + layer specs、model.json、pipeline_num_layers、freeze）、数据接入（data.json、模板/collator 登记点）、启动脚本与并行配置（TP/PP/CP/GBS 推导、分布式优化器、融合算子）、权重转换（mm-convert、转换器结构与 TP patterns）、跑通确认与精度对齐方法（确定性计算），并与已合入的 FSDP2 迁移指南（fsdp2_developer_migration_guide.md）形成双后端对称文档。Does this PR introduce any user-facing change?
文档新增，无代码变更。新增文档路径：
docs/zh/features/megatron_developer_migration_guide.md。How was this patch tested?
文档类变更，无代码。已做以下验证：
--flag均在mindspeed_mm/arguments.py或仓内 examples 脚本中真实存在；