# PR #24658 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[NPU] [DOC] fix ascend_npu_support_new_models TOC
- 合并时间：2026-05-08 14:07
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/24658

---

## 执行摘要

该 PR 在文档站点目录配置 `docs_new/docs.json` 中，为 Ascend NPU 分组添加了 `ascend_npu_support_new_models` 页面的索引条目，修复了该新页面无法通过目录导航访问的问题。变更仅一行，无功能性影响。

## 功能与动机

PR 作者指出需要将新增的 Ascend NPU 新模型支持文档页面 `ascend_npu_support_new_models.md` 加入文档站点目录（TOC），使用户能够通过文档导航找到该页面。

## 实现拆解

1. **修改文件**：`docs_new/docs.json`，该文件定义了文档站点的目录结构与页面层级。
2. **具体变更**：在 Ascend NPU 分组（`group: "Ascend NPUs"`）的 `pages` 数组中，于 `ascend_contribution_guide` 和 `ascend_npu_best_practice` 之间插入新条目 `"docs/hardware-platforms/ascend-npus/ascend_npu_support_new_models"`，保持字母顺序。
3. **无配套变更**：无测试、代码或不涉及运行时配置变更。

### `docs_new/docs.json`

文档站点目录配置文件，修改了 Ascend NPU 分组页面列表，新增一行指向新文档页面的路径。

```json
// docs_new/docs.json
{
  "group": "Ascend NPUs",
  "pages": [
    // ...
    "docs/hardware-platforms/ascend-npus/ascend_contribution_guide",
    "docs/hardware-platforms/ascend-npus/ascend_npu_support_new_models",  // 新增 : 新模型支持文档页
    "docs/hardware-platforms/ascend-npus/ascend_npu_best_practice"
    // ...
  ]
}

```

## 评论区精华

无讨论。

## 风险与影响

- **风险**：极低。仅编辑 JSON 配置文件，需确保目标页面文件真实存在以避免构建错误，但仓库应已包含该文件。
- **影响**：仅改善 Ascend NPU 文档的可发现性，不影响任何运行时行为或测试。

## 关联脉络

该 PR 是 Ascend NPU 系列文档更新的延续。先前已有 PR #23708 更新了 GLM-5 示例文档，本次进一步将新模型支持页面纳入目录体系，完善了 Ascend 文档结构。