MailUI4Agents

Files

JianFeeeee c0ab3f57b2 跨端: 顶部页签条改悬浮玻璃 + 深色压暗下限（修 8 处深色可读性）+ 手势判据自搭现场

用户：「顶部的收件箱发件箱和授权为什么不做成悬浮玻璃？」
问得对，而且它当时是**整页唯一一块实心白**。

★ 顶部页签条 → 悬浮玻璃
  `CommTabBar` 原来写的是 `backgroundColor(Theme.surface)`（系统卡片色＝实体）。
  上一轮把列表容器、卡片、底部导航条都玻璃化了，**唯独漏了这条** ——
  它既不是卡片也不是容器，是"条状 chrome"，逐处修时最容易漏的那一类。
  ⇒ 现在与底部浮动条**同一族**：圆角 + 左右留白 + `Theme.navMaterial`。
  ★ 几何常量复用底部条的（`TAB_BAR_RADIUS = NAV_BAR_RADIUS`、
    `TAB_BAR_SIDE = NAV_BAR_SIDE`），不各写一份 —— 两个数一旦分叉，
    "同一条轴线上的两种条"就不齐了。为什么选悬浮而不是 WebUI 的"通栏无底色"
    （WebUI 页签条自己**没有**底色，靠父面板的玻璃）也记在那个常量的注释里。
  新增判据：页签条必须与导航条同族（不许实体面 / 要引 TAB_BAR_* 常量），
  变异验证过（改回 `Theme.surface` 即红）。

★ 深色压暗下限 —— 本轮最重要的真 bug
  玻璃让壁纸**真的透进卡片**之后，"浅壁纸 + 深色文字令牌"这个组合会在
  **卡片内部**发生。设备实测（深色、aurora、压暗 37）：
      「角色」ink rgb(183,195,211) on bg rgb(68,95,128) = 2.57:1
      「创建时间」2.27:1、「状态」2.68:1、「压暗」2.19:1（共 8 段 <3:1）
  而**同一套代码在浅色下全部达标** ⇒ 差别不在"选错了色"，在"底没暗下来"。
  WebUI 早就撞过并写下了必然值（`index.css:442`）：
      .dark { --bg-dim-min: 92%; }     /* 浅色下是 0% */
      background-color: rgb(var(--bg-scrim) / max(var(--bg-dim), var(--bg-dim-min)));
  我们只有 `scrimOpacity(bgDim)`、**没有下限**。补上 `DARK_DIM_MIN = 0.92`
  （浅色下用户设的值照旧生效，不忽略设置）。
  复扫：低对比 8 段 → 通信 0 / 日历 0 / 联系 1 / 我的 1
  （剩下两条经手核是扫描器的假阳性：近黑底上把抗锯齿暗像素当成了"墨"）。

★ 手势判据"没有自己搭现场"（套件红、单独绿）
  `cross-client-gesture` 只保证"在月档"、**不保证在哪一月**，而它算的是
  相对最初那一月的 delta ⇒ 前面某个判据（或一次失败的手势）把日历翻到 10 月后，
  期望值就差一格。修法：先点「今天」归位到本月（该按钮语义就是"回本月"）。
  验证：从 9 月起步、从 10 月起步，两种脏状态都通过。
  ★ 顺带确认手势本体是好的：`--speed 1500` 时 1000px 要走 670ms，
    紧贴 `SWIPE_MAX_DURATION_MS=700` 而被丢弃；`--speed 3000` 两个方向都翻。

★ 判据基建：修掉一个**静默失效**的 API 名（沿用上轮的教训修法）
  `Surface.ets` 里两处块注释内嵌了 `/* ... */` —— 会把块注释**提前闭合**，
  于是后面的代码跑到注释外面（报"Use let instead of var"/"Invalid character"）。
  本仓已有这条纪律（"当 `code()` 因注释里的 `/*` 吞掉 import 时，改注释文本"），
  这次又踩了两处（`Surface.ets` 与 `Appearance.ts`）。

判据：files=32 ran=32 checks=519 pass=519 fail=0 red=0；baseline 7/7✓。

2026-09-20 09:01:46 +08:00

components

按 pi 复核改五处：判据的"值/行为"原则、真正的构建门、typecheck 进门、Go 判据零匹配、迁移归属

2026-09-14 15:41:52 +08:00

fixtures

test(设备证据): 第一次真机读回通过闸（前台=ours）—— 收两份真实证据

2026-09-15 12:09:37 +08:00

lib

跨端: 平板三处真 bug（返回回登录页 / 避让重复叠加 / 联系人卡被裁 10vp）

2026-09-19 23:38:35 +08:00

manual

fix(webui): 候选菜单改用不透明弹层表面 —— 半透明+背景模糊把背后的表单糊进了列表