分类： AI 工具排错

此报错通常发生在 AnythingLLM 桌面版通过 CLI 调用 Azure Foundry 本地服务时，由于 Foundry 0.10.2 及以上版本调整了命令行参数，导致旧的命令格式失效。优先排查 Foundry 版本并尝试执行 foundry --help 查看当前可用的命令结构。

这个报错通常发生在 AnythingLLM 通过 Docker 处理多页扫描版 PDF（尤其是 1-bit 位图、CCITT G4 压缩的扫描件）时。优先排查 PDF 内嵌图片的编码格式，并降低 OCR 并发 worker 数量。

当群组会话已选定模型后，群组成员的独立模型设置可能被忽略，成员回复会沿用群组会话的主题模型而非自身配置。优先检查成员 Agent 是否被显式传入了模型覆盖参数。

在 InvokeAI 的 ROCm Docker 容器中遇到 CPU 回退，核心报错为 No module named 'kernels' 。该问题通常源于容器内缺少 ROCm 相关依赖或设备权限配置不当，优先排查容器内是否包含 rocminfo 工具以及 render 组的 ID 是否与宿主机一致

这个报错通常发生在 Gradio 的 gr.Model3D 组件尝试加载纯点云（只有顶点坐标和颜色、没有三角面）的 .ply 或 .obj 文件时，渲染结果为空。优先排查本地 Gradio 版本是否为 4.38.1，并尝试将 display_mode 设置为 "point_cloud" 验证是否仍然

当你把 Gradio 应用挂载到 FastAPI 上，并用 FastAPI 的 CORSMiddleware 限制跨域来源时，Gradio 自带的 CORS 中间件会覆盖你的配置，导致 `Access-Control-Allow-Origin` 直接反射请求中的 `Origin` 头。优先排查你是否