执行摘要

• 一句话：Eagle3 新增 norm_output/fc_norm 配置传播
• 推荐动作：值得快速合并。逻辑简单、修复明确、关联 Issue 有完整背景和验证。

功能与动机

Eagle 3.1 训练支持（关联 Issue #610）引入了两个新的配置标志 norm_output 和 fc_norm，用于缓解跨推测深度的注意力漂移，Eagle 3.1（Llama）相比 Eagle 3 平均接受长度提升 7.9%。vLLM 的 Eagle3 模型代码已经通过 getattr 默认值读取这两个字段，但配置处理函数 update_eagle3 从未将它们从检查点字典转移到 PretrainedConfig，导致这些优化在推理时静默失效。PR body 明确指出“Without this fix, Eagle 3.1 checkpoints (which set norm_output=True and/or fc_norm=True) silently fall back to False at inference time”。

实现拆解

在 vllm/transformers_utils/configs/speculators/algos.py 的 update_eagle3 函数中，紧接 norm_before_fc 赋值之后，新增两行：

1. pre_trained_config["fc_norm"] = config_dict.get("fc_norm", False)：从检查点配置中读取 fc_norm 字段，若缺失则默认 False，对应 Eagle 3.1 的逐层归一化功能。
2. pre_trained_config["norm_output"] = config_dict.get("norm_output", False)：读取 norm_output 字段，默认 False，对应将归一化后的隐状态跨 TTT 步骤反馈以稳定幅值漂移。

这两行与已有的 norm_before_fc、norm_before_residual 等字段的处理模式完全一致，保持代码风格统一。没有其他文件变更，也无测试或配置改动。

关键文件：

• vllm/transformers_utils/configs/speculators/algos.py（模块 配置处理；类别 source；类型 core-logic；符号 update_eagle3）: 唯一的变更文件，在 update_eagle3 函数中新增了两行配置传播，使 norm_output 和 fc_norm 能从检查点正确传递到模型配置。

关键符号：update_eagle3

评论区精华

审核人 benchislett 在审批时表示“LGTM. Would also like to see 'fc_norm' if possible”，作者 orestis-z 随后在第二个 commit 中补充了 fc_norm 的传播。没有其他讨论或争议。

• 暂无高价值评论线程

风险与影响

• 风险：风险极低。变更仅增加两行配置读取语句，且默认值均为 False（与之前的行为完全兼容）。若检查点不包含这两个字段，行为无变化；若包含，则只会让已有的模型代码正确接收到配置。没有影响到其他猜测器类型（如 peagle）。缺少测试覆盖是唯一的“风险”，但鉴于其简单性可以接受。
• 影响：
  • 用户影响：Eagle 3.1 检查点用户可获得正确的 norm_output 和 fc_norm 行为，推理时接受长度可能提升（参考实验数据 +7.9%）。非 3.1 用户完全不受影响。
  • 系统影响：无性能、安全或兼容性影响。
  • 团队影响：为未来 Eagle3 特性（如 peagle 的类似配置）树立了处理模式。
  • 风险标记：缺少测试覆盖

关联脉络

• PR #610 feat(eagle3): add Eagle 3.1 training support: 该 PR 是对应 speculators 仓库的训练支持 PR，明确提到需要 vLLM 中配置传播的一行补丁，即本 PR 的动机来源。