[Bug]: StandardizeImage in deepdoc/vision/operators.py has a wrong name ‘StandardizeImag’

快速结论：该报错因为 deepdoc/vision/operators.py 中类名拼写错误导致，StandardizeImage 被误写为 StandardizeImag，使得预处理操作无法匹配到对应类。优先排查该文件中是否存在同类名拼写错误。

问题场景

用户使用 RAGFlow v0.17.1 版本（commit id: 4326873a），在调用图片预处理管线时，发现 StandardizeImage 操作无法生效，原因是对应的类定义名称拼写错误。排查时打开源码 deepdoc/vision/operators.py 即可发现问题。

报错原文

# 不是显式报错，而是操作未生效。根源是类名拼写错误：
# 类名定义为 StandardizeImag（缺少字母 e），
# 而外部引用或配置中查找的 key 是 'StandardizeImage'，无法匹配。

原因分析

可能原因：deepdoc/vision/operators.py 中的类定义存在 typo，类名应为 StandardizeImage，但实际写成了 StandardizeImag。当预处理管线通过 key 来查找 'StandardizeImage' 操作时，找不到对应类，导致该预处理步骤被跳过。

环境排查

• RAGFlow 版本：v0.17.1（确认 commit id 为 4326873a）
• 影响文件：deepdoc/vision/operators.py

解决步骤

1. 打开 deepdoc/vision/operators.py 源文件。
2. 搜索 class StandardizeImag，将类名改为 class StandardizeImage（补齐缺失的字母 e）。
3. （可选）检查该文件中是否有其他类似拼写错误，例如检查所有预处理器类名是否与外部配置/引用一致。
4. 提交修复，或替换为官方已修复版本（参考 PR #16785）。

验证方法

重新运行图片预处理流程，确认 StandardizeImage 操作可以正常执行。也可直接查看操作日志，观察是否出现该预处理步骤的调用记录。

参考来源

infiniflow/ragflow #7316

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。