标签： LLM

这条 “Upstream sync conflict” 并不是 RAGFlow 用户在本地运行时会遇到的报错，而是下游 fork 中自动化同步工作流误把错误的 git remote 当作 upstream，生成的一次误报 Issue；Issue 作者确认无需任何处理，已在 2026-09-15 关闭

该报错通常出现在用 Docker / Docker Compose 启动 RAGFlow 后，文档可以上传、接口也返回成功，但后台文档解析一直不执行；优先排查 entrypoint 启动 task_executor 时是否把 worker ID 作为位置参数传入，而不是用 -i/--index 传入

该报错发生在用 RAGFlow 的 Excel 解析器（ deepdoc/parser/excel_parser.py ）解析工作表时，如果工作表 used range 超过 10000 行，而前 100 行恰好全是空白，解析器会把整张表当成空表丢弃， RAGFlowExcelParser.html

该报错通常出现在 Apple Silicon 上用 llama.cpp Metal 后端、经由共享库（in-process）反复调用 Qwen2.5-Omni 音频推理时：负载下偶发返回 2,048 个乱码 token，但没有任何后端报错。优先排查采样是否可复现（temp 0 + 固定 seed）、

该问题出现在使用 llama.cpp 的 llama-server 运行推理速度约 100 T/s 的 reasoning 模型时，前端 Firefox 打开 WebUI 并生成较长的 reasoning 输出，导致客户端 Firefox 占用 100% 单核 CPU。优先排查方向是 WebUI 前