执行摘要

此 PR 在 docs_new/docs.json 配置文件中添加了 sglang-omni 文档的重定向规则，将本地路径映射到外部 GitHub Pages 地址，以解决文档访问问题。变更仅涉及静态配置，风险极低，对核心系统无影响。

功能与动机

根据 PR body，此变更旨在修复 sglang-omni 文档的重定向问题。虽然没有关联 Issue，但作者通过 jq empty docs_new/docs.json 和 mint validate 验证了配置格式，确保变更正确无误。动机是提升文档可访问性，使用户能够通过统一入口访问外部文档。

实现拆解

变更仅修改一个文件，具体步骤如下：

1. 入口文件：docs_new/docs.json 是文档系统的配置文件，定义了重定向、路由等元数据。
2. 核心配置变更：在 redirects 数组中新增两条规则：
   • 基础路径重定向：将 /sglang-omni 映射到 https://sgl-project.github.io/sglang-omni/。
   • 通配路径重定向：将 /sglang-omni/:path* 映射到对应外部路径，支持所有子路径。
   • 两条规则均设置 permanent: false，表示临时重定向，便于未来调整。
3. 验证配套：通过 jq 验证 JSON 格式，并通过 mint 工具进行更全面的配置验证，确保不会破坏文档构建流程。

关键源码片段如下（整理自变更后的配置文件）：

关键源码片段

docs_new/docs.json

这是唯一变更的文件，包含了新增的 sglang-omni 重定向规则，直接影响文档访问行为。

{
  "redirects": [
    // 其他现有重定向规则 ...
    {
      "source": "/sglang-omni",
      "destination": "https://sgl-project.github.io/sglang-omni/",
      "permanent": false // 临时重定向，便于未来调整
    },
    {
      "source": "/sglang-omni/:path*",
      "destination": "https://sgl-project.github.io/sglang-omni/:path*",
      "permanent": false // 支持所有子路径的重定向
    }
    // 其他现有重定向规则 ...
  ]
}

评论区精华

Review 中没有实质性讨论，仅有一位审核者（wisclmy0611）批准了 PR，且没有留下评论。这表明变更简单直接，没有引发技术争议或设计权衡。

风险与影响

• 风险分析：风险极低。配置通过了格式验证，且仅添加新规则，不影响现有路径；重定向为静态处理，无运行时性能影响。
• 影响分析：影响范围有限。用户访问 /sglang-omni 路径时将被正确重定向，提升文档可访问性；变更仅涉及文档配置，不触及核心代码或 API。

关联脉络

从近期历史 PR 看，此 PR 与以下文档相关变更类似：

• PR #23486：为 Qwen3.6 文档添加新变体支持，同样修改了 docs_new 目录下的文件。
• PR #23459：更新 Ascend NPU 最佳实践文档，也涉及 docs_new 配置。
  这些 PR 共同反映了文档系统的持续维护模式，通常涉及配置更新或内容添加，且多伴随 run-ci 标签以确保测试通过。