跨端: 左右滑动翻页（P6 第 3 步）+ 还 gesture-semantics 债 + 修跑不起来的判据基建

★ 这一轮从用户一句「滑动手势呢？」开始。查下去发现它不是"顺手加个手势"，
  而是 `docs/DEBTS.json` 里挂着的一笔债 —— `gesture-semantics` 的原话是：

    「P6 第 3 步：鸿蒙侧出现滑动手势代码时**立即建**判据
      （此前建 = 只有一端存在的假判据）」

  也就是**先有手势、再钉语义**。WebUI 2026-09-14 就有滑动翻页（用户当时
  亲口提的），鸿蒙一直没有 ⇒ 之前建判据会是空真（∀x∈∅）。

## 一、手势本体（两端语义逐项对齐，数值各自定）

按 `HARMONY-ALIGN-PLAN.md:118-128` 显式选的 **(b) 口径**：
「手势的物理量本来就不该强求同值……该对齐的是**语义层**」。

· 判定逻辑放**纯逻辑层** `model/Calendar.ts` 的 `judgeSwipe`（可被 node 直跑，
  写在 .ets 里就跑不了判据，语义没法被单测钉住）。四道门：位移 / 纵向优先 /
  快滑窗口 / 方向。
· 阈值**不引用** WebUI 的 40 / 1.5 / 600（那是把巧合当契约），
  各自定为 56vp / 1.4× / 700ms，并在注释里写出取值依据。
· 接线在 `CalendarPage.ets`：`PanGesture({direction: Horizontal})` +
  `onActionStart`（记时 —— `GestureEvent` **没有时间戳字段**，我查了 SDK
  的 gesture.d.ts 确认）+ `onActionEnd`（读 offsetX/offsetY）。
· ★ 挂在**网格列**上而不是整页：右栏（日程/编辑器）里有输入框与可滚内容，
  整页挂会让「在表单里横划一下」变成翻月。
· ★ 翻页复用 `shiftRange()`（与 ‹ › 按钮**同一个来源**）—— WebUI 的注释
  专门交代过：各写一套的话，阈值、边界、三档行为迟早分叉。
  手势回调里**不准**直接改 year/month（锚点是唯一真相，年月只能由
  `shiftRange → syncYearMonthFrom` 派生）。

**有意差异（记录在案，不是漏做）**：WebUI 在周/日档会额外检查「触点是否落在
可横向滚动的区域里」，是则让给滚动条（用户 2026-09-14 报过这个冲突）。
鸿蒙周档是「一行 7 格按 layoutWeight 等分」、**不横滚** ⇒ 该条件不适用。
哪天加了横滚必须同时补上它。

## 二、判据（8 条语义契约 + 行为层）

新增 `cross-client-gesture.test.mjs`：两端都真有手势 / 方向映射逐项相同 /
纵向优先 / 快滑窗口 / 复用同一翻页函数 / 无边界回弹 / 有意差异被记录 / 自检。
**只比语义、不比数值**，并反向断言鸿蒙的阈值常量不得直接取 WebUI 的那三个数。

`harmony-logic.test.mjs` 加行为判据：真跑 `judgeSwipe`，把四道门各自验一遍
（只钉字符串的话，一个 return 写漏了照样全绿）。

## 三、顺手修掉的三处**判据基建**缺陷（不修就没法验证上面这些）

1. `run-all.mjs` 只认 `# pass N`，而 node v24 打的是 `ℹ pass N`
   ⇒ **21 个文件被记成"没自报条数"**、套件在 HEAD 就恒红（memory 里记过这条，
   修法也记过，今天终于落进代码：4 个正则加 `(?:#|ℹ)`）。修完 `unreported` 27 → 0。
   代价是暴露出一批此前被"没自报"掩盖的真实问题（下面 4~6 条）。
2. `harmony-nav` 的设备判据 `navItemsOf`：宽屏过滤条件从「左边缘靠左 1/6」
   改成「**整个盒子在侧栏轨道内**」。旧条件把**日历网格的格子**
   （实测 `[229,511][366,794]`）也当成导航项，一屏数出 11~12 个。
   这是设备实测抓出来的 —— 我第一版还以为是"底部簇混进来了"，
   打印真实数据才发现是隔壁页面的格子。
