2026-08-04-dashboard-gray-overlay-port.md 1.5 KB

Dashboard 灰色遮罩与验收端口

  • 日期:2026-08-04
  • 状态:verified
  • 优先级:P0
  • 范围:generic
  • 目标版本:0.5.2 后续开发基线(本轮未发布 npm)

验收反馈

  • 用户预期 Dashboard 使用默认端口 4320,临时验收地址实际为 4323。
  • Agent 工作台首屏被灰色半透明层覆盖,设置抽屉本身未显示。

结论

  • 默认端口没有修改,仍为 4320。
  • 本次使用 4323 是因为本机 4320 已运行另一套工作台,避免终止现有服务。
  • 灰屏不是主题色,而是关闭态抽屉遮罩被全局页面子项入场动画从 opacity: 0 动画到 opacity: 1。

修复

  • Agent 工作台直属子项不再继承通用页面区块入场动画。
  • 关闭态遮罩保持 opacity: 0 和 pointer-events: none。
  • 打开态遮罩立即切换到 opacity: 1,设置抽屉立即可见。
  • 实时状态刷新会重建抽屉 DOM,因此开关状态不使用 CSS 过渡,避免动画被反复重置。
  • 修复同步到独立通用仓、旧通用工作副本和小牛业务安装副本。

验收

  • 两份通用源 agent-workspace-ui-smoke-test.js 为 11/11(含全自动接管 UI 契约);业务安装副本的灰屏专项保持既有 10/10。
  • 关闭态:遮罩透明、抽屉隐藏、页面可交互。
  • 打开态:遮罩和抽屉立即显示,不受实时数据刷新影响。
  • 再次关闭:遮罩恢复透明、抽屉隐藏。
  • 页面标题、正文、健康接口正常,浏览器运行异常为 0。