[Bug]: Fig.X citation doesn’t appear on mobile/iPad

快速结论：该问题发生在 RAGFlow 0.24 版本中，用户通过 PC 端 Docker 运行 RAGFlow，在手机或 iPad 上远程访问时，聊天回答末尾的 Fig.X 引用内容（图片/图表注释）无法显示。优先排查 Radix UI HoverCard 组件在移动端是否缺少显式触摸事件处理。

问题场景

用户在 Windows PC 上通过 Docker 运行 RAGFlow，并在手机或 iPad 上通过浏览器远程访问 RAGFlow 的聊天界面。在 PC 端，鼠标悬停在 Fig.X 引用上可以正常显示具体内容；但在移动端/iPad 上，仅能看到 Fig.X 标记，无法触发展开查看内容。

报错原文

No explicit error code. Actual behavior: Fig.X citation content does not appear on mobile/iPad browsers. On PC, hovering over Fig.X displays the content correctly.

原因分析

RAGFlow 使用 Radix UI 的 HoverCard 组件来实现鼠标悬停显示引用内容的功能。Radix UI 理论上应自动将悬停交互转换为触摸兼容行为，但当前实现中 显式缺少 `onTouchStart`/`onTouchEnd` 触摸事件处理器。这导致在移动浏览器或 iPad Safari 上，HoverCard 无法可靠触发内容显示。

该问题在 Issue 报告时被认为是一个新发现的 Bug，未在现有 Bug 列表中找到。

环境排查

RAGFlow 镜像版本：0.24
部署方式：Docker (Windows 11 主机)
客户端设备：手机、iPad（Safari 或其他移动浏览器）
PC 端表现：正常（鼠标悬停可显示）
相关组件：Radix UI HoverCard
相关代码文件：web/src/components/next-markdown-content/index.tsx（约第 216-226 行）

解决步骤

注意：以下步骤基于 Issue 中分析的可能原因和修复方向，尚未经过官方验证。

确认问题范围：在不同移动端浏览器（如移动 Chrome、Safari）和 iPad 上测试，验证 Fig.X 引用是否均无法显示。
可优先尝试：检查 web/src/components/next-markdown-content/index.tsx 中 Radix UI HoverCard 的实现，确认是否未添加 onTouchStart 和 onTouchEnd 事件。
修复方向一：在 HoverCard 组件上显式添加触摸事件处理，确保在移动设备上能触发内容显示。示例（基于 Issue 分析）：
```
// 在 citation hover card 添加 touch 事件
onTouchStart={handleTouchStart}
onTouchEnd={handleTouchEnd}
```
修复方向二：在触摸设备上改用点击展开（click-to-reveal）模式代替悬停模式，通过检测用户设备类型或触摸支持来决定交互方式。
等待官方修复：该 Issue 已于 2026-07-01 关闭，建议拉取最新镜像或代码检查是否已包含相关修复。

验证方法

在手机或 iPad 上访问 RAGFlow 聊天界面，提出一个问题后等待回答中出现 Fig.X 引用。点击或触摸 Fig.X 链接，确认是否能正常显示对应的图片/图表内容。同时在 PC 端验证鼠标悬停功能是否依然正常工作。

参考来源

infiniflow/ragflow #13181

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

[Bug]: Fig.X citation doesn’t appear on mobile/iPad