MailUI4Agents

Files

JianFeeeee e54dc39f8f 跨端: 鸿蒙 2in1 键盘可达 + 悬停 + 沉浸顶栏 + 三键避让 + 修叠栈

用户四条：
①「2in1 手势」（选了 悬停/右键菜单/触控板 + 快捷键：主页回车写信、
   详情页回车回复、Esc 返回）
②「宽屏状态一个邮件被反复点击会被多次填充到右侧」
③「你在登陆页是不是没有做 enter 等键的监听」——**确实漏了**
④「app 顶栏为什么不沉浸」+「右侧三键应当有独立避让」

② 叠栈（实测复现 → 修 → 实测通过）
   根因是框架语义用错：pushPath 默认 LaunchMode.STANDARD 每次入栈 ⇒
   重建详情组件 + 重拉数据 + 重放入场动画；返回还要按多次。
   而 WebUI 是 `set({currentMail})` 幂等赋值（mailStore.ts:115）。
   改用 LaunchMode.MOVE_TO_TOP_SINGLETON（官方：同名已在栈里就移上去、
   不新建），MainPage + ContactsTab 两处 push 点都改（只改一边＝换栏点
   又不正常）。
   实测：连点同一封 3 次 → **点一次返回就回占位**（修复前要按 3 次）。

③ 登录页回车（用户点出来的真实缺失）
   WebUI 是 `<form onSubmit={submit}>`（LoginPage.tsx:92）——浏览器里
   输入框按回车就提交；鸿蒙登录页**一行键盘监听都没有**。
   补上，走**已有的** doLogin()（不另写一条登录路，免得与按钮的条件分叉）。

① 快捷键：新增 model/KeyboardShortcuts.ts（规则集中一处，三页共用）
   · 主页根 Stack：Enter → 写信（与 Ctrl+N 同一个 ComposeIntent.request）
   · 详情页：Enter → 开回复（复用 openReplyWithMorph，连动画都不另开）；
     Esc → 返回，且**弹层开着时先关弹层**再按才返回（否则用户想关回复框
     却被踢回列表，输入到一半的内容全没）
   · 用键事件**冒泡**：子组件先拿到、未消费才到页面根 ⇒ "详情优先、
     主页兜底"由框架保证，不是我自己排的优先级
   ★ 为何不用 keyboardShortcut：它只收组合键；不带修饰键时只认 FunctionKey，
     而 FunctionKey 枚举（enums.d.ts:3444）**没有 Enter**（只有 ESC/F1-F12/
     TAB/方向键）⇒ 单按回车表达不出来。

① 悬停反馈：MailRow/SentRow 挂 onHover + Theme.surfaceMuted
   （该令牌此前**零使用**，注释本就写着"列表行 hover"，正好归位）。
   不用 .hoverEffect()：系统叠层会与选中/未读的 accentSoft 叠成第三种颜色。
   ★ 状态存 mail_id 而不是布尔：行本体是 @Builder（无自身状态），
     布尔会变成"悬停一行、同栏全亮"，所以状态放栏上、存"是哪一封"。

④ 沉浸顶栏：EntryAbility 加 setWindowDecorVisible(false)
   实测（2in1 截图硬证）：标题栏(AgentMailHarmony)下面**还有一条白条**，
   内容从第二条下面才开始。根因是**从未调过装饰接口**⇒用系统默认（PC 带标题栏）。
   setWindowLayoutFullScreen(true) 管的是"内容铺到**屏幕**四边"，
   **不包含**"窗口自己的标题栏是否隐藏"——两件不同的事。

④ 三键避让：Insets 加 windowDecor + getWindowDecorHeight()
   隐掉标题栏白条后，系统仍在右上角**浮着**三键（官方：全屏悬浮态固定 37vp）。
   而 2in1 **没有状态栏** ⇒ TYPE_SYSTEM.topRect 是 0 ⇒ 只看 statusBar 就
   认定"顶部无需避让"，内容（右上是「授权」页签）被三键压住。
   AvoidAreaType 六种里**没有**"标题栏/三键"这一类，只能单独读
   getWindowDecorHeight()（它直接返回 vp）。
   避让取**较大者**不加：两者互斥（有状态栏的形态没装饰，反之亦然）。
   实测日志：`statusBar=0 navIndicator=0 windowDecor=37`，页签条下移。

判据（13 条新增/改，全部变异验证过）
- 新增 5 条「2in1 快捷键」：单一出处（三页都不得自己比 KEYCODE_ENTER）、
  登录页回车、详情页 Enter/Esc + 先关弹层、窗口装饰必须隐掉。
  ★ 两条第一版是**我自己判红了自己**，都是判据比事实严格：
    ① 详情页确实有 KEYCODE_ENTER —— 那是**输入框内的候选导航**（onFwdKey），
       与页面级快捷键是两件事 ⇒ 改成只查页面级 onKeyEvent 那一段；
    ② isEscapeKey 先在 import 行出现，从那里切片取到的是注释 ⇒ 改成
       从页面级 onKeyEvent 内部起切。
  ★ 窗口装饰那条第一版写 `/setWindowDecorVisible\(false\)/` —— 紧邻两行**日志**
    也含这个串，删掉真正的调用后判据**照样绿**（变异实测没红）。
    改成匹配调用形态 `win.setWindowDecorVisible(false)` 后才真会红。
    这是"判据匹配到的是关于这件事的文字、不是这件事"的形状。
- harmony-widescreen ⑥ 原来钉精确串
  `pushPath({ name: MAIL_DETAIL_ROUTE, param: params })`，加了 launchMode
  参数后判红 —— 那是**判据写死了写法**。改成按结构匹配（不变式：选中邮件
  要经 navPathStack.pushPath 进 MAIL_DETAIL_ROUTE，带不带 options 是实现细节）。
- harmony-2in1 登记数 12 → 16。

环境（这次为了真验 2in1 专门搭的）
- 下载 2in1 镜像 HarmonyOS 6.1.0(23)（与 target 一致），建实例 HA2in1
  （3120×2080，14.2" 笔记本），设备 127.0.0.1:5557，形态确认为 `2in1`。
- 带窗口启动要 Qt xcb：补了 5 个 xcb 库 + Xvfb :99（`-noWindow` 下 2in1 起不了 App）。
- ★ 多设备并存时设备判据会自己挑目标 ⇒ 必须 `AGENTMAIL_HARMONY_TARGET=127.0.0.1:5555`
  才跑手机那台；不指定时判据连到未登录的 2in1 上会假红。
  这正是 harmony-device.mjs 里 targetKey() 注释写明的已知行为。

★ 未验（要说清楚，不能算过）
- Enter/Esc/Ctrl+N 三个快捷键**仍未在设备上端到端验过**：2in1 模拟器 + Xvfb 下
  键盘事件送不进 App（xdotool 的文本能进 TextInput 走输入法通道，但键事件不达；
  hdc 的 uinput/uitest keyEvent 同样不生效）。日志显示 SubscribeKeyEvent
  被调用 ⇒ 订阅注册成功，纯粹是键送达不了。属环境限制。
- 悬停同理（要有鼠标 hover 事件注入，xdotool mousemove 到窗口不一定转成
  ArkUI 的 onHover）。
- 登录页回车：同一限制。
  沉浸顶栏与三键避让是**截图硬证过**的（不依赖键盘）。

2026-09-25 12:21:00 +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): 候选菜单改用不透明弹层表面 —— 半透明+背景模糊把背后的表单糊进了列表