# PR #21410 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[Bugfix] Disable ci for .md files
- 合并时间：2026-03-26 01:19
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/21410

---

# 执行摘要
本 PR 通过修改多个 CI 工作流配置文件，添加 .md 文件排除规则，修复了 .md 文件更改意外触发 CI 测试的 bug，优化了 CI 触发逻辑，以减少不必要的测试运行并节省资源。

# 功能与动机
修复 Issue 21409，具体动机是防止 .md 文件（如文档文件）的变更触发 CI 测试，以避免资源浪费。从 PR body 中引用："Fix of https://github.com/sgl-project/sglang/issues/21409"，但 Issue 详情未提供，推断为优化 CI 效率。

# 实现拆解
修改了 6 个 CI 配置文件，均位于 `.github/workflows/` 目录下，属于 CI 基础设施模块。关键改动是在每个文件的路径过滤部分添加 `!**/*.md` 条目，以排除所有 .md 文件。例如，在 `.github/workflows/pr-test.yml` 中：

```yaml
- "!**/*.md"
```

类似修改应用于其他工作流文件，覆盖 AMD、NPU、Xeon、XPU 等硬件平台的 CI 触发规则。具体文件列表如下：
- pr-test-amd-rocm720.yml
- pr-test-amd.yml
- pr-test-npu.yml
- pr-test-xeon.yml
- pr-test-xpu.yml
- pr-test.yml

# 评论区精华
主要讨论发生在 Issue 评论中：
- **Fridge003**指出："This commit will unexpectedly trigger every test"，担忧修改可能导致 CI 错误触发。
- **hnyls2002**建议："@Kangyan-Zhou @ping1jing2 @OrangeRedeng Please change the rules similar to https://github.com/sgl-project/sglang/pull/21334"，推荐参考 PR #21334 的类似规则以确保正确性。
- **ping1jing2**确认："ok"，表示问题解决，修改被接受。

讨论焦点在于 CI 触发逻辑的设计权衡，通过借鉴已有实践来降低风险。

# 风险与影响
**风险分析**：风险较低，但需注意路径过滤语法 `!**/*.md` 的正确性，确保不会错误排除其他必要文件或导致 CI 触发失效。已有讨论中提到潜在触发问题，但参考 #21334 后缓解。

**影响分析**：对用户无直接影响；对系统影响正面，优化 CI 触发逻辑，减少不必要的测试运行，提高资源利用率；影响范围限于 CI 基础设施，程度为中等改进。

# 关联脉络
与历史 PR #21334 相关，后者可能涉及类似的 CI 触发规则调整（如收窄触发范围），显示团队在持续优化 CI 配置以减少噪音。从近期历史 PR 分析看，如 PR #21385（重构扩散 JIT 内核测试布局并收窄 CI 触发）和 PR #21455（简化 CI 检查动作），本 PR 是 CI 优化趋势的一部分，旨在提高开发效率。