执行摘要

本PR实现了LTX-2扩散模型的两阶段视频生成管道，通过新增上采样器、扩展管道阶段和更新配置，支持低分辨率生成后上采样精炼。变更涉及文档、核心管道、模型加载和测试，提升了视频生成质量，是扩散模块的重要功能扩展。

功能与动机

PR旨在支持Lightricks/LTX-2模型的两阶段生成功能，以生成更高分辨率的视频。从CLI示例可见，用户需指定--pipeline-class-name LTX2TwoStagePipeline来启用此功能，同时可覆盖空间上采样器和蒸馏LoRA路径。动机是集成该先进模型到SGLang框架，增强视频生成能力，满足用户对高质量输出的需求。

实现拆解

• 文档更新：docs/diffusion/compatibility_matrix.md添加LTX-2支持，说明两阶段用法和自动路径解析。
• 配置修改：python/sglang/multimodal_gen/configs/pipeline_configs/ltx_2.py调整管道参数，如VAE压缩比和generator_device默认值。
• 新增上采样器：python/sglang/multimodal_gen/runtime/models/upsampler/latent_upsampler.py实现空间上采样模型，包含BlurDownsample和PixelShuffleND等组件。
• 管道阶段扩展：python/sglang/multimodal_gen/runtime/pipelines_core/stages/upsampling.py新增LTX2HalveResolutionStage、LTX2LoRASwitchStage和LTX2UpsampleStage，处理分辨率调整、LoRA切换和上采样逻辑。
• 注册逻辑：python/sglang/multimodal_gen/registry.py新增has_registered_diffusion_model_path函数，改进模型检测以支持LTX-2。
• CLI和服务器参数：python/sglang/cli/utils.py和python/sglang/multimodal_gen/runtime/server_args.py扩展参数解析，支持--pipeline-class-name和组件路径（如--spatial-upsampler-path）。
• 测试基准：python/sglang/multimodal_gen/test/server/perf_baselines.json添加ltx_2_two_stage_t2v性能基准用例。

评论区精华

Review评论为空，仅由mickqian批准。提交历史显示60次提交，包括多次调试和修复，如对齐潜变量布局、修复CFG路径和调整LoRA合并，表明实现细节经过迭代优化，但讨论未在review中公开记录。

风险与影响

• 技术风险：新增上采样器可能影响推理性能；管道复杂性增加维护难度；自动路径解析可能失败于网络或文件问题；LoRA切换机制可能引入不稳定性；测试覆盖有限，仅有一个性能基准用例。
• 影响分析：对用户提供新功能，提升视频生成体验；系统代码库复杂度增加，需持续维护新组件；团队需熟悉扩散模型的两阶段生成逻辑，可能增加学习成本。

关联脉络

与近期PR如#22040（扩散模型CLI修复）同属扩散模块演进，显示团队在扩展模型支持和优化用户体验。历史PR中多涉及性能优化（如JIT激活回滚）和测试改进，本PR延续了功能增强趋势，是扩散模型支持的重要一步。