标签： Transformer

该报错发生在 Transformers 的自动语音识别（ASR）pipeline 处理双声道（stereo）音频时。若音频由 soundfile 或 librosa 加载（形状为 samples × channels），pipeline 内部用 mean(axis=0) 降混音会错误地按时间轴求均值

该报错发生在 Transformers 库的 text-generation pipeline 中，当用户直接设置 model.generation_config.max_new_tokens 后，pipeline 内部生成配置的合并顺序错误，导致模型级配置被 pipeline 默认值覆盖。优先排查

该报错发生在 Transformers 库的投机解码（Speculative decoding）流程中，当候选生成器（candidate generator）返回的 logits 与其实际采样所用的分布不一致时触发。优先检查使用的候选生成器类型（如 DFlashTokenCandidateGener

这个报错通常发生在使用 Transformers 的 Whisper 模型进行批处理推理时，输入音频小于 30 秒但未按 Whisper 的固定输入长度要求进行填充或截断。优先排查特征提取器（Feature Extractor）是否在短音频场景下正确设置了 padding 和 truncation

该问题发生在对 Transformers 主分支执行安全审计时，发现 `src/transformers/dependency_versions_table.py` 中多个核心依赖的下限版本过低，存在已知安全漏洞。优先排查上述依赖项在当前项目环境中的实际安装版本，并更新 `dependency_ve

该报错通常出现在使用 Transformers 5.x 加载依赖远程代码（remote_code）的模型（如 moonshotai/Kimi-K2.5）时，原因是 v5 移除了内部函数 is_torch_fx_available ，而模型仓库中的远程代码仍在调用它。优先排查当前 Transforme

该报错通常是因为类名大小写不匹配导致，当前 transformers 中实际导出的是 MetaClip2Model （clip 为小写），而示例代码中误写为 MetaCLIP2Model （CLIP 为大写）。优先将代码中的类名改为 MetaClip2Model 即可解决。