若MuleRun音频操作报错，应依次执行四步：一、用Audacity转为44.100Hz/16-bit PCM立体声WAV；二、关闭前端实时分析并选云端推理；三、手动填写元数据并跳过自动分析；四、清除缓存并重置音频沙箱。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 MuleRun 中执行音频生成、续写或上传操作时遭遇报错，例如“Audio decoding failed”“Feature extraction timeout”或“Unsupported format: .wav (16-bit float)”，则可能是由于音频格式兼容性、特征提取链路中断或模型输入约束冲突所致。以下是解决此问题的步骤：
一、校验并转换音频文件格式与编码参数
该方法针对因采样率、位深或容器封装不满足 MuleRun 音频预处理模块要求而触发的解码失败类错误。系统仅接受标准 PCM 编码的 WAV 或 MP3，且明确拒绝浮点型样本、非整数采样率（如 44.1001 kHz）及多声道非立体声配置。
1、使用 Audacity（免费开源工具）打开原始音频文件。
2、点击菜单栏“编辑”→“首选项”→“质量”，将默认重采样算法设为“高质量Sinc（最佳）”。
3、点击“轨道”→“混音”→“混音到立体声”，确保声道数为2。
4、点击“文件”→“导出”→“导出为 WAV”，在弹出窗口中选择“WAV（Microsoft）16-bit PCM”格式，采样率设为44100 Hz，点击保存。
5、重新上传该转换后的文件至 MuleRun 工作区，触发续写或生成流程。
二、禁用实时音频分析插件并切换推理模式
该方法适用于出现“Feature extraction timeout”或界面卡死在“Analyzing audio…”阶段的情况。MuleRun 默认启用前端实时频谱分析插件，但在低性能设备或高延迟网络下易超时中断，导致后续模型加载失败。
1、进入 MuleRun 控制台，点击右上角用户头像 →「设置」→「音频处理偏好」。
2、关闭开关启用客户端实时特征分析。
3、在「推理模式」下拉菜单中，选择云端完整分析（推荐）而非“混合分析”或“本地轻量分析”。
4、保存设置后，刷新页面，重新提交音频任务。
三、手动指定音频元数据覆盖自动识别结果
该方法用于绕过因音频头信息损坏或缺失导致的元数据解析异常，例如报错“Invalid duration detected: NaN”或“BPM estimation failed”。MuleRun 在未获取可靠节拍/调性信息时会中止续写流程。
1、在主工作区上传音频后，点击播放器右侧的⚙️ 元数据覆盖按钮。
2、在弹出面板中，手动填写以下字段：采样率（Hz）填44100；时长（秒）填实际值（可用系统播放器确认）；BPM 填120（若不确定可暂用此默认值）；调性填C major。
3、勾选跳过自动分析，强制使用本配置复选框。
4、点击“应用并继续”，再执行续写或生成操作。
四、清除音频专用缓存与重置音频处理沙箱
该方法适用于反复出现相同报错（如“Failed to load AudioProcessor module”）、更换文件仍无效，或此前成功任务突然失效的情形。表明本地音频处理环境存在状态污染或依赖版本错配。
1、关闭所有 MuleRun 页面及后台进程（Windows 可通过任务管理器结束“mulerun”相关进程；macOS 使用活动监视器搜索“MuleRun”）。
2、按下 Win + R（Windows）或 Cmd + Shift + G（macOS），分别输入以下路径并删除对应文件夹：
Windows：%APPDATA%\MuleRun\AudioCache
macOS：~/Library/Caches/MuleRun/AudioEngine
3、重新启动浏览器，访问 https://app.mulerun.ai/settings/audio-reset 页面，点击“执行音频沙箱重置”按钮。
4、等待页面提示“Audio runtime reinitialized”，随后返回工作区重试任务。
