执行摘要

本PR在sglang仓库中引入了Lychee工具，用于自动化文档链接检查。通过分离本地离线检查和CI在线检查，在提升文档可靠性的同时避免阻塞贡献者工作流。关键变更包括新增配置文件和夜间CI工作流，并修复了多个文档中的broken链接。

功能与动机

此PR的动机是改善文档链接的可靠性，同时保持贡献者工作流程轻量级。根据PR body，CI将强制执行全链接检查（包括离线引用和在线外部链接），而本地lychee设置为仅手动运行，以避免因平台或网络问题阻塞本地提交。这跟随了@zijiexia之前的修复方向，旨在减少broken链接对用户体验的影响。

实现拆解

实现方案按模块拆解如下：

• 本地配置：添加.github/linters/lychee.toml，设置offline = true进行快速离线检查，排除本地端点（如localhost）。
• CI配置：添加.github/linters/lychee-ci.toml，设置offline = false进行在线验证，包含重试机制和排除列表（如Intel、OpenAI文档等噪声端点）。
• pre-commit集成：修改.pre-commit-config.yaml，将lychee钩子设置为stages: [manual]，使本地检查可选。
• CI工作流：在.github/workflows/lint.yml中添加离线检查步骤；新增.github/workflows/nightly-link-check.yml夜间工作流，使用GITHUB_TOKEN执行在线检查。
• 文档更新：更新docs/developer_guide/contribution_guide.md，提供链接检查命令指南。
• 链接修复：修复多个文档文件（如docs/basic_usage/deepseek_v3.md、examples/runtime/README.md）中的过期或错误链接。

评论区精华

review讨论中，最值得关注的交锋包括：

• zijiexia建议：'imho, I think a nightly link check ci might be a better choice as the link should not change really frequently.' 这引导了将在线检查移至夜间CI的设计决策，避免日常CI延迟。
• 关于不必要更改的讨论，如.gitignore添加文件，zijiexia评论：'Maybe we don't need to add this?' 最终作者简化了变更。
• 安全方面，zijiexia提出：'Maybe we need to pin lychee-action to a commit SHA for supply chain safety.' 作者在后续提交中固定了版本。
• 正则表达式检查：zijiexia询问：'Can you double check on this regex?' 作者回应并修复了example_image.png?raw=true的排除模式。

风险与影响

技术风险：

• CI工作流变更可能引入失败风险，尤其是夜间检查依赖外部网络，排除列表需持续维护以避免误报。
• 依赖lychee-action存在supply chain风险，已通过pin版本缓解。
• 本地手动检查可能被忽略，导致链接问题延迟发现。

影响分析：

• 对贡献者：需要适应新命令，但本地提交不受阻；CI作为最终关口，确保链接质量。
• 对系统：提升文档健壮性，减少用户访问broken链接的概率。
• 对团队：自动化检查降低维护成本，夜间模式平衡检查频率与资源使用。

关联脉络

从历史PR看，本PR与仓库近期的CI和文档改进趋势一致。例如：

• PR #21334 优化了multimodal CI以跳过文档文件变更，与本PR的链接检查互补，共同提升CI效率。
• PR #21283 涉及文档技能更新，反映团队对文档质量的重视。
• PR #20294 扩展CI测试套件，展示仓库在CI工作流上的持续投资。
  这些关联表明，本PR是sglang在基础设施和文档维护方面演进的一部分，旨在构建更健壮的开发者生态系统。