# PR #35911 完整报告

- 仓库：`sgl-project/sglang`
- 标题：chore: bump docs install version to 0.5.18
- 合并时间：2026-08-22 04:24
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/35911

---

# 执行摘要

- 一句话：将文档安装版本号从 v0.5.16 同步至 v0.5.18
- 推荐动作：无需精读，属机械式文档版本同步。可作为了解 sglang-bot 自动化发布维护机制的样例；若团队维护多页面文档，值得借鉴“版本发布后自动同步文档版本号”的流程，同时注意配合一次全局 grep 校验确保无版本号遗漏。

# 功能与动机

v0.5.18 版本发布后，官方安装文档仍指引用户 `git clone -b v0.5.16`，Docker 示例也推荐固定 `lmsysorg/sglang:v0.5.16` 不可变 tag，会导致新用户按文档安装到过期版本。PR body 表明其目的为 "bumps the docs install version to 0.5.18 across all relevant files"，commit message 标注 "🤖 Generated with GitHub Actions"，属于发布流程驱动的例行版本同步，无关联 Issue。

# 实现拆解

1. 更新主安装文档 docs/docs/get-started/install.mdx：将源码安装示例的 git clone 分支从 v0.5.16 改为 v0.5.18；同时将 `<Note>` 提示中推荐固定不可变 Docker tag 的示例从 lmsysorg/sglang:v0.5.16 改为 lmsysorg/sglang:v0.5.18，保证“pin an immutable version tag for reproducible deployments”的示例与最新版本一致。
2. 更新 AMD 平台指南 docs/docs/hardware-platforms/amd_gpu.mdx：将 git clone 分支从 v0.5.16 改为 v0.5.18，确保 AMD 用户在编译 sgl-kernel 时基于新的发布分支。
3. 配套动作：无测试、配置或 schema 变更；mintlify bot 自动为 PR 生成文档预览部署（状态 Ready），供审阅者合并前核验渲染效果。

关键文件：
- `docs/docs/get-started/install.mdx`（模块 安装文档；类别 docs；类型 documentation）: SGLang 安装主文档，包含 git clone 分支与 Docker 不可变 tag 示例，是本 PR 的核心改动对象，直接决定新用户安装指引的版本准确性。
- `docs/docs/hardware-platforms/amd_gpu.mdx`（模块 平台文档；类别 docs；类型 documentation）: AMD 平台安装指南，更新 git clone 分支示例，确保 AMD 用户基于 v0.5.18 发布分支编译 sgl-kernel。

关键符号：未识别

## 关键源码片段

### `docs/docs/get-started/install.mdx`

SGLang 安装主文档，包含 git clone 分支与 Docker 不可变 tag 示例，是本 PR 的核心改动对象，直接决定新用户安装指引的版本准确性。

```bash
# docs/docs/get-started/install.mdx 中的安装命令示例
# 版本号由 bot 从 v0.5.16 同步至 v0.5.18，避免新用户 clone 到旧版本
# 注意：latest 与 dev 是可变 tag，文档建议固定不可变版本 tag 保证可复现部署
git clone -b v0.5.18 https://github.com/sgl-project/sglang.git
cd sglang

# Docker 方式部署时，推荐固定不可变 tag，例如：lmsysorg/sglang:v0.5.18

```

# 评论区精华

PR 无实质技术讨论。维护者 zijiexia 直接批准（APPROVED，无评论）。唯一评论来自 mintlify bot，自动报告文档预览部署状态："Preview deployment for your docs... 🟢 Ready"，并提供预览链接，属自动流程通知而非人工反馈。CI 方面，Base 测试通过，Extra 测试标记为失败，但作为纯文档变更未阻塞合并。

- Mintlify 文档预览部署通知 (other): 预览可用，无人工讨论；维护者 zijiexia 直接批准合并。

# 风险与影响

- 风险：风险极低，仅为两处文档字符串替换，不触及任何运行时逻辑。主要风险点：一是版本号一致性，仓库中可能还有其他文档页面（如其他平台安装页、Docker 部署页、cookbook）仍引用 v0.5.16，本次仅更新 2 个文件，若存在遗漏会导致部分入口继续展示旧版本号，建议后续全局 grep 校验 v0.5.16 是否在 docs 目录清零；二是前提假设 v0.5.18 已正式发布且 Docker Hub 镜像 tag 存在（由发布流程驱动，可信度较高），否则用户按文档拉取镜像会失败。
- 影响：影响对象为所有阅读 get-started 安装页的新用户，以及按 amd_gpu.mdx 编译 sgl-kernel 的 AMD 用户；影响方向是让安装指引与当前 release 对齐，避免用户安装陈旧版本。影响程度低，不涉及运行时行为、API 或性能。对团队而言，该 PR 展示了 sglang-bot 自动化文档维护机制的运转，是发布流程闭环的一部分。
- 风险标记：版本号引用可能遗漏

# 关联脉络

- 暂无明显关联 PR