快速结论:在 Dify Studio 工作流中打开内嵌 Agent 节点的配置弹窗,当浏览器视口窄于 xl 断点(1280 CSS 像素)时,弹窗会丢失两栏布局:Configure 面板保留桌面端宽度,Build/Preview 折到下方,关闭按钮随预览页头下移。优先排查内嵌弹窗对共享 AgentConfigureWorkspace 的窄屏覆盖是否缺失。
适用环境:Dify 自托管源码构建(Issue 记录于 0d5b00be02,main 分支 bb15220676 同样受影响);前端为 Web 界面,复现窗口尺寸包括 1263 × 772 和 1024 × 768。Issue 未提供操作系统、浏览器、Python、CUDA 或显卡信息。
最快修复方案:暂无确认的一步修复方案。Issue 讨论指向的方向是:仅针对内嵌 Agent 弹窗补充窄屏布局覆盖,而不全局修改共享断点;该方向未经 Issue 明确验证。
注意事项:独立 Agent Configure 页面复用同一个 AgentConfigureWorkspace,且其窄屏纵向重排属于已记录的正常行为,修改时不能波及该页面,需做回归检查。
问题场景
在 Dify Studio 中打开一个 Workflow,添加 Agent 节点并选择 Start from Scratch,或打开已有内嵌 Agent 的配置。将浏览器视口缩到 1280 CSS 像素以下(Issue 在 1263 × 772 本地复现),内嵌 Agent 弹窗的 Configure 与 Build/Preview 两栏布局被破坏。
报错原文
Inline agent dialog breaks its two-column layout in smaller windows
原因分析
根据 Issue 讨论,可能原因集中在共享工作区组件的响应式规则与调用方的覆盖差异:
- 共享
AgentConfigureWorkspace在xl以下应用max-xl:flex-col,预览区域也切换为固定高度、不伸缩的布局,因此两栏变成上下堆叠。 - Configure 面板在窄屏下仍保留桌面端的最大宽度与 flex basis,于是旁边留下大片空白。
- 内嵌弹窗的关闭按钮被传入预览页头,所以页头下移时关闭按钮也跟着跑到弹窗中部。
- 关键差异:独立 Agent Configure 页面同样使用该 workspace,但显式提供了窄屏覆盖;内嵌弹窗只给面板传了
min-w-90,缺少对应覆盖。
环境排查
- 确认 Dify 前端版本/提交是否落在受影响范围(
0d5b00be02、bb15220676)。 - 确认复现窗口宽度低于
xl断点(1280 CSS 像素),并记录具体尺寸。 - 确认触发入口是工作流内嵌 Agent 弹窗,而非独立 Agent Configure 页面(后者纵向重排为预期行为)。
- 检查控制台无相关前端报错;Issue 未涉及 Python、CUDA、PyTorch、显卡或节点依赖版本。
解决步骤
- 在窄于 1280 像素的视口下复现:工作流 → Agent 节点 → Start from Scratch 或已有配置,记录 Configure 面板宽度、Build/Preview 位置和关闭按钮位置。
- 定位内嵌弹窗对
AgentConfigureWorkspace的调用处,对比独立 Configure 页面的调用参数,找出窄屏覆盖的缺失项。 - 可优先尝试:只在内嵌弹窗一侧补充窄屏覆盖(面板宽度、flex basis、预览区高度与伸缩行为),不要全局修改共享
xl断点。 - 在独立 Agent Configure 页面执行回归检查,确认其原有的窄屏纵向重排行为未被改变。
- 如无法自行修改,可在 Issue 中补充复现尺寸和截图,等待维护者处理。
验证方法
将视口调到 1263 × 772、1024 × 768 等宽度后重新打开内嵌 Agent 弹窗:两栏应随弹窗一起收缩,Configure 内容在自身面板内滚动,Build/Preview 保持在右侧,关闭按钮固定在右上角;同时确认独立 Configure 页面布局与此前一致。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


