Bug: Experiment comparison header shows inverted improvement/regression counts
该问题出现在 Langfuse 实验对比（Experiment comparison）视图的分数列头部，头部聚合的 improvement/regression 计数与左侧 observation panel 相反；优先核对头部聚合逻辑，而不是怀疑底层打分数据。该问题已在 PR #17929 中修复
分类： AI 工具排错
metadata, config and modelParameters are typed as objects in some schemas and untyped in others
这个报错通常出现在用 OpenAPI 规范生成 SDK 客户端时，某些 schema 把 metadata 、 config 、 modelParameters 等字段声明为 object（带 additionalProperties: true ），而另一些 schema 又完全没有声明 type
Database migration issue with pgsearch
这个报错通常出现在 LobeChat 连接数据库并执行 CREATE EXTENSION IF NOT EXISTS pg_search; 时，当前数据库版本或权限不支持 pg_search 。优先检查数据库是否为 PostgreSQL 17，以及当前数据库用户是否有创建扩展的权限。
Realtime API Pydantic Models incomplete for RealtimeResponseStatus type
当使用 openai-python SDK 的 Realtime API 处理失败响应（如推理限流 inference_rate_limit_exceeded）时，SDK 生成的 Pydantic 模型会丢弃服务端返回的 error.message，导致你无法看到 "We're currently
OAuth: 403 responses without insufficient_scope incorrectly retry with same token
当 MCP Python SDK 的 OAuth 客户端收到 403 响应、但 WWW-Authenticate 中的 error 不是 insufficient_scope（例如 invalid_token，或没有 error 字段）时，客户端仍会带上同一 token 再重试一次，导致没有意义的请
Initialize call hangs forever if MCP server does not return a `Content-Type: text/plain`
当 MCP 服务器对 initialize 请求返回的不是 text/event-stream （例如 text/plain ）时，MCP Python SDK 客户端会永久卡在 ClientSession.initialize() 上，报错 Initialize call hangs foreve
[Question]: Docs Generator download returns code 102 “Document not found” for DOCX, PDF and HTML
![[Question]: Docs Generator download returns code 102 “Document not found” for DOCX, PDF and HTML](https://www.chat-gpts.plus/wp-content/uploads/2026/10/16506-539c2ddf-768x403.jpg)
这个 [Question]: Docs Generator download returns code 102 “Document not found” for DOCX, PDF and HTML 通常出现在 RAGFlow Agent 工作流里，Doc Generator 节点已经在聊天窗口生成
[Bug]: After receiving mineru, the error “FAILED TO PARSE TABLE” occurred during the parsing process.
![[Bug]: After receiving mineru, the error "FAILED TO PARSE TABLE" occurred during the parsing process.](https://www.chat-gpts.plus/wp-content/uploads/2026/10/16114-b8de03ab-768x403.jpg)
该报错通常出现在 RAGFlow 接入 MinerU 解析含表格的 PDF 时，MinerU 已识别出表格区域但表格内容抽取结果为空，RAGFlow 因此写入占位文本。优先排查 MinerU 的表格抽取结果与解析方法配置，而不是 RAGFlow 本身。
Bug: Dataset overview status counts always show 0 (v0.25.6, frontend-backend data structure mismatch)
这个报错通常出现在 RAGFlow v0.25.6 数据集概览页，表现为“Total Files”正常但各状态计数全为 0；优先排查前后端 ingestions/summary 数据结构是否不一致，即前端读取的是顶层字段、而 API 返回的是 data.status 下的嵌套字段。
ValueError: LLM call blocked by before_llm_call hook
当你在 CrewAI 中使用原生 provider（openai / anthropic / bedrock / gemini / azure）或 LiteLLM fallback 的异步路径 acall() / kickoff_async ，并注册了 before_llm_call 拦截钩子时，钩