上传失败时应依次检查格式大小、切换传输模式、清除缓存、重启云端图像服务：仅支持jpg/png/webp且≤20mb；关闭直传改用http回退；清空cache、service workers和indexeddb；若imgd服务非活跃则手动重启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用骡子快跑时尝试上传图片但操作失败，可能是由于网络连接异常、图片格式不支持、文件体积超限或云端虚拟机临时资源调度延迟所致。以下是解决此问题的步骤：
一、检查图片格式与大小限制
MuleRun 对上传图像有明确的兼容性要求，仅支持 JPG、PNG、WEBP 三种格式，且单张图片不得超过 20MB。超出范围将触发前端拦截并静默终止上传流程，界面无明确报错提示。
1、打开图片所在文件夹，右键点击该图片，选择“属性”（Windows）或“显示简介”（macOS）。
2、确认“类型”字段是否为 JPG、JPEG、PNG 或 WEBP；若为 BMP、TIFF、GIF（非静态）、HEIC 等格式，则需转换。
3、查看“大小”字段，如超过 20MB，使用系统自带画图工具或在线压缩服务（如 TinyPNG）进行无损压缩。
二、切换上传通道与网络环境
MuleRun 默认通过 WebRTC 直传至用户专属云端虚拟机，若本地网络启用严格防火墙、企业代理或 IPv6 不稳定，可能导致直连握手失败，表现为进度条卡在 0% 或直接跳转回上传按钮。
1、在上传界面右上角点击齿轮图标，进入“传输设置”。
2、关闭“启用高速直传模式”，改选“兼容模式（HTTP 回退）”。
3、断开当前 Wi-Fi，切换至手机热点或其他可信网络，重新尝试上传。
三、清除运行时缓存并重置图像模块
浏览器中 MuleRun 的图像处理组件（ImageProcessor v2.3.1）会缓存缩略图生成上下文，若此前发生过中断上传，残留锁文件可能阻塞新任务队列，导致后续上传请求被忽略。
1、在当前页面按 Ctrl+Shift+I（Windows/Linux）或 Cmd+Option+I（macOS）打开开发者工具。
2、切换至“Application”选项卡，左侧展开“Clear storage”，点击“Clear site data”。
3、勾选“Cache storage”“Service workers”“IndexedDB”，取消勾选“Cookies”，点击“Clear site data”。
4、关闭全部 MuleRun 标签页，重启浏览器后重新登录账号。
四、验证云端虚拟机图像服务状态
每台用户专属的 7×24 小时云端虚拟机独立运行图像解析服务（imgd），若该服务因沙箱内存回收意外退出，将导致上传成功但无响应，后台日志中可见 “imgd: no heartbeat in 90s”。
1、进入 MuleRun 主界面，点击左下角用户头像，选择“虚拟机控制台”。
2、在控制台命令行输入 systemctl is-active imgd，回车。
3、若返回结果为 “inactive”，继续输入 systemctl restart imgd 并回车。
4、等待约 8 秒后，页面右上角通知栏应出现绿色提示：“图像服务已就绪”。
