故障排查GitHub issue2 分钟阅读排错/错误码

FastGPT 聊天窗口菜单冲突:历史问题与复现检查

嵌入式聊天窗口的菜单冲突需要结合具体按钮、嵌入方式和屏幕尺寸复现。原 Issue 只描述了界面冲突,排查应先确认按钮所属组件及预期交互。

嵌入式聊天窗口的菜单冲突需要结合具体按钮、嵌入方式和屏幕尺寸复现。原 Issue 只描述了界面冲突,排查应先确认按钮所属组件及预期交互。

历史范围与已知事实

Issue #5731 于 2025 年 9 月提出隐藏菜单按钮的需求。维护者要求补充截图,原记录缺少版本、截图和复现步骤,因此只能据此确认存在一项界面需求。具体隐藏参数需要以所用版本的公开配置为依据。

诊断步骤

  1. 记录 FastGPT 版本、发布渠道及嵌入方式,截取完整窗口和冲突按钮,注明点击后出现的行为。
  2. 免登录窗口发布文档 核对嵌入代码,在空白测试页中复现同一窗口。
  3. 分别测试桌面和移动端宽度,并对比原网站与测试页。若冲突只出现在原网站,检查宿主页浮层位置、层级和点击区域;若两处均出现,继续检查窗口自身配置及版本。
  4. 对拟调整的样式或交互在测试页验证,检查菜单、发送、关闭窗口、键盘焦点等操作。

验证结果

形成“版本 + 嵌入代码 + 截图 + 最短复现步骤”的记录。只有明确的组件配置或代码改动通过复测后,才能将其作为该环境的处理方法。按钮隐藏需求涉及访问限制时,还需在服务端验证对应功能权限。