执行摘要

• 一句话：配置发布职责上移进程入口，构造器只做断言
• 推荐动作：值得精读。该 PR 是配置架构重构系列的关键一环，展示了“发布是进程入口职责”的清晰分工、fail-loud 的断言策略，以及为“声明不再物化到字段”铺路的投影机制。建议对照同系列 PR（36250/36252/36253/36254/36255）一起阅读，才能看到完整的设计意图。

功能与动机

PR body 明确指出：发布发生在构造函数内部会让“配置是否已发布”取决于进程先构建哪个对象，而一个合法不构建这些对象的进程（spawn 的 encoder worker、benchmark 入口）会读到未发布的 bag；把进程级副作用放进 __init__ 还导致测试构建两个对象时发布两次。另一面，整体对象回读（/server_info、resolved-args 字典）走的是记录字段，一旦决策存在声明 stash 中而非字段中，遍历字段就会报告错误形状。

实现拆解

1. 发布上移到进程入口：在 python/sglang/srt/entrypoints/http_server.py、python/sglang/srt/disaggregation/encoder/grpc_server.py 与 server.py、python/sglang/benchmark/one_batch.py、python/sglang/srt/entrypoints/grpc_bridge.py 等入口显式调用 publish(server_args, role=...)，确保任何进程在首次读取 config bag 前完成发布。
2. 构造函数改为断言：ModelRunner.__init__、TokenizerManager 等从 ensure_published() 改为 assert_published()，未发布即抛 RuntimeError 并携带角色信息，实现 fail-closed；draft runner 不检查，避免覆盖 target 配置。
3. 整体回读走投影：在 python/sglang/srt/arg_groups/overrides.py 新增 resolution_projection() 与 _plain()，ServerArgs.resolved_dict() 委托它返回解析后的扁平字典；RuntimeContext.resolved_server_args_dict() 默认基座从 dict(vars(...)) 切换为 server_args.resolved_dict()，避免把私有解析簿记和 model_config memo 带进回读。
4. 测试配套：test_runtime_context.py 将 TestEnsurePublished 反转为 TestAssertPublished，覆盖“断言不重投影”“不同记录失败”“空槽失败”；test_resolution_declarations.py 新增 test_the_whole_object_readback_carries_only_fields 断言回读 dump 只含字段名；另有 test_publish_precedes_bag_reads.py 逐入口验证发布先于读取。

关键文件：

• python/sglang/srt/runtime_context.py（模块 运行上下文；类别 source；类型 core-logic；符号 ensure_published, assert_published, resolved_server_args_dict）: 核心变更所在地：ensure_published 改为 assert_published，回读基座切换为 resolved_dict()，定义了进程级配置发布/断言契约。
• python/sglang/srt/arg_groups/overrides.py（模块 覆盖注册；类别 source；类型 core-logic；符号 resolution_projection, _plain）: 新增 resolution_projection 与 _plain，实现按声明结果投影的整体回读，为未来声明不再物化到字段做准备。
• test/registered/unit/test_runtime_context.py（模块 单元测试；类别 test；类型 test-coverage；符号 TestAssertPublished, test_the_check_leaves_a_live_process_alone, test_a_different_record_fails, test_an_empty_slot_fails）: 将 TestEnsurePublished 反转为 TestAssertPublished，验证断言不重投影、不同记录失败、空槽失败等新语义。
• python/sglang/srt/server_args.py（模块 服务参数；类别 source；类型 core-logic；符号 resolved_dict）: 新增 ServerArgs.resolved_dict()，作为所有整体回读的统一入口，内部委托 resolution_projection。
• python/sglang/srt/model_executor/model_runner.py（模块 模型执行；类别 source；类型 data-contract；符号 ModelRunner.init）: 构造器从 ensure_published 改为 assert_published，仅 target worker 检查，draft worker 不得覆盖目标配置。
• test/registered/unit/server_args/test_resolution_declarations.py（模块 解析测试；类别 test；类型 test-coverage；符号 test_the_whole_object_readback_carries_only_fields）: 新增测试断言回读 dump 只含字段名，不带私有解析簿记与 model_config memo。
• python/sglang/benchmark/one_batch.py（模块 基准入口；类别 source；类型 dependency-wiring）: 基准入口显式调用 publish(role=...)，确保无任何构造器兜底时也有已发布 bag。
• python/sglang/srt/entrypoints/grpc_bridge.py（模块 桥接层；类别 source；类型 dependency-wiring）: gRPC 入口侧接线变更，发布后不再依赖构造器兜底。
• python/sglang/srt/disaggregation/encoder/server.py（模块 编码器服务；类别 source；类型 core-logic）: encoder 服务入口显式发布，spawn 的 worker 不再依赖 MMEncoder 内部发布。
• python/sglang/srt/entrypoints/http_server.py（模块 服务入口；类别 source；类型 core-logic）: HTTP 入口显式发布，是‘发布是进程入口的工作’的核心落点。
• python/sglang/srt/managers/tokenizer_manager.py（模块 分词管理；类别 source；类型 core-logic）: 从发布改为断言，与入口发布职责匹配。
• python/sglang/srt/disaggregation/encoder/grpc_server.py（模块 编码器入口；类别 source；类型 dependency-wiring）: encoder gRPC 入口接线调整，保证发布先于 bag 读取。

