执行摘要

• 一句话：提取 speculative auxiliary hidden state 配置解析到独立模块
• 推荐动作：值得阅读以了解如何通过一系列小步骤逐步提取模块。设计决策：使用 msgspec 结构体封装配置，并拆分为辅助函数。对后续类似重构有参考价值。

功能与动机

作为 ModelRunner 大规模解耦重构的一部分，将不同职责拆分为独立模块，降低 model_runner.py 的复杂度，提高可维护性。

实现拆解

1. 在 model_runner.py 中先将 inline 的解析逻辑封装为 init_spec_aux_hidden_state 方法并测试内联行为正确。
2. 将逻辑原样 cut+paste 到新文件 spec_aux_hidden_state.py，定义 SpecAuxHiddenStateConfig 数据类和 resolve_spec_aux_hidden_state_config 函数。
3. 将主解析函数中的 eagle 和 dflash 分支拆分为独立的 _resolve_eagle_aux_hidden_state 和 _resolve_dflash_aux_hidden_state 辅助函数，主函数仅负责创建配置对象并顺序调用。
4. 更新 model_runner.py 的 import，删除原 inline 代码，改为调用新模块。
5. 对应修改 pool_configurator.py 中三处属性访问 (eagle_draft_num_layers, dflash_draft_num_layers, draft_layers) 从直接读取 mr 属性改为 mr.spec_aux_config 的对应字段。

关键文件：

• python/sglang/srt/model_executor/model_runner_components/spec_aux_hidden_state.py（模块 推测配置；类别 source；类型 core-logic；符号 SpecAuxHiddenStateConfig, resolve_spec_aux_hidden_state_config, _resolve_eagle_aux_hidden_state, _resolve_dflash_aux_hidden_state）: 核心新模块，定义了 SpecAuxHiddenStateConfig 数据类和配置解析函数
• python/sglang/srt/model_executor/model_runner.py（模块 运行器；类别 source；类型 core-logic；符号 init_spec_aux_hidden_state）: 删除约110行内联配置逻辑，改为调用新模块，减少复杂度
• python/sglang/srt/model_executor/pool_configurator.py（模块 池配置；类别 source；类型 data-contract）: 适配新配置访问方式，从散列属性改为通过 spec_aux_config 对象读取

关键符号：resolve_spec_aux_hidden_state_config, _resolve_eagle_aux_hidden_state, _resolve_dflash_aux_hidden_state, init_spec_aux_hidden_state

评论区精华

只有一个 review 评论，来自 gemini-code-assist[bot]：在 _resolve_eagle_aux_hidden_state 中使用 bare except: 违反 PEP 8，可能捕获 SystemExit 等异常，且当 eagle_config 为 None 时会导致逻辑错误（config.eagle_use_aux_hidden_state 保持 True）。建议改用 except Exception: 并显式检查 None。该评论未得到回复，PR 已合并。

• bare except: 的使用 (style): 作者未回复，PR 已合并，该问题未解决。

风险与影响

• 风险：主要风险是回归：原内联逻辑与新模块的行为是否一致。pool_configurator.py 中原来使用 getattr 安全访问，现在直接访问 spec_aux_config 属性，如果 spec_aux_config 未正确初始化将引发 AttributeError。但由于逻辑几乎原样迁移，风险较低。另外，bare except 可能隐藏未预期的异常，但在当前上下文中仅影响 EAGLE3 配置解析。
• 影响：对用户无直接影响（纯重构）。对开发者来说，model_runner.py 减少110行，职责更清晰；以后修改 speculative 配置只需修改 spec_aux_hidden_state.py 模块。团队可以更快定位相关逻辑。
• 风险标记：重构可能引入回归, 依赖初始化顺序, 缺少测试配套

关联脉络

• PR #31169 Split initialize() into orchestration helpers: 同系列 ModelRunner 重构，拆分初始化方法
• PR #31168 Extract cuda-graph setup into a module: 同系列 ModelRunner 重构，提取 CUDA graph 配置到独立模块
• PR #31167 Extract attention-backend setup into a module: 同系列 ModelRunner 重构，提取注意力后端配置到独立模块
• PR #31166 Narrow component dependencies to injected fields instead of ModelRunner: 同系列解耦 ModelRunner 依赖，本 PR 也使用了 spec_aux_config 而非散列属性，遵循相同模式
• PR #31158 Extract small single-function helpers into modules: 同系列将辅助函数提取到独立模块