# PR #21575 完整报告

- 仓库：`sgl-project/sglang`
- 标题：docs: flesh out MAINTAINER.md oncall lists and link GitHub profiles
- 合并时间：2026-03-28 08:39
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/21575

---

# 执行摘要

- 一句话：更新维护者文档，细化按领域分区的合并 / 评审人员列表并添加 GitHub 个人资料链接。
- 推荐动作：该 PR 值得团队负责人、文档维护者和 CI 管理员阅读，以了解维护者结构和权限变更。对于普通工程师，建议关注 MAINTAINER.md 中的 oncall 列表，熟悉新的协作流程，并检查 CI_PERMISSIONS.json 以确认权限更新。

# 功能与动机

根据 PR body，目的是更新 `.github/MAINTAINER.md` 以提供更详细的维护者信息，包括按领域分区的合并 / 评审人员和 CI 负责区域列表，并添加 GitHub 个人资料链接，以便于团队协作和问题解决，解决文档信息不完整的问题。

# 实现拆解

主要改动集中在 `.github/MAINTAINER.md`，添加了调度、扩散、PD disaggregation、KV Cache、并行化等模块的 oncall 列表，包括 GitHub 个人资料链接和相关文件路径。辅助更新包括：1. `.github/CI_PERMISSIONS.json` 中统一添加 `can_rerun_stage` 权限，并调整部分字段顺序；2. `.github/CODEOWNERS` 调整了 `/python/sglang/srt/compilation` 和 `/sgl-model-gateway/examples/wasm` 路径的所有者；3. 新增 `.github/audit_permission.py` 脚本，用于审计仓库协作者权限；4. 修改 `.github/pull_request_template.md`，更新 Review Process 部分和常用命令；5. 修改 `.github/update_ci_permission.py`，将 top contributors 计算周期从 90 天改为 120 天；6. 精简 `docs/developer_guide/contribution_guide.md` 中的链接检查指南。

关键文件：
- `.github/MAINTAINER.md`（模块 .github）: 主要改动文件，添加详细的按领域分区的 oncall 列表、GitHub 个人资料链接和相关文件路径，是团队协作的核心文档。
- `.github/CI_PERMISSIONS.json`（模块 .github）: 更新 CI 权限配置，为所有用户添加 can_rerun_stage 权限，并调整字段顺序，影响 CI 测试触发流程。
- `.github/audit_permission.py`（模块 .github）: 新增脚本，用于审计仓库协作者权限，涉及 GitHub API 调用和权限管理，对团队安全审计有潜在价值。

关键符号：未识别


# 评论区精华

Review 评论区无实质性讨论，仅有 Issue 评论中 gemini-code-assist[bot] 的配额警告，未涉及技术或设计争议。PR 是直接合并的，表明变更被认为简单或无争议。

- 暂无高价值评论线程

# 风险与影响

- 风险：风险较低，但具体包括：1. GitHub 个人资料链接可能错误或过时，导致维护者信息不准；2. CI 权限配置变更（如 `.github/CI_PERMISSIONS.json` 中添加 `can_rerun_stage`）可能导致权限不一致或误用；3. CODEOWNERS 更新可能影响代码所有权分配和 PR 审批流程；4. 新脚本 `.github/audit_permission.py` 可能存在执行错误或输出不准确，影响审计结果。
- 影响：对用户和系统影响较小，主要为文档改进。对团队影响：提高维护者信息透明度，简化协作流程，尤其有助于新成员快速定位 oncall 人员；CI 权限和 CODEOWNERS 变更可能影响测试触发和代码审批，但范围有限。影响程度为低，主要涉及团队内部管理和文档系统。
- 风险标记：文档链接风险 , 权限配置变更 , 代码所有权调整

# 关联脉络

- PR #20904 fix(security): replace unsafe pickle.loads with SafeUnpickler for CVE-2026-3989: 都修改了 docs/developer_guide/contribution_guide.md，涉及文档更新和安全性改进，显示项目在持续完善贡献者指南。
- PR #21563 Split workflow for releasing runtime docker: 涉及 CI 配置和 infra 变更，与本 PR 的 CI 权限和流程更新相关，体现项目对 CI 管理的持续优化。