Files
deerflow-code/frontend-web/docs/麒麟Chrome80-真机回归清单.md
T

3.9 KiB
Raw Blame History

麒麟系统 Chromium ~80 真机回归清单

背景:Tailwind v4 依赖 @layer(Chrome 99+)/@property(85+)/color-mix、oklch(111+),麒麟系统自带的 Chromium 80 多浏览器上整站样式失效。本分支(feat/tailwind-v3-legacy-chrome)完成 v4→v3 降级迁移,产物结构性指标已全部达标(详见提交 1607c7fe / 40b02520 / e54abcc6)。本文档供真机验收使用。

一、测试准备

  1. 在麒麟机器的浏览器地址栏输入 chrome://version,记录完整版本号(重点关注是否 ≥84 —— 低于 84 时 flex gap 不支持,各处间距会塌陷,需单独反馈)。
  2. 部署本分支 pnpm build 产物(或开发机 pnpm preview 后用麒麟机器访问)。
  3. 先跑一次 pnpm check:legacy-css(开发机),确认绿色再发版。

二、页面巡检(明/暗两套主题各过一遍)

页面 路径 重点检查点
登录/落地页 / 布局完整、文字阴影(hero 标题)、无裸奔样式
问答首页 /chats/new 整体配色、输入框焦点环(回退为内层 outline)、常用提示词栏
对话流 任意会话 Markdown 渲染(标题/列表/表格/代码块/引用——streamdown 白名单类)、气泡圆角、流式输出
智能体 /page/workspace/agents 及详情 卡片、Tabs、新建页表单、技能穿梭框
圆桌会商 roundtable 页 左侧步骤条、消息气泡、流程图面板、暗色兜底配色
任务深链 ?taskId=&goPath=3qfx/rwfx/xdfx 左侧任务卡、目的树、快捷跳转栏(按钮管理配置项)
轻应用/菜单管理/敏感词 各管理页 Tabs、表格、弹窗
简洁模式 外观设置切换 无全局导航栏布局、右侧工具箱、引导高亮框
换肤 浅红/暗色/浅蓝/绿/冰蓝/浅黄 六套主题各自的 primary/ring 颜色、半透明档(primary/10 等)
大屏(dashboard-agent) 战情大屏页 时间线、图表、暗色文字覆盖
iframe 嵌入 ?embed=1&theme=dark-blue 去全局 chrome、强制主题生效

三、已知降级点(预期行为,非 bug)

  1. :has() 渐进增强(Chrome <105 不生效):按钮内含图标时内边距略宽、alert 带图标时首列宽度、item 带描述时对齐微差 —— 视觉细节,不影响功能。
  2. input-group 焦点环回退:聊天输入框的焦点指示从「整框 3px 环」回退为「内层输入控件 2px outline」;校验态从整框环回退为内层红色阴影 —— 仍有明确指示。
  3. :where() 圆桌字号缩放(Chrome <88 不生效):设置页调字号时圆桌页面小字号文本不跟随缩放,基础字号正常。
  4. textarea 自增高:field-sizing 需要 Chrome 123+,旧浏览器走原生 rows 行为(已有多行默认值)。
  5. prefers-color-scheme 单块:产物中 1 处 lightningcss 内部标记(--lightningcss-light/dark),无影响。

四、重点风险项(出现问题按此排查)

  • 整页无样式 → 确认产物是本分支构建(旧 v4 产物在 80 上必然裸奔);查 @layer。
  • 暗色主题失效 → 查产物 .dark .dark\: 前缀选择器是否存在(pnpm check:legacy-css 会拦)。
  • 弹层错位(下拉/气泡/选择器) → radix 弹层依赖 origin-[var(--radix-...)],确认类已生成。
  • 控制台语法错误/白屏 → JS 侧:确认构建 target: chrome80 且 polyfills.ts 在 main chunk 首位;记录报错栈反馈。
  • mermaid 流程图 / 地图(maplibre):重型库在 80 上的运行时差异,出现异常截图 + 控制台报错反馈,单独处理。

五、发版前自检(开发机)

pnpm build          # 构建绿
pnpm check:legacy-css   # 产物守卫:@layer/@property/:is() 为 0,color-mix 全部守护
pnpm typecheck      # 58 个存量错误 = master 基线(迁移零新增)