关键符号：assert_published, ensure_published, publish, resolution_projection, _plain, resolved_dict, resolved_server_args_dict, ModelRunner.init

关键源码片段

python/sglang/srt/runtime_context.py

核心变更所在地：ensure_published 改为 assert_published，回读基座切换为 resolved_dict()，定义了进程级配置发布/断言契约。

def resolved_server_args_dict(self, base: dict | None = None) -> dict:
    """把『已解析』的配置序列化出来：原始 server_args 字段叠加上每个 post-publish override。"""
    # 默认基座从 dict(vars(...)) 换成 resolved_dict()：前者会把私有解析簿记和
    # model_config memo 泄漏进回读，后者只报告解析决定后的字段值，嵌套 dataclass 已展开。
    d = self.server_args.resolved_dict() if base is None else dict(base)
    # 再把本进程 post-publish 的 override 覆盖上去，
    # 叶子是扁平的 ServerArgs 字段名，直接更新顶层即可。
    for _source, fields in self._overrides_log:
        d.update(fields)
    return d

python/sglang/srt/arg_groups/overrides.py

新增 resolution_projection 与 _plain，实现按声明结果投影的整体回读，为未来声明不再物化到字段做准备。

def resolution_projection(server_args: Any) -> Dict[str, Any]:
    """每一个字段的解析结果，嵌套 dataclass 全部展开。
​
    这是 resolution_result 的『整对象』形态，供 /server_info、gRPC 与进程内回读使用。
    之前用 dataclasses.asdict，它读字段——只有声明还物化到记录上时才是对的；
    声明化之后必须读声明结果。
    """
    return {
        field.name: _plain(resolution_result(server_args, field.name))
        for field in dataclasses.fields(server_args)
    }
​
​
def _plain(value: Any) -> Any:
    """dataclasses.asdict 的转换逻辑，只作用于单个值。"""
    # dataclass 展开为 dict
    if dataclasses.is_dataclass(value) and not isinstance(value, type):
        return {
            field.name: _plain(getattr(value, field.name))
            for field in dataclasses.fields(value)
        }
    # namedtuple 保持类型，元素按同样的规则处理
    if isinstance(value, tuple) and hasattr(value, "_fields"):
        return type(value)(*(_plain(item) for item in value))
    # list / tuple 递归
    if isinstance(value, (list, tuple)):
        return type(value)(_plain(item) for item in value)
    # dict 的 key 和 value 都递归
    if isinstance(value, dict):
        return type(value)((_plain(k), _plain(v)) for k, v in value.items())
    # 其余值 deepcopy，调用方改写 dump 不会影响活配置
    return copy.deepcopy(value)

评论区精华

该 PR 仅有 1 条 review comment，材料未给出其正文。从 PR body 与测试语义可看出两个关键设计决策：一是构造函数从防御性 publish 改为 assert_published，把“是否已发布”变成启动期强约束，避免重复发布重投影 bag 导致 override() 与 provenance 日志被丢弃；二是整体回读改用 resolution_projection，不依赖字段物化。具体讨论交锋无法从现有上下文还原。

• Review 评论内容未提供 (question): 无法从已提供的材料中提取具体结论；建议查阅原始 GitHub 评论。

风险与影响

• 风险：
  1. 进程入口遗漏风险：如果某个未覆盖的进程入口忘记调用 publish，现在会在构造 ModelRunner 等对象时直接启动失败（fail-loud），需要枚举所有入口保证覆盖。
  2. 回读字段变化：/server_info 与 gRPC 回读不再携带 vars() 中的私有解析簿记和 model_config memo，依赖这些字段的客户端可能受影响（PR 认为这些不是配置，属有意变更）。
  3. deep-copy 开销：resolved_dict() 对每个叶子做 copy.deepcopy，/server_info 等高频回读路径可能有轻微性能开销。
  4. 行为语义反转：ensure_published 改为 assert_published 后，同样一个“未发布就构建”调用从静默发布变成抛错，任何依赖旧兜底行为的代码会立刻暴露。
     - 影响：影响集中在配置子系统：所有进程入口都必须显式发布，构造函数不再承担进程级副作用；/server_info 等回读内容发生变化；ModelRunner、TokenizerManager 等构造器的行为契约改变。对团队而言，新增入口时必须记得调用 publish，否则启动即失败；对用户而言，外部可见的回读字段范围收窄到纯配置字段，语义更干净。影响范围中等偏大，但集中在 sglang/srt 内部。
     - 风险标记：进程入口遗漏风险, 回读字段变化, 启动失败策略变更, 深度拷贝开销

关联脉络

• PR #36255 config: ServerArgs holds the raw input: 同系列配置重构 PR：ServerArgs 只存原始输入、解析决议走声明与投影，与本 PR 的 resolved_dict() 直接衔接。
• PR #36254 config: the runtime readers take the published bags: 同系列：运行时读者统一改读 published bags，与本 PR 的发布职责上移配套。
• PR #36253 config: resolution reads the declarations, not the fields: 同系列：resolution 链读取声明 stash，是本 PR 回读投影机制的前提。
• PR #36252 config: stop handing the record to code that does not read it: 同系列：删除未读 server_args 参数，推进配置重构收敛。
• PR #36250 config: spell the parallel config tier at the call site: 同系列：显式隔离 parallel 配置层与 live 拓扑，同一配置架构重构堆栈。