执行摘要

• 一句话：为 DeepSeek-V3 MoE 模型添加 veomni 引擎参数映射支持。
• 推荐动作：该 PR 变更简单，适合快速了解 veomni 引擎如何扩展新模型支持。但需注意 review 中提到的映射 bug，建议后续关注相关修复 PR。

功能与动机

根据 PR body 和 Issue 评论，需要为 DeepSeek-V3 MoE 模型添加 veomni 引擎支持。作者 Luosuu 在评论中说明已通过端到端 moonlight 训练验证兼容性，因此复用现有 Qwen3-MoE 的映射逻辑即可。

实现拆解

1. 修改映射表：在 verl/workers/engine/veomni/utils.py 文件的 MOE_PARAM_HANDERS 字典中新增键值对 "deepseek_v3": _map_moe_params_qwen3_moe，使 DeepSeek-V3 复用 Qwen3-MoE 的参数映射处理器。
2. 复用现有逻辑：没有新增函数或修改现有映射逻辑，仅扩展配置映射，因此无需配套测试或文档变更。

关键文件：

• verl/workers/engine/veomni/utils.py（模块 veomni引擎；类别 source；类型 configuration；符号 MOE_PARAM_HANDERS）: 这是唯一变更文件，修改了 veomni 引擎的 MoE 参数处理器映射表，直接决定 DeepSeek-V3 模型能否正确映射参数。

关键符号：_map_moe_params_qwen3_moe

关键源码片段

verl/workers/engine/veomni/utils.py

这是唯一变更文件，修改了 veomni 引擎的 MoE 参数处理器映射表，直接决定 DeepSeek-V3 模型能否正确映射参数。

# verl/workers/engine/veomni/utils.py
# MOE_PARAM_HANDERS 字典映射模型名称到对应的 MoE 参数处理器函数
MOE_PARAM_HANDERS = {
    "qwen3_moe": _map_moe_params_qwen3_moe, # 原有 Qwen3-MoE 映射处理器
    "deepseek_v3": _map_moe_params_qwen3_moe, # 新增：DeepSeek-V3 复用同一处理器
}
# 注意：_map_moe_params_qwen3_moe 函数可能存在 bug，会重复追加 .weight 后缀，
# 但本 PR 仅扩展映射，未修复该问题。

评论区精华

review 中 gemini-code-assist[bot] 指出复用 _map_moe_params_qwen3_moe 会传播一个已知 bug：该处理器无条件在参数名后追加 .weight，而传入的 name 可能已包含后缀（如 .weight 或 .bias），导致生成错误键名（如 ...weight.weight）。作者 Luosuu 回复“not in this PR's scope”，表示本次 PR 范围仅限于添加映射条目，不修复此 bug。gemini-code-assist[bot] 建议为 deepseek_v3 创建单独的正确处理器以避免传播问题，但未被采纳。

• 复用存在 bug 的映射处理器 (correctness): 作者 Luosuu 表示此 bug 修复不在本 PR 范围内，维持复用决定。

风险与影响

• 风险：主要风险是复用存在 bug 的映射处理器 _map_moe_params_qwen3_moe，可能导致 DeepSeek-V3 的 MoE 参数映射键名错误（如生成 .weight.weight），影响参数加载或训练正确性。但由于作者已验证端到端训练兼容性，实际风险可能已缓解。此外，这是单行配置变更，引入新逻辑风险低。
• 影响：对用户：DeepSeek-V3 MoE 模型现在可以在 veomni 引擎下自动进行参数映射，支持相关训练任务。对系统：扩展了 veomni 引擎的模型支持范围，但依赖现有可能不完美的映射逻辑。对团队：无需额外学习成本，因为复用现有模式。
• 风险标记：复用已知有缺陷的逻辑

关联脉络

• PR #5900 [veomni] feat: bump veomni to v0.1.8: 同属 veomni 模块的近期 PR，涉及 veomni 升级和功能增强，本 PR 可视为其模型支持范围的扩展。