3. `harmony-logic` 两处：从 `NAV_ITEMS` / `NAV_SIDEBAR_ITEMS` **各自的数组**里取
   label。原先把全文件 `label:` 一网打尽 ⇒ 得到 7 个（4+3 混在一起），
   任何一边改对了它都会红。

## 四、被判据拦住后的正经修法（每条都按判据自己给的方向改，不改判据迁就代码）

· `cross-client-theme` A2 拦住我：新增的 `navActiveBg`/`navBrandFg`/`badgePlain`
  未登记；又拦住我：`sseColorOf` 里四个裸色值。→ 抽成 `Theme.sseConnected` 等
  四个令牌（取值对齐 WebUI 的 Tailwind 类）+ 登记 + 在 Theme.ets 的表里写理由。
· 同一条判据的"死令牌"检出：`Theme.durBase` 声明了却从没人读。
  **查 WebUI 才发现壁纸淡入是真有的动效**（`index.css:742-752` 的
  `.app-backdrop` 从 opacity:0 → 1，180ms）⇒ 补上而不是删令牌
  （删掉等于把差异抹平、还说成"清理"）。reset 在 `animateTo` **外**，
  与 `calPaneIn` 同一条纪律。
· 玻璃登记：`NavItemBuilder` → `SidebarItem`（重构后按最近的 @Builder 命名），
  登记同步跟上。
· `harmony-admin` 的退出判据：退出逻辑抽成 `api/Logout.ets` 的 `performLogout()`
  （两个入口——「我的」页与侧栏底簇——必须做同一件事，尤其"先注销推送 token"
  那一步）。判据相应改成**追到实际执行处**（两半都断：按钮调了 + 函数真清了全部），
  并写明"别再退回直接匹配 SETTINGS_PAGE 的写法"（那会随重构假红，
  下一个人只会去改判据而不看行为）。
· `harmony-widescreen` 的连接点色值：色值搬进 Theme 后，判据改成断
  「令牌定义对了 + 侧栏真的用了它」两半（只断任一半都有假绿形态）。
· `align-refs`：`CalendarView.tsx` 变了，按判据要求**读一遍差异**再更新登记
  （差异只有农历小字的灰阶档位 gray-300→gray-400/500，**骨架未变**）。
· `criteria-hygiene`：`harmony-contacts` 自造了一个 `code()`、`harmony-widescreen`
  裸用 `readFileSync` ⇒ 都改用 `lib/read.mjs` 的共享入口。
  途中撞出一个**判据自己的 bug**：`code()` 的块注释正则
  `/\*[\s\S]*?\*\//` 会把注释里出现的 `/*`（如 `/」**` 这种中文夹星号）
  当成块注释起点，一路吃到几十行后的 `*/`，把中间的 import 全吞掉 ——
  于是 hygiene 判据假红"没 import"。改掉那处写法后正常。

## 五、验证

判据面：`run-all.mjs` → `files=32 ran=32 checks=497 pass=497 fail=0
skip=0 red=0 broken=0 unreported=0`。
其中新/改判据：gesture 8、nav 18、widescreen 7、logic 30、admin 27、
cross-client-theme 15、criteria-hygiene 6。
构建：`hvigorw assembleHap` 成功；前端 `npm run build` + 重新打 AppImage/deb
（`build-stamp` 7/7、`packaging` 5/5）。

**设备实测（HATriple 三折叠 3184×2232，hdc 连 127.0.0.1:5555）**：
· 农历在格子里真的显示（1=二十 / 7=廿六 / 19=**初九** / 11=八月），与 WebUI 一致；
  这条同时验证了**服务端农历路由已部署**（之前线上是 404）。
· 日历左右两栏：编辑器出现在**右栏**、左栏月份仍可见（单栏模式下编辑器会整页盖掉它）。
· 侧栏 3 项 + 底部一簇；徽标回到图标右上角。

**仍未验（如实标注）**：滑动翻页的**手感**（阈值 56vp/1.4×/700ms 是否合适）
只能真人滑过才知道；我只验了判定逻辑与接线形态。动画同理 ——
机制已验证（`animateTo` 驱动 + reset 在窗口外），但"看起来顺不顺"未做取样验证。

docs：`DEBTS.json` 销掉 `gesture-semantics`（并记结算说明）、
`HARMONY-ALIGN-PLAN.md` P6 从「✅（滑动翻页除外）」改为 ✅。

client/electron/test/cross-client-theme.test.mjs

