# PR #39324 完整报告

- 仓库：`sgl-project/sglang`
- 标题：chore: bump sgl-kernel version to 0.4.7
- 合并时间：2026-09-14 06:48
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/39324

---

# 执行摘要

- 一句话：sgl-kernel 版本统一升至 0.4.7，覆盖四大平台构建配置
- 推荐动作：不值得精读，属于机械的版本号同步。建议重点做两件事：确认上游 sgl-kernel 0.4.7 wheel 已成功发布，以及排查 PR 中三个 CI 失败的具体原因。该 PR 的价值在于维持多平台版本契约的一致性。

# 功能与动机

PR body 仅说明由 GitHub Actions 自动生成，将 sgl-kernel 版本统一升至 0.4.7。结合上下文推测动机是与上游 sgl-kernel 0.4.7 release 对齐，避免 wheel 包版本与运行时 __version__不一致导致依赖解析或加载问题。具体 0.4.7 包含哪些修复或特性未在 PR 中说明，关联 Issue 为空。

# 实现拆解

1. 更新运行时版本号：在 python/sglang/kernels/aot/python/sgl_kernel/version.py 中，把 __version__从 0.4.6.post1 改为 0.4.7，这是 Python 侧直接读取的版本字符串，影响 sgl_kernel.__version__的输出。
2. 同步构建配置：分别更新 python/sglang/kernels/aot 下的 pyproject.toml（CUDA）、pyproject_rocm.toml（AMD ROCm）、pyproject_musa.toml（MThreads MUSA）、pyproject_cpu.toml（CPU）中 [project].version 字段，保证四个平台构建出的 wheel 版本一致。
3. 无测试、无文档、无代码逻辑变更；该改动只影响打包元数据与发布产物，属于版本契约层面的同步。

关键文件：
- `python/sglang/kernels/aot/python/sgl_kernel/version.py`（模块 版本模块；类别 source；类型 core-logic；符号 __version__）: 运行时版本号入口，Python 侧通过 __version__暴露版本，下游依赖检查和日志展示都依赖它，是本次版本抬升的核心落点。
- `python/sglang/kernels/aot/pyproject.toml`（模块 构建配置；类别 config；类型 configuration）: CUDA 平台 wheel 的包元数据，project.version 决定发布到 PyPI 的版本号，需要和运行时版本严格一致。
- `python/sglang/kernels/aot/pyproject_rocm.toml`（模块 构建配置；类别 config；类型 configuration）: AMD ROCm 平台构建配置，单独产出 sglang-kernel wheel，版本号未同步会导致 ROCm 安装包版本不一致。
- `python/sglang/kernels/aot/pyproject_musa.toml`（模块 构建配置；类别 config；类型 configuration）: MThreads MUSA 平台构建配置，版本号同步影响 MUSA 专用 wheel 的发布与依赖解析。
- `python/sglang/kernels/aot/pyproject_cpu.toml`（模块 构建配置；类别 config；类型 configuration）: CPU 平台独立发布 sglang-kernel-cpu 包，版本号需要同步避免与 GPU 版本语义错位。

关键符号：未识别

## 关键源码片段

### `python/sglang/kernels/aot/pyproject.toml`

CUDA 平台 wheel 的包元数据，project.version 决定发布到 PyPI 的版本号，需要和运行时版本严格一致。

```toml
[project]
name = 'sglang-kernel'
# 构建 wheel 的版本号，要求与 python/sgl_kernel/version.py 中 __version__ 保持一致。
# 本次同步升级为 0.4.7，影响 PyPI 发布和依赖缓存 key。
version = '0.4.7'
authors = [
  { name = 'SGLang Kernel Team', email = 'sglang@lmsys.org' },
]
description = 'Kernel Library for SGLang'
requires-python = '>=3.10'
# 其余 project 元数据与 0.4.6.post1 版本一致，未做行为变动。

```

# 评论区精华

本 PR 无 review 评论，也没有任何讨论线程，是 sglang-bot 自动化提交的常规版本抬升。

- 暂无高价值评论线程

# 风险与影响

- 风险：版本一致性风险：如果 PyPI 上 sglang-kernel 0.4.7 wheel 尚未发布或发布不完整，下游安装时仍可能拉到旧版本，或出现 __version__与 wheel 元数据不匹配。CI 风险：PR body 显示 Base、Extra、AMD ROCm 三个 CI 状态均为失败，需确认失败是否由该版本抬升或上游状态引起；本次是纯元数据改动，失败更可能来自环境或上游构件缺失。多平台覆盖风险：ROCm、MUSA、CPU 等平台版本同步路径不同，本次五个文件均已修改，暂未发现遗漏。
- 影响：对用户：无直接功能影响，安装后可见 sgl_kernel.__version__变为 0.4.7；若上游未发布对应 wheel，安装可能失败。对系统：打包与发布流水线的产物版本发生变化，影响依赖解析、缓存 key 和包管理器行为。对团队：版本维护者需要确认 sgl-kernel 0.4.7 已发布，并跟进 CI 失败原因。
- 风险标记：多平台版本同步 , CI 未通过

# 关联脉络

- 暂无明显关联 PR