跨端: 手势补设备判据（真滑、标题真变）+ 修三处"设备判据假红"的典型错法

上一提交把滑动翻页做完了，但只验到"代码形态对"。**真装上跑时一次都没触发** ——
这一条补上设备实测，并把途中撞出来的三类错法记进判据注释。

## 一、为什么必须有设备判据

第一次装上跑：**代码全对、手势一次都没触发**。原因是起点 x=2600 落在
**右栏**（日程面板 `Column [2207,112][3184,2204]`）—— 事件根本没进网格列。
只有静态判据的话，结论会是"手势已实现、判据全绿"，而用户真去滑时一动不动。

所以判据断的是**界面真的翻了**（滑动前后各 dump 一次，断言月标题变一格），
不是断"日志里有 turned=true" —— 后者只证明判定通过、证明不了有人会动。

## 二、途中撞出来的三类错法（都写进注释了）

1. **`uitest` 的 velocity 越界会被静默替换**
   我传 150（想表达"慢一点"），它只回一句
   `The swipe velocity out of range, the default value will be used.`
   —— 不报错、不改退出码，只是默默换成默认 600。于是"慢滑"变成"更慢的滑"，
   看起来像手势没生效。**传合法值（200~40000）+ 读回执**才能避免。
   新增 `lib/harmony-device.mjs` 的 `swipe()` 帮手（与 `tap()` 同族，
   内部 clamp，并在注释里写了这个坑）。

2. **滑动是有副作用且不可撤销的写操作 ⇒ 不能盲目重试**
   第一版写"不生效就再发一次（最多 3 次）"，结果实测**把日历一次翻了 3 格**
   （标题跑到 2026年11月）。重试不是"再试一次"，是"再翻一页"。
   只有幂等操作才允许盲目重试。改成：**只发一次 + 等足够久**（最多 8 秒轮询）。

3. **坐标不能用"到边界差一点"的比例**
   取 `width * 0.68` = 2165，距网格列右边界 2207 只有 42px ⇒ **一次都不触发**；
   同一台设备、同一份代码，起点改 2000 立刻生效。
   起点贴边时触摸点会被判到相邻的右栏。改成取**列中段**
   （`0.62` / `0.13`，两端各留几百 px 余量）。

另：本判据第一版用"滑一次 + 固定等 2500ms + dump"，**单独跑通过、接进
run-all 后失败**（设备繁忙时不够）。固定等待是设备判据最常见的假红来源 ——
改成轮询到标题变化。诊断留了 `AGENTMAIL_GESTURE_DEBUG=1` 门控，
失败时能一次看到"前台/坐标/轨迹"，不用事后手动复现。

## 三、设备实测结果（HATriple 3184×2232）

· 月档：左滑 9月 → **10月**（`dx=-556.5 dy=0 ms=624 turned=true`）；
  右滑回 **9月**（`dx=+556.5`）。
· 周档：`2026年9月14–20日` → 左滑 → **`9月21–27日`**（正好 +7 天，
  证明步长走的是 `stepDaysOf` 而不是写死 1）。
· 斜滑（dx=400 dy=800）：`PanGesture({direction: Horizontal})` 在系统层
  就没识别 ⇒ 比鸿蒙侧的 `SWIPE_AXIS_RATIO` 更早拦住（正确行为）。

**仍未验**：56vp / 1.4× / 700ms 这三个数**手感是否合适**，只能真人滑过才知道。
我验的是"判定逻辑 + 接线 + 真能翻页"。

## 四、验证

`run-all.mjs` → `files=32 ran=32 checks=498 pass=498 fail=0 skip=0
red=0 broken=0 unreported=0`。
（含新设备判据：cross-client-gesture 9 条，其中第 9 条是真滑。
 `build-stamp` 7/7、`packaging` 5/5 —— 按判据要求重建 + 重打包，没有改记录迁就。）

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

@@ -313,3 +313,22 @@ export function tap(hdc, x, y) {
   const r = sh(hdc, ['shell', 'uitest', 'uiInput', 'click', String(x), String(y)], 15000);
   return (r.stdout || '').includes('No Error');
 }
+
+/**
+ * 从 (x1,y1) 滑到 (x2,y2)，`velocity` 单位 px/s（`uitest` 合法范围 200~40000）。
+ * 返回 true 表示 "No Error"。
+ *
+ * ★ `velocity` **必须落在合法范围内**：我第一版传了 150（想表达"慢一点"），
+ *   `uitest` 只回一句 `The swipe velocity out of range, the default value will be used.`
+ *   —— 它**不报错、不改退出码**，只是默默换成默认 600，于是"慢滑"变成"更慢的滑"，
+ *   看起来像手势没生效。这类"参数被静默替换"的坑，只能靠**传合法值 + 读回执**避免。
+ *
+ * 同样**这是写操作**（改变前台应用状态）：调用方先确认前台是自己的应用再滑。
+ */
+export function swipe(hdc, x1, y1, x2, y2, velocity = 5000) {
+  if (!hdc) return false;
+  const v = Math.min(40000, Math.max(200, Math.round(velocity)));
+  const r = sh(hdc, ['shell', 'uitest', 'uiInput', 'swipe',
+    String(x1), String(y1), String(x2), String(y2), String(v)], 20000);
+  return (r.stdout || '').includes('No Error');
+}