执行摘要

本 PR 通过 pin 定 ModernVBERT/colmodernvbert-merged 模型的特定 revision，修复了因该模型更新支持 transformers v5 而导致的 CI 失败，确保多模态测试稳定运行，避免了外部依赖变更对开发流程的干扰。

功能与动机

CI 流水线在 ModernVBERT/colmodernvbert-merged 模型更新后出现失败，具体原因是模型升级至 transformers v5 导致兼容性问题。PR body 明确指出："ModernVBERT/colmodernvbert-merged was just updated to support transformers v5, but it caused a CI failure." 因此，需要锁定模型版本以恢复测试稳定性，确保多模态模型测试套件可靠执行。

实现拆解

变更涉及两个关键文件，按模块拆解如下：

• 测试层 (tests/models/multimodal/pooling/test_colmodernvbert.py)：
  • 添加常量 REVISION = "4a0a9f3ac7a7992fec410bfa8e3d080ac9a5bcee"，并更新所有测试函数调用：
    

    with vllm_runner(
        MODEL_NAME,
        revision=REVISION, # 新增参数
        runner="pooling",
        dtype=DTYPE,
        enforce_eager=True,
    )
    

• 受影响函数：test_colmodernvbert_text_token_embed、test_colmodernvbert_text_relevance_ordering、test_colmodernvbert_text_late_interaction、test_colmodernvbert_image_token_embed。

• 添加 FIXME 注释："Update colmodernvbert code to support the latest HF version and remove revision set."

• 模型注册层 (tests/models/registry.py)：

  • 在模型注册字典中为 "ColModernVBertForRetrieval" 添加 revision="4a0a9f3ac7a7992fec410bfa8e3d080ac9a5bcee" 字段，确保从 Hugging Face 加载时使用相同 revision。

评论区精华

Review 讨论中最有价值的交锋：

• 测试完整性争议：gemini-code-assist[bot] 指出初始提交中 revision 只应用于部分测试，强调需完善所有用例：

  "The revision pinning is incomplete. While it is defined here and used in test_colmodernvbert_text_token_embed, it is missing from the other tests..."
  最终 PR 修订完整，所有测试均传递 revision 参数。

• 代码规范改进：同一评论者建议常量名大写以保持一致性，PR 采纳后将 revision 改为 REVISION。DarkLight1337 补充建议添加代码注释，PR 添加了 FIXME 注释以指导未来维护。

风险与影响

风险：

• 版本锁定过时风险：如果 pin 定的 revision 未来不再兼容 transformers 更新，测试可能遗漏潜在兼容性问题，需定期手动更新 revision。具体到 test_colmodernvbert.py，测试逻辑依赖于固定版本，增加了回归风险。
• 维护负担：长期依赖外部模型特定版本，需团队监控 Hugging Face 更新，否则可能导致测试失效或技术债务累积。

影响：

• 用户影响：无直接用户可见变化，变更是内部 CI 修复。
• 系统影响：确保多模态测试套件稳定，减少 CI 中断频率，提升开发效率。
• 团队影响：降低了因外部依赖变更导致的维护压力，但引入了定期检查 revision 的任务。

关联脉络

从历史 PR 分析看，本 PR 与以下相关：

• #38629：处理 PaddleOCR-VL 图像处理器在不同 Transformers 版本中的兼容性问题，同样涉及多模态模型和版本控制，反映了团队在多模态领域应对依赖更新的模式。
• #37766：解决 CI 安装依赖死锁，共享 CI 基础设施维护主题，表明团队持续优化测试环境和构建流程。
  这些 PR 共同揭示了 vLLM 仓库在维护多模态模型兼容性和 CI 稳定性方面的演进趋势，通过小范围修复应对快速变化的外部依赖。