判据: 管理页设备判据（到期静态判据的第一条升级）+ 修设备判据基建的三个真 bug

`run-all.mjs` 的 `STATIC_ONLY` 里登记着 6 条"只能静态验"的判据，前提是
「本工作区能装、能点设备」。设备现在可用 ⇒ 它们**到期**了（欠账当场变红）。
这一批升级第一条：`harmony-admin`（用户管理页）。

## 一、新设备判据：管理页真的能打开、列表真的渲染

上面 27 条静态判据判的都是逻辑与接线形态。它们全绿时，
"管理页能不能打开、列表能不能渲染"**一句都没验过** —— 而它最容易坏：
路由注册对了但入口没接上、接口回来了但列表没渲染。

判据自己搭现场：拉起应用 → 进「我的」→ 滚到底 → 点「管理」→
断言真的在管理页（出现「新建用户」）且**渲染出用户行**。

## 二、途中撞出三个**判据自身**的 bug（都已修，都写了教训）

1. **`tapText` 从来没成功点过任何东西**（`lib/harmony-device.mjs`）
   `findByText` 返回的是**数组**，我当单个节点用了 ⇒ `node.attributes` 恒
   `undefined` ⇒ 恒返回 `false`。症状极隐蔽：调用方以为"没找到那个文案"，
   实际是帮手自己坏了。修：从数组里挑，且**优先挑可点的那个**
   （同名文案常常一个可点、一个不可点）。

2. **判据之间互相干扰**（新增 `backToMain`）
   每个设备判据都是写操作，会把前台留在它操作完的那一页。`harmony-admin`
   把人留在管理页 —— 那是 `pushUrl` 出去的独立 `@Entry` 页，**没有侧栏**
   ⇒ 后面的 `cross-client-gesture` / `harmony-appearance` 找不到侧栏、
   双双 skip（skip 原因写的是"宽屏侧栏找不到"，看起来像功能没了）。
   `launchOurApp` 解决不了（`aa start` 只切前台，不弹栈）⇒ 新增 `backToMain`。

3. **"找不到元素"要先分清是功能缺失还是判据没摆好现场**
   本判据连栽四种形态，每一种都伪装成"功能缺失"：
   · 锚点文案错（入口是「管理」，我按「用户管理」找 —— 后者只是说明的一部分）
   · 元素在滚动下方（dumpLayout 只报可见节点）
   · 文字节点不可点（`.onClick` 在包住它的容器上，ArkUI 的常态）
   · **滚动步长跨过了它**（诊断打印现场才发现：停在了「系统通知」那一带，
     而「管理」只占 ~0.04 屏，一次 0.2 屏的滑动必然越过）
   ⇒ 最后改成"**先滚到底、再小步回扫**"（只管往前找在不均匀列表上必漏），
     并加了 `AGENTMAIL_ADMIN_DEBUG=1` 的诊断入口把现场打出来。

## 三、判据

`run-all.mjs` → `files=32 ran=32 checks=505 pass=505 fail=0 skip=0
red=0 broken=0 unreported=0`（连跑两次稳定）。
`harmony-admin` 27 → 28 条。`hvigorw assembleHap` 成功；前端重建。

**设备实测**：管理页从「我的」页打开，显示「管理 / 用户管理 3 / 新建用户」
与三行用户（jianf 管理员 / gui-lab 用户 / test 用户）。

**仍到期未升级**：`harmony-appearance`（已加 2 条设备判据，但登记里其余部分仍静态）、
`harmony-logic`、`cross-client-theme`、`appearance-defaults`、`harmony-imageprep`
—— 按"每条缺什么设备侧验证"逐条来，不为了消数字而凑。

client/electron/test/lib/harmony-device.mjs

