sgl-project/sglang

技能文档落定 config 种子禁读规则与分形状读取入口

值得精读，尤其关注三点：1）分形状读取的决策映射（bag / `get_parallel()` / 具名访问器 / `configured_*_size()` / runner stamp），这是理解 SGLang 配置架构的钥匙；2）读棘轮测试（`test_global_config_read_ratchet.py`）如何用 AST 收集器把架构约束钉死，以及词法作用域遮蔽的处理；3）“文档评审反哺代码质量”的流程——纯文档 PR 的评审催生了 `sarvam_moe.py` 与收集器的真实修复。若只关心运行时行为，可跳过。

KV 缓存配置器改读配置袋，统一 override 可见性

值得精读。该 PR 是 SGLang 配置系统"读配置袋"迁移的一个典型样本：展示了如何在不改变公共 API 的前提下，把散落的 self.server_args 读取收敛到带命名 accessor 的配置袋层，并通过"同一解析值贯穿多个缓冲"保持一致性。值得关注的设计决策：`max_draft_tokens` 参数化让行余量与池缓冲共享一个解析值；draft worker 刻意读 process/target 袋值；`pre_capture_activation_reserve_mb` 保留实例读取的边界判断。配合 review 中作者对 draft/target 配置语义的解释（draft 实例 vs 进程记录），能深入理解这套配置架构的取舍。

runner 与 scheduler 配置读取迁移至配置袋，补齐 override 语义

值得精读。核心价值不在 diff 本身，而在两点：一是 `is_ep_joiner` / `is_ep_scale_joiner` 从 property 变函数的设计——因为 `ep_join_mode` 不是存档 leaf，无法走常规 leaf 读取路径，这是对配置系统"读什么、从哪读"边界的清晰注解；二是 review 中反复出现的"读 stamp 与读 bag 之争"与"单一快照 vs 多次读取"的取舍，直接展示了配置收敛迁移中最容易踩的坑。对配置系统演进方向感兴趣的工程师应重点阅读 `runtime_context.py` 的谓词实现、`load_kv_cache_scales` 的必传参数设计，以及作者"纯粹 read-source flip 不改变行为"的变更纪律。

新增解析可重现性测试，钉死 ServerArgs 纯函数契约

值得精读。虽然只有一个测试文件，但它演示了如何为"纯函数化"契约设计回归测试，并完整展示了审查者与作者的往返式修复过程。重点看 _comparable 的快照语义、_process_state/_restore_process_state 的进程状态恢复、_STICKY_ACROSS_RESOLUTIONS 对已知粘性行为的显式命名，以及 _callTestMethod 禁用重试的理由。

配置读取全迁 runtime_context，ratchet 基线归零

值得精读。重点学习：runtime_context 访问器层的设计（bag 派生与 slot 透传的取舍）、ratchet 的 AST 扫描与词法作用域处理（模块别名、嵌套函数、动态 getattr）、遮蔽守卫对全部绑定形式的枚举，以及缓存生命周期在 publish/reset 中的管理。这些模式对大型 Python 代码库的配置演进有直接借鉴价值。

移除隐藏全局配置回退，mamba 谓词改读配置袋

值得精读，尤其是关注配置架构的工程师。本 PR 展示了三类可迁移的方法论：(1) 用 read ratchet 制度识别“可选注入”反模式，并让谓词归属到真正拥有数据的配置袋；(2) 通过 AST 扫描死绑定来做迁移清理的机械归因，避免靠肉眼遗留死代码；(3) 在 post-publish 与 mid-resolution 之间维持谓词唯一定义的双轨约定。对 mamba radix cache 或 DeepSeek MoE 双流图路径有维护需求的同学，建议顺带阅读 review 中关于测试 fixture 迁移的讨论。

修复 AMD 夜测中 DSV4-DSpark 套件从不运行

值得关注，但不需要逐行精读。核心价值在于：1) 演示了 `register_amd_ci` 只做注册、必须由 workflow job 调用 `run_suite.py --suite` 才能执行这一机制，避免“注册即沉睡”的坑；2) 展示新增 AMD nightly job 的标准接线（机器池、容器镜像、依赖安装、`job_select`、`check-all-jobs`、timeout 预算）；3) body 中“为什么只跑单 backend 腿”与“为什么 timeout 取 7200”的论证是值得借鉴的 CI 设计权衡。若你维护 AMD / nightly CI 或 DeepSeek-V4 相关测试，建议阅读；普通功能开发者可跳过。

Qwen3.5 纯文本模式支持，跳过视觉编码器加载

值得精读。核心看点：一是三层联动开关的设计（配置层判定 + 模型层分支 + processor 短路），把单一 config 字段贯穿到整个加载链路；二是 _require_vision 守卫函数兼顾生产与单测的写法（模块级函数 + getattr 兜底），是对“现有单测以未绑定方法调用”这类隐性约束的教科书式响应；三是 gemini-code-assist 高优先级告警被驳回的论证——属性初始化顺序问题最终由维护者确认父类无条件赋值而关闭，展示了 review 中不必要的告警如何被快速、有理有据地化解。若团队后续要支持其他模型的纯文本变体，本 PR 提供了可直接复用的模式。