标签： Python

Confluence 或 Jira 增量同步时，如果文档更新落在“水位线所在的那一分钟”内，本次同步与下次同步都不会收录该文档，表现为文档永久漏同步。优先排查水位线（watermark）的时间精度与客户端过滤条件是否一致。

该报错描述的是 RAGFlow 数据源连接器完成 OAuth 授权后，access token、refresh token 与 client_secret 被明文写入 MySQL connector.config 字段，属于静态存储缺少加密，而不是授权流程本身失败。优先确认部署版本与 connect

该问题出现在使用 ROCm 版 vLLM（ ROCM_AITER_MLA 后端）+ aiter MLA decode 的场景：当 aiter 以 非持久（non-persistent）路径 、fp8 Q + fp8 KV、 gqa_ratio=16 、 decode_qlen 为 3–4 调用 ml

在 vLLM V1 引擎中，当用 --hf-overrides （dict 形式，例如 YaRN ×4）把目标模型的上下文扩展后，MTP draft 模型不会继承这次覆盖；draft 仍使用原生 max_position_embeddings （如 262,144）作为 max_model_len

该报错出现在 RAGFlow 生成 Wiki 的 REFINE 阶段：LLM 网关短暂返回 429 等瞬态失败，现有重试耗尽后页面被直接标记为失败，本轮运行不会再自动重试，即使网关随后恢复也只能手动 Update 才能补回。优先排查 LLM 网关的限流/配额状况，并确认是否已包含 #20930 的修

这个报错通常出现在 RAGFlow 管理后台的用户管理页：前端调用 GET /api/v1/admin/users 时未带分页参数，后端默认把 page_size 当作 10，导致账号数超过 10 个时，第 11 个及之后的用户看不到、也搜不到。优先排查后端 ListUsers 对缺省 page_s