执行摘要

• 一句话：固定 xgrammar 版本并清理 XPU 部署配置
• 推荐动作：该 PR 为常规依赖管理操作，技术亮点不多，但体现了对兼容性的重视。建议读者了解 XPU 部署中的依赖锁定策略。对于关注结构化生成的团队，可参考其版本固定方式。

功能与动机

PR body 指出：'Pin xgrammar version to v0.1.32 to avoid compatibility issues.' 上游 xgrammar 版本的不兼容更新可能导致结构化生成失败，固定版本可确保依赖稳定性。

实现拆解

1. 固定 xgrammar 版本：在 docker/xpu.Dockerfile 中将 pip install xgrammar --no-deps 改为 pip install --no-deps xgrammar==0.1.33（Dockerfile 实际采用 0.1.33，与 PR 标题的 0.1.32 略有出入）。
2. 清理 APT 缓存：在同一个 Dockerfile 的 APT 安装步骤末尾添加 rm -rf /var/lib/apt/lists/*，减小镜像体积。
3. 精简 CI 步骤：在 .github/workflows/pr-test-xpu.yml 中移除不再需要的 Set up Docker Buildx 步骤。
4. 移除注释依赖：在 python/pyproject_xpu.toml 中删除被注释的 xgrammar 行，避免混淆。

关键文件：

• docker/xpu.Dockerfile（模块 Docker；类别 infra；类型 infrastructure）: 核心变更文件：固定 xgrammar 版本、清理 APT 缓存、调整 git clone 目录，直接影响 XPU 镜像构建。
• .github/workflows/pr-test-xpu.yml（模块 CI；类别 infra；类型 infrastructure）: CI 配置变更：移除不再需要的 Docker Buildx 设置步骤，简化流水线。
• python/pyproject_xpu.toml（模块 配置；类别 config；类型 configuration）: 清理被注释的 xgrammar 依赖行，保持 pyproject.toml 整洁。

关键符号：未识别

关键源码片段

docker/xpu.Dockerfile

核心变更文件：固定 xgrammar 版本、清理 APT 缓存、调整 git clone 目录，直接影响 XPU 镜像构建。

# 安装 APT 依赖并合并 RUN 指令，末尾清理缓存
RUN apt-get update && apt-get install -y software-properties-common && \
    add-apt-repository -y ppa:kobuk-team/intel-graphics && \
    apt-get update && \
    apt-get install -y \
        libze-intel-gpu1 libze1 intel-metrics-discovery intel-opencl-icd clinfo intel-gsc \
        intel-media-va-driver-non-free libmfx-gen1 libvpl2 libvpl-tools libva-glx2 va-driver-all vainfo \
        libze-dev intel-ocloc && \
    rm -rf /var/lib/apt/lists/* # 减少镜像层大小
​
# 克隆仓库并安装依赖（节选）
RUN git clone --branch ${SG_LANG_BRANCH} --single-branch ${SG_LANG_REPO} sglang && \
    cd sglang/python && \
    cp pyproject_xpu.toml pyproject.toml && \
    pip install . --extra-index-url https://download.pytorch.org/whl/xpu && \
    pip install --no-deps xgrammar==0.1.33 # 固定版本避免兼容问题

评论区精华

该 PR 未引发讨论，审核者 mingfeima 直接批准。

• 无讨论 (other): 直接批准

风险与影响

• 风险：主要风险是版本固定导致无法自动获得 xgrammar 的安全修复或性能改进，需关注上游更新。另外，Dockerfile 中固定的版本（0.1.33）与 PR 标题（0.1.32）不一致，可能引入混淆，但实际使用中影响不大。删除 Docker Buildx 步骤可能影响 CI 中需要构建缓存的场景，但目前 XPU CI 未依赖该步骤。
• 影响：影响范围限定在 XPU 镜像构建和 CI 流程。用户使用 XPU Docker 镜像时 xgrammar 版本固定，避免了因自动升级导致的接口变化。CI 流程简化，构建速度可能略有提升。
• 风险标记：版本固定可能错过上游更新, Dockerfile 版本与标题不一致, CI 步骤删除可能影响缓存

关联脉络

• 暂无明显关联 PR