# PR #22796 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[NPU] [DOC] Update NPU docs to match latest code
- 合并时间：2026-04-14 21:10
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/22796

---

# 执行摘要
本次 PR 更新了 Ascend NPU 相关文档，包括版本号同步、依赖补充和模型名称修正，旨在提升文档准确性和用户安装体验。变更仅涉及文档文件，无代码逻辑改动，风险较低，影响范围限于 NPU 平台用户。

# 功能与动机
根据 PR body，主要动机是“更新 NPU 文档以匹配最新代码”和“修复 kimi k2 thinking 模型名称”。这源于对文档准确性的维护需求，确保用户能基于最新信息正确安装和使用 NPU 功能，避免因文档过时或错误导致的问题。例如，HDK 版本从 25.3.RC1 更新到 25.5.2，反映了硬件支持的最新状态。

# 实现拆解
变更涉及两个文档文件，按模块拆解如下：

| 文件 | 关键变更 | 影响 |
|------|----------|------|
| `docs/platforms/ascend/ascend_npu.md` | - HDK 版本更新：25.3.RC1 → 25.5.2<br>- TORCH_NPU 版本更新：2.8.0 → 2.8.0.post2<br>- 新增系统依赖：`apt install libgl1 libglib2.0-0` 和 `pip install "setuptools<80"`<br>- Docker 构建指令添加 `--build-arg TARGETARCH=<arch_tag>` 参数 | 确保安装指南与最新依赖版本一致，提升跨架构构建支持 |
| `docs/platforms/ascend/ascend_npu_support_models.md` | - 修正 Kimi-VL 模型组织名称：`Kimi/Kimi-VL-A3B-Instruct` → `moonshotai/Kimi-VL-A3B-Instruct` | 避免用户因模型路径错误导致加载失败 |

# 评论区精华
review 中仅有一条来自 gemini-code-assist[bot] 的评论，针对 `ascend_npu.md` 中新增的系统依赖安装指令提出优化建议：
> “The instructions for installing dependencies like `libgl1` and `libglib2.0-0` are helpful, but it is better to combine these into a single `apt-get install` command to reduce the number of layers in a Dockerfile or to minimize the number of package manager invocations in a shell script, which is more efficient.”

该建议未被采纳（PR 已合并未修改），但揭示了文档编写中对安装指令效率的关注，可作为最佳实践参考。

# 风险与影响
- **技术风险**：低。主要为文档准确性风险，如版本更新可能隐含兼容性变化，但文档本身不直接影响代码执行。依赖安装指令若未优化，可能在自动化脚本中效率稍低，无功能影响。
- **影响分析**：影响范围限于使用 Ascend NPU 平台的用户和开发者。用户获得更准确的安装指南和模型信息，提升体验；系统无代码变更，不影响功能；团队减少文档过时带来的支持负担。影响程度为低。

# 关联脉络
从近期历史 PR 分析可见，NPU 文档维护是一个持续过程：
- PR #22799 同样修正 Kimi 模型名称，与本 PR 类似，反映对模型路径准确性的重视。
- PR #22795 和 #22804 涉及其他 NPU 功能文档更新，展示 NPU 生态文档的持续演进。
这些 PR 共同构成 NPU 平台文档的维护流，旨在确保文档与代码实现同步，支持用户顺利使用 NPU 特性。