Fix case-insensitive handling of text MIME types for FileResource
在 MCP Python SDK v2.x 中， FileResource 对 MIME 类型（如 Text/Markdown 、 TEXT/plain ）做了大小写不敏感处理，已修复“混合大小写 text/* 被当作二进制”的问题。若你仍遇到混合大小写 MIME 类型被当作 blob 返回，优先升
分类： AI 工具排错
[Bug]: Using the official interface to call the agent application in Ragflow, the parameters in the initial component cannot be passed in
![[Bug]: Using the official interface to call the agent application in Ragflow, the parameters in the initial component cannot be passed in](https://www.chat-gpts.plus/wp-content/uploads/2026/08/9617-f9a4f153-768x403.jpg)
在 RAGFlow v0.20.1 中通过官方 HTTP 接口调用 Agent 应用，Begin（开始）组件参数无法传入，通常是因为请求体格式与后端期望的 schema 不一致。优先检查请求体中 inputs 对象的嵌套结构和参数名是否正确。
[Question]:GPT-OSS with JSON Structured Output caused error for LLM
![[Question]:GPT-OSS with JSON Structured Output caused error for LLM](https://www.chat-gpts.plus/wp-content/uploads/2026/08/9462-601c3b24-768x403.jpg)
这个报错通常出现在 RAGFlow 的 LLM 节点使用 GPT-OSS 并开启 JSON Structured Output 时，模型返回了空字符串或非法 JSON，导致输出解析失败。优先检查 LLM 实际返回内容是否为空白，并简化 JSON 输出结构。
[Bug]: If you click the pause button before the AI finishes its response, it will stop replying to you.
![[Bug]: If you click the pause button before the AI finishes its response, it will stop replying to you.](https://www.chat-gpts.plus/wp-content/uploads/2026/08/9641-3017b443-768x403.jpg)
在 RAGFlow 聊天界面中，如果 AI 回答尚未结束时点击暂停按钮，再发送下一条消息，AI 将不再回复。优先尝试刷新页面或重置当前会话，因为暂停操作可能导致前端状态未能正确清理。
file_types filed does not take compound field extensions like *.nii.gz
这个报错发生在 Gradio 的 gr.File 组件上传多段后缀文件（如 .nii.gz 、 .tar.gz ）时，因为校验逻辑只取最后一个后缀，导致无法匹配。优先排查你使用的 gradio_client 中 utils.is_valid_file 的实现，或暂时用 .gz 这类单段后缀绕过。
Transparency Settings Not Applying Consistently in Dark Mode
该报错发生在 Gradio 自定义主题的暗色模式下，透明度设置（如 `block_background_fill_dark` 和 `checkbox_background_color_dark`）未能一致地应用到所有组件块，且复选框背景不透明。优先排查方式是升级到最新版 Gradio，因为该问题已在
Batch install/uninstall map every 404 to the “default channel” message, masking the real denial reason
当 ComfyUI 以非回环地址（如 --listen 0.0.0.0 ）启动时，批量安装/卸载自定义节点会因回环限制被拒绝，但错误提示被错误地映射为“默认频道（default channel）”限制，同时日志中给出的 allow_git_url_install 提示又与实际状态不符，导致用户无法定
ImportError: cannot import name ‘IDF_EMBEDDING_MODELS’ from ‘qdrant_client.qdrant_fastembed’ `
这是 LlamaIndex 的 Qdrant 集成与 qdrant-client 1.17.0 之间的兼容性问题，优先尝试将 qdrant-client 降级到 1.17.0 以下版本（例如 1.16.2）即可解决。
Misc. bug: chat-template rendering is O(N²) in emitted parts (gather_string_parts)
该报错是 llama.cpp 内部 `common/jinja/` 模块中 `gather_string_parts` 函数因使用 `vector::erase` 循环合并字符串导致 O(N²) 性能退化，常见于使用 llama-server 渲染包含大量工具（tools）定义的 chat temp
RuntimeError: Could not find nvcc and default cuda_home=’/usr/local/cuda’ doesn’t exist`. Note that pointing `CUDA_HOME` at the pip-bundled `nvidia/cu13` nvcc is not a fix — the JIT then fails o
该报错通常发生在 Blackwell 架构（SM120）GPU 上启动 vLLM 并启用 FlashInfer sampler 时，根因是系统 CUDA 环境与 Python 环境内 CUDA 工具链版本不一致（混用 12.8 与 13.x 组件），导致 FlashInfer JIT 编译时头文件与