根据PR描述，此变更旨在'Improved the usability of Ascend NPU documents'。原先的文档存在镜像地址分散、未明确区分A2/A3配置、缺少常见问题排查指南等问题，导致用户在部署和测试NPU环境时容易混淆和出错。
建议所有 NPU 用户和开发者阅读更新后的文档，特别是快速入门和示例部分。文档中新增的磁盘空间警告、FAQ 和测试指引值得注意，有助于避免常见陷阱。对于文档维护者，此 PR 展示了使用 Tabs、Tip、Warning 等 MDX 组件结构化文档的最佳实践。
此PR无技术讨论，由 sglang-npu-bot 直接批准合并。所有变更均为文档内容调整，无需代码审查。
swr.cn-southwest-2.myhuaweicloud.com 迁移至 quay.io/ascend/sglang，并区分稳定版和每日构建标签。涉及 ascend_npu.mdx、ascend_npu_quick_start.mdx、ascend_npu_qwen3_5_examples.mdx、ascend_npu_glm5_examples.mdx、ascend_npu_accuracy_evaluation.mdx 等文件。<Tabs> 组件，分别展示 A3 和 A2 的命令，用户可直接切换查看对应配置，避免手动替换错误。涉及所有主要文档页面。<Warning> 提示要求至少 30GB 空闲空间。在 FAQ 页新增网络错误排查指南，包括 HF 镜像、代理、手动下载三种方案。| 文件 | 模块 | 状态 | 重要度 |
|---|---|---|---|
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu.mdx |
NPU 文档 | modified | 5.61 |
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_faq.mdx |
NPU 文档 | modified | 4.89 |
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_quick_start.mdx |
NPU 文档 | modified | 4.45 |
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_qwen3_5_examples.mdx |
NPU 文档 | modified | 3.98 |
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_glm5_examples.mdx |
NPU 文档 | modified | 3.96 |
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_accuracy_evaluation.mdx |
NPU 文档 | modified | 3.6 |
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_deepseek_example.mdx |
NPU 文档 | modified | 2.99 |
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu_qwen3_examples.mdx |
NPU 文档 | modified | 2.92 |
分析完成后，这里会展示 LLM 生成的相对完整源码片段和详细注释。
当前评论区没有形成足够清晰的争议点或结论，后续有更多讨论时会体现在这里。
纯文档变更，无代码修改，不存在引入回归、性能下降或安全漏洞的风险。文档中的镜像地址已更新至官方 quay.io/ascend/sglang，用户在拉取时需注意镜像仓库的访问权限，但文档本身无风险。
直接影响所有使用 Ascend NPU 的 SGLang 用户。文档重构后，用户能更快速地选择正确硬件型号的镜像和命令，减少配置错误；新增 FAQ 和测试指引有助于自主排查网络和部署问题。团队维护文档的工作量略微增加，但长远提升用户满意度和降低支持负担。
当前没有检测到明确关联的 Issue 链接，后续同步到相关引用后会出现在这里。
参与讨论