分类： AI 工具排错

在 Windows 上使用 faster-whisper 处理部分音频文件时，开启词级时间戳（word_timestamps）会触发原生代码整数除零崩溃，进程被直接终止且无法在 Python 层捕获；优先排查受影响的音频片段、启用的 word_timestamps 和 vad_filter 组合，并

当你在 Open WebUI 的知识库中用默认加载器上传二进制文件（包括扩展名被允许但内容并非文本的 .txt 文件）时，后端编码检测会回退到 latin-1 解码，把乱码当成正文嵌入向量库，并标记为 completed 。优先排查文件是否为真正的文本内容，以及是否走了默认 TextLoader 回

当 Open WebUI 与 Open Terminal（或同类 Terminal Server）部署在 Docker Compose 同一内网、通过公网域名/反向代理访问 Open WebUI 时，前端会尝试直接用浏览器访问 http://open-terminal:8000 这类仅容器网络可达的

当你上传的扩展名（如 .dwg、.stl）不在 LobeChat 分块解析器的支持列表中时，前端仍会自动创建分块任务，最终在文件上显示误导性的“Chunking failed”和无效的重试按钮。优先排查上传文件扩展名是否被分块解析器实际支持，而不是只看 MIME 类型。

在 LobeChat v2.2.17 中，当 Agent A 通过 lobe-agent-management 的 callAgent 调用 Agent B 时，B 的子运行会继承调用方 A 所在话题锁定的 model / provider ，而不是 B 自己配置的模型，导致报错 [Bug] cal

当你在 Gradio 中使用 gr.ImageEditor() 处理带透明通道的 PNG（RGBA）时，组件会丢弃 alpha 通道并强制转为 RGB，导致输出图片透明背景变黑或变白。这是组件历史上的已知限制，并非配置错误，需要升级到包含修复的 Gradio 版本。