分类： AI 工具排错

AI 工具排错

MCP Tool execution hangs indefinitely in stdio mode when calling external Python scripts

在 Windows 系统上使用 FastMCP 的 stdio 传输模式时，当 MCP 工具调用外部 Python 脚本，会因子进程继承了服务端的 stdin（协议管道）而挂起无限等待。优先排查子进程创建时是否设置了 stdin=asyncio.subprocess.DEVNULL 。

celebrityanime
2026年 7月 26日

AI 工具排错

[Question]: [ERROR]Generate embedding error:SILICONFLOWEmbed.encode got invalid response from https://api.siliconflow.cn/v1/embeddings

该报错发生在 RAGFlow 调用 Siliconflow Embedding API 时返回了无效响应，常见原因是 API 服务不可用、模型名称注册错误、API Key 或配额异常，或 API 返回格式与 RAGFlow 预期不匹配。优先排查 Siliconflow API 的状态以及模型配置是否

celebrityanime
2026年 7月 26日

AI 工具排错

[Question]: Successful parsing and chunking but Retrieval Testing always has 0 Files

该报错通常在使用 RAGFlow -slim Docker 镜像时出现，解析和分块成功但检索测试始终显示 0 文件。优先排查镜像版本，建议切换到 nightly （非 nightly-slim ）镜像。

celebrityanime
2026年 7月 26日

AI 工具排错

Mistral OCR unusable as a document parser: mis-registered as image2text (“Can’t find model”); still reproduces on v0.26.x

该报错因 Mistral OCR 模型被错误注册为 image2text 类别导致，实际它是一个云端 OCR 文档解析器。优先排查 RAGFlow 模型目录中的 “Mistral OCR” 模型类型是否被正确识别为 ocr 而非 image2text ，并确认是否已升级到包含 #17057 修复的版

celebrityanime
2026年 7月 26日

AI 工具排错

The ‘Download’ and Remove Image’ buttons move beyond the visible area in full-screen mode at high image resolutions.

Gradio gr.Image 组件在 full‑screen 模式下，当图片分辨率过高时，右上角的 “Download”“Remove Image” 按钮会被推出可见区域或被滚动条遮挡，导致无法点击。优先排查 Gradio 版本是否为 5.47.2 或更早，并尝试使用较低分辨率图片或缩小浏览器窗口

celebrityanime
2026年 7月 26日

AI 工具排错

[Bug]: `litellm_settings.max_budget` ignores `budget_duration`; global proxy budget is a hardcoded trailing-30-day cap

在 LiteLLM 代理中设置 litellm_settings.max_budget 并指定 budget_duration 后， budget_duration 被忽略，全局预算实际按硬编码的过去 30 天滚动总花费生效，导致配置的每日/每周上限不重置。优先检查是否将 max_budget 与

celebrityanime
2026年 7月 26日