执行摘要

• 一句话：将 XPU MoE 实现移至 experts/ 子目录
• 推荐动作：该 PR 值得快速合并，它是 MoE 子系统代码组织改进的一部分。主要关注点是确保所有导入路径已正确更新，这已通过 CI 验证。

功能与动机

此 PR 是对 MoE 子系统进行持续重构的一部分，旨在将特定后端（XPU）的专家实现统一放置在 experts/ 子目录下，以改善代码组织并与其他后端（如 deep_gemm_moe、batched_deep_gemm_moe）的布局对齐。

实现拆解

1. 移动文件并重命名：将 vllm/model_executor/layers/fused_moe/xpu_fused_moe.py 重命名为 vllm/model_executor/layers/fused_moe/experts/xpu_moe.py，文件内容保持不变。

2. 更新包入口 __init__.py：在 vllm/model_executor/layers/fused_moe/__init__.py 中，将导入语句从 xpu_fused_moe 修改为 experts.xpu_moe，并新增了 XPUExpertsMXFp4 的导入及 __all__ 导出，使 intel-gpu 的 MXFP4 后端也可通过包入口访问。

3. 更新 Oracle 后端引用：在三个 Oracle 文件（oracle/fp8.py、oracle/mxfp4.py、oracle/unquantized.py）中，将所有对 vllm.model_executor.layers.fused_moe.xpu_fused_moe 的导入路径改为 vllm.model_executor.layers.fused_moe.experts.xpu_moe。

4. 更新 CI/基础设施配置：在 .github/mergify.yml 中，将自动标记 intel GPU 相关 PR 的文件匹配规则从 xpu_fused_moe.py 更新为 experts/xpu_moe.py。

关键文件：

• vllm/model_executor/layers/fused_moe/experts/xpu_moe.py（模块 专家层；类别 source；类型 rename-or-move；符号 XPUExperts, XPUExpertsFp8, XPUExpertsMXFp4）: 被重命名/移动的核心文件，XPU MoE 专家实现的新位置。
• vllm/model_executor/layers/fused_moe/__init__.py（模块 包入口；类别 source；类型 data-contract；符号 XPUExperts, XPUExpertsFp8, XPUExpertsMXFp4）: 包入口，修改导入语句并新增 XPUExpertsMXFp4 的导出。
• vllm/model_executor/layers/fused_moe/oracle/fp8.py（模块 量化入口；类别 source；类型 data-contract；符号 XPUExpertsFp8, prepare_fp8_moe_layer_for_xpu）: FP8 量化后端 Oracle，更新了 XPU 相关类的导入路径。
• vllm/model_executor/layers/fused_moe/oracle/mxfp4.py（模块 量化入口；类别 source；类型 data-contract；符号 XPUExpertsMXFp4）: MXFP4 量化后端 Oracle，更新了导入路径。
• vllm/model_executor/layers/fused_moe/oracle/unquantized.py（模块 量化入口；类别 source；类型 data-contract；符号 XPUExperts）: 未量化后端 Oracle，更新了导入路径。
• .github/mergify.yml（模块 CI 配置；类别 infra；类型 infrastructure）: CI 配置，更新了 intel GPU 文件匹配规则以反映新路径。

关键符号：未识别

关键源码片段

vllm/model_executor/layers/fused_moe/__init__.py

包入口，修改导入语句并新增 XPUExpertsMXFp4 的导出。

# vllm/model_executor/layers/fused_moe/__init__.py (HAS_TRITON 分支 )
from vllm.model_executor.layers.fused_moe.experts.xpu_moe import (
    XPUExperts,
    XPUExpertsFp8,
    XPUExpertsMXFp4, # 新增：MXFP4 专家类
)
​
__all__ += [
    # ... 已有符号 ...
    "XPUExperts",
    "XPUExpertsFp8",
    "XPUExpertsMXFp4", # 新增导出
]

vllm/model_executor/layers/fused_moe/oracle/fp8.py

FP8 量化后端 Oracle，更新了 XPU 相关类的导入路径。

# vllm/model_executor/layers/fused_moe/oracle/fp8.py
elif backend == Fp8MoeBackend.XPU:
    # 更新后的导入路径
    from vllm.model_executor.layers.fused_moe.experts.xpu_moe import (
        XPUExpertsFp8,
    )
    return [XPUExpertsFp8]

评论区精华

Review 评论：gemini-code-assist[bot] 指出在 __init__.py 的导入块中遗漏了 XPUExpertsMXFp4，但作者在后续提交中已修复（在 __all__ 中添加了该符号）。此外，PR 描述中提到使用了 AI 辅助生成变更，但未引发其他技术讨论。

• XPUExpertsMXFp4 导入遗漏 (correctness): 已修复：作者在后续提交中在 init.py 的导入块中添加了 XPUExpertsMXFp4。

风险与影响

• 风险：本 PR 仅为文件重命名和路径更新，不涉及逻辑变更。主要风险是引用遗漏：如果代码库中存在未更新的动态导入或硬编码路径，可能导致运行时 ImportError。相关的 Oracle 文件（oracle/fp8.py、oracle/mxfp4.py、oracle/unquantized.py）已更新，但需确认是否还有第三方或插件代码依赖旧路径。

• 影响：用户影响：无直接用户可见影响，功能完全保持向后兼容。
  系统影响：XPU MoE 后端的导入路径变更，但所有内部引用已更新，CI 配置也已同步。
  团队影响：为后续将更多后端专家类迁移到 experts/ 目录奠定了基础，提高了代码库的组织一致性。

• 风险标记：导入路径变更, 需验证无其他外部引用

关联脉络

• PR #40671 [MoE Refactor] Rename FusedMoE.make_expert_params_mapping to fused_moe_make_expert_params_mapping: 同一 MoE 重构系列，涉及 fused_moe 内部的重命名和代码组织改进。
• PR #39402 [kv_offload+HMA][10/N]: Support load with multiple KV groups: 涉及 MoE 专家调度器，可能与 experts/ 目录结构有关联。