# PR #29828 完整报告

- 仓库：`sgl-project/sglang`
- 标题：glm5.2 on ascend doc (new version)
- 合并时间：2026-07-03 10:19
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/29828

---

# 执行摘要

- 一句话：新增 Ascend NPU 上 GLM-5.2 部署文档
- 推荐动作：建议维护者验证并确保文档中的命令示例已按 Review 建议修正。对于需要部署 GLM-5.2 的用户，此文档是必要参考，值得精读。

# 功能与动机

用户需要在 Ascend NPU 上使用 SGLang 部署 GLM-5.2 模型，但缺少官方文档指导。该 PR 填补了这一空白，提供从模型权重获取到部署命令的完整步骤，降低用户的上手门槛。

# 实现拆解

实现分为以下两步：
1. **新增文档页面**：创建 `docs_new/docs/hardware-platforms/ascend-npus/model-tutorials/glm_5_2.mdx`，包含模型介绍、支持特性表（TP、EP、PD 分离、量化等）、前置条件（权重下载、容器环境）、部署命令（单节点 docker、多节点 docker、PD 分离）、最佳实践（性能调优、chunked prefill、speculative decoding 等）。文档以表格和代码块呈现，便于用户复制粘贴。
2. **更新导航配置**：修改 `docs_new/docs.json`，在 Ascend NPU 的 Model Tutorials 组中添加 `glm_5_2` 入口，确保文档在侧边栏可见。

此外，提交历史显示作者对文档进行了多轮修改，包括修正重复参数、调整最佳实践引用、删除无关内容等，最终版本稳定。

关键文件：
- `docs_new/docs/hardware-platforms/ascend-npus/model-tutorials/glm_5_2.mdx`（模块 文档；类别 docs；类型 documentation）: 新增文档主体，包含所有部署说明，是 PR 核心变更。
- `docs_new/docs.json`（模块 导航配置；类别 config；类型 configuration）: 更新导航配置，注册新文档页面。

关键符号：未识别


# 评论区精华

Gemini Code Assist 自动审查指出文档中 shell 命令示例存在语法问题：--privileged 重复、MODEL_PATH 赋值语法无效、命令末尾多余反斜杠。这些评论未收到作者回复，PR 已合并，建议确认是否已修正。

- Shell 命令示例语法错误 (correctness): PR 已合并，但 review 建议是否被采纳未确认。

# 风险与影响

- 风险：文档中的命令示例若未按 Review 建议修正，用户可能因语法错误导致脚本失败，影响部署体验。此外，配置参数（如 TP/DP/EP 大小）需根据硬件调整，文档提供的示例值可能不适用于所有用户，需加说明。由于是纯文档 PR，对系统无运行时风险。
- 影响：主要影响 Ascend NPU 用户——为 GLM-5.2 模型提供第一份官方部署指南，有助于推广该模型在 Ascend 上的使用。对不涉及 Ascend 的用户无影响。文档被引用后，可能成为未来类似文档的模板。
- 风险标记：文档命令语法风险 , 命令示例未验证

# 关联脉络

- PR #29544 docs: add PD disaggregation to GLM-5.2 cookbook playground: 同为 GLM-5.2 文档，但面向 cookbook 场景，与本次新增的 Ascend NPU 部署指南互补。