@@ -220,7 +220,34 @@ const SELF_OWNED_COLORS = [
   // 业务语义色：系统没有对应物（同意 / 拒绝 / 警示）
   'approve', 'danger', 'approveBg', 'approveFg', 'dangerBg', 'warnBg', 'warnFg',
   // 权限档位与预算档位的胶囊配色（档位是产品语义，系统不认识"plan/workspace/full"）
-  'chipNeutralBg', 'chipNeutralFg', 'chipSpentBg', 'chipSpentFg', 'chipWarnBg', 'chipWarnFg'
+  'chipNeutralBg', 'chipNeutralFg', 'chipSpentBg', 'chipSpentFg', 'chipWarnBg', 'chipWarnFg',
+  /*
+   * ★★ 2026-09-19 补登记（对应用户「底栏数字为什么显示在图标下面？」与
+   *   用户「你写的app和webui大面积不符」那两轮改动）。
+   *
+   * 三个值都是**跨端身份色**，系统语义色里没有对应物：
+   *   · `navActiveBg` #DBEAFE —— WebUI `index.css:1595-1606` 的 `--nav-active-bg`，
+   *     侧栏选中项的**浅蓝底块**（宽屏侧栏的选中线索就是它，不是文字变色）。
+   *   · `navBrandFg` #475569 —— WebUI 的 `--nav-fg-muted`，侧栏未选中项的图标色。
+   *   · `badgePlain` #475569 —— WebUI `bg-chrome-600`（`index.css:92`），
+   *     "plain" 档徽标底色（联系人数）。**它必须是石板灰而不是红**：
+   *     三档被压成两档时，`'plain'` 会走 `danger`，看起来像"有未读"。
+   *     `chrome-600` 刻意不透明（`index.css:1097` 有注释：15px 小控件叠透明度
+   *     会让数字掉到 4.46:1，低于 WCAG AA）。
+   *
+   * 三者的取值理由都已写在 `Theme.ets` 各自的注释里（本判据的要求）。
+   */
+  'navActiveBg', 'navBrandFg', 'badgePlain',
+  /*
+   * SSE 连接指示器的四个状态色（`WideSidebar.ets` 的 `sseColorOf`）。
+   * 逐档对齐 WebUI 的 Tailwind 类（`ConnectionIndicator.tsx:22-25`）：
+   *   connected `bg-green-500` / connecting `bg-yellow-400` /
+   *   reconnecting `bg-orange-400` / disconnected `bg-red-400`。
+   *
+   * 为什么不复用 `warnFg`/`danger`：那两个是**文字色**，而状态点是 8px 实心圆，
+   * 用文字色会发脏、深色底上不够跳。WebUI 也是分开的两套（`text-*` vs `bg-*`）。
+   */
+  'sseConnecting', 'sseConnected', 'sseReconnecting', 'sseDisconnected'
 ];
 
 test('A2｜Theme.ets 里"自己写的色"必须**登记过**：新写死一个色不该默默通过', () => {
@@ -307,7 +334,7 @@ const GLASS_REGISTRY = [
   // 文件（相对 ets 根） + 组件/Builder 名：为什么这里可以有一层系统材质
   { file: 'pages/MainPage.ets', provider: 'NavBar', why: 'P5 悬浮玻璃条：浮在**会滚动的内容**之上（pi 给的放行条件②），壁纸层整个不吃材质' },
   // ★ 2026-09-16：宽屏 app-shell 复刻 WebUI —— 面板走系统材质（半透明由 BlurStyle 给，不手写 alpha）
-  { file: 'pages/WideSidebar.ets', provider: 'NavItemBuilder', why: '宽屏侧栏（判据按最近的 @Builder 命名）：浮在壁纸之上、背后是会滚动的导航内容（WebUI Sidebar 同形状），bgActive 才开' }
+  { file: 'pages/WideSidebar.ets', provider: 'SidebarItem', why: '宽屏侧栏（判据按最近的 @Builder 命名）：浮在壁纸之上、背后是会滚动的导航内容（WebUI Sidebar 同形状），bgActive 才开。★ 2026-09-19 改名：原先登记的是 NavItemBuilder，但那是我上一版编造的“复刻”（参见 Theme.ets 里那段更正）—— 重写后按 WebUI 拆成导航轨 + 底部一簇，@Builder 相应改名，登记同步跟上（判据就是为此存在的）' }
 ];
 
 /**