@@ -367,9 +367,92 @@ export async function launchOurApp(hdc, { settle = 400, tries = 40 } = {}) {
 export function tapText(hdc, text) {
   if (!hdc) return false;
   const root = dumpLayout(hdc);
-  const node = findByText(root, text);
-  if (node === null) return false;
-  const c = boundsCenter(node.attributes?.bounds);
+  /*
+   * ★★ 2026-09-19 修（真 bug，而且是我自己写的帮手）：
+   *   `findByText` 返回的是**数组**（同名节点可能多个），而我当单个节点用了
+   *   ⇒ `node.attributes` 恒为 `undefined` ⇒ 这个帮手**从来没成功点过任何东西**。
+   *
+   *   它造成的症状极其隐蔽：`tapText(...)` 返回 `false`，调用方以为
+   *   "没找到那个文案"——而实际是**帮手自己坏了**。用它的判据（appearance/admin）
+   *   都会表现为"找不到入口"或"点不到"，看起来像功能缺失。
+   *
+   *   修两处：① 从数组里挑；② **优先挑可点的那个** —— 同名文案常常一个可点
+   *   （入口按钮）、一个不可点（说明文字），随便挑会点到说明文字上（点了没反应）。
+   */
+  const nodes = findByText(root, text);
+  if (nodes.length === 0) return false;
+  const target = nodes.find((n) => n.attributes?.clickable === 'true') || nodes[0];
+  /*
+   * ★★ 2026-09-19 补第三层：文字节点本身常常**不可点**，点击挂在它**祖先**上。
+   *
+   * 实测（「我的」页的管理入口）：`Text('管理')` 的 `clickable=false`，
+   * 而 `.onClick` 写在包住它的那层 `Row` 上 —— 这是 ArkUI 的常态
+   * （文字只是内容，可点的是容器）。直接点文字节点的中心**也能触到**
+   * （命中测试会冒泡到祖先），但那样判据就依赖"冒泡行为"而不是"我点到了那个入口"。
+   *
+   * 所以这里显式用**祖先的可点容器**的边界：找不到可点祖先时才退回文字节点自己。
+   * 当前实现从目标节点的 bounds 出发做一次"就近扩展"：
+   * 若目标不可点，就用**同文本的可点兄弟/祖先链**（dump 树里 clickable 的那一层
+   * 一般把文字整个包住，所以用它的 bounds 最稳）。
+   */
+  const clickableAncestor = (() => {
+    if (target.attributes?.clickable === 'true') return target;
+    /* 往上找：dump 树的节点带 children，父链要从根重新走一遍才能拿到 */
+    let found = null;
+    const visit = (n) => {
+      if (found) return;
+      const kids = n.children || [];
+      for (const k of kids) visit(k);
+      if (found) return;
+      const self = n.attributes || {};
+      if (self.clickable === 'true'
+        && String(self.bounds || '') === String(target.attributes?.bounds || '')
+        && kids.length > 0) {
+        found = n;
+      }
+    };
+    visit(root);
+    return found || target;
+  })();
+  const c = boundsCenter(clickableAncestor.attributes?.bounds);
   if (c === null) return false;
   return tap(hdc, c.cx, c.cy);
 }
+
+
+/**
+ * 确保回到**主界面**（`MainPage`），而不是某个 push 出去的页
+ * （管理页 / 详情页 / 写信页 —— 它们没有侧栏与底栏）。
+ *
+ * ★★ 为什么需要它（2026-09-19 实测撞出来的**判据间干扰**）：
+ *   每个设备判据都是"写操作"，会把前台留在它操作完的那一页上。
+ *   于是**前一个判据留下的位置**决定了后一个判据能不能跑：
+ *   `harmony-admin` 把人留在管理页（那是 `pushUrl` 出去的独立 @Entry 页，
+ *   **没有侧栏**）⇒ 后面的 `cross-client-gesture` / `harmony-appearance`
+ *   找不到宽屏侧栏 ⇒ 双双 skip。而它们的 skip 原因写的是
+ *   "宽屏侧栏找不到"，看起来像功能没了。
+ *
+ *   `launchOurApp` 解决不了这个：`aa start` 只把应用切到前台，
+ *   不会把已经 push 的页面弹栈。
+ *
+ * 做法：**反复按返回键**直到侧栏/底栏出现（那是主界面的标志）。
+ * 上限兜底，避免在没有可弹页面时空按。
+ */
+export async function backToMain(hdc, { tries = 6, settle = 700 } = {}) {
+  if (!hdc) return false;
+  const atMain = () => {
+    const root = dumpLayout(hdc);
+    for (const n of walk(root)) {
+      const t = (n.attributes?.text || '').trim();
+      /* 侧栏导航轨（宽屏）或底栏（窄屏）上的项 —— 只有 MainPage 有 */
+      if (t === '通信' || t === '联系') return true;
+    }
+    return false;
+  };
+  for (let i = 0; i < tries; i++) {
+    if (atMain()) return true;
+    sh(hdc, ['shell', 'uitest', 'uiInput', 'keyEvent', 'Back'], 10000);
+    await new Promise((r) => setTimeout(r, settle));
+  }
+  return atMain();
+}