跨端: 鸿蒙端功能同步第一步——日历（只读月视图）上架，入口进底部导航

用户：「要给鸿蒙端做功能同步」。按 API 面盘点（WebUI 62 个 API 函数 vs 鸿蒙 38 个），
最大的用户面缺口是**日历**：纯逻辑（model/Calendar.ts）与判据早就在，一直没页面。

新增：
- api/CalendarApi.ets：GET /calendar/events?from=&to=（与 WebUI 同参；区间按**网格**取，
  不是月首月末 —— 首尾格子会显示邻月，只查当月会让那些格子永远空着）
- pages/CalendarPage.ets：月网格（翻月/回今天）、点某天看当天日程、事件点、今天/选中两态、
  加载失败说出来。**没做**：写侧（增删改）、农历重复、.ics、滑动翻页 —— 逐条写在文件头
- model/Calendar.ts：补 localIsoOf / hhmmAtOffset / deviceOffsetMinutes（偏移是入参 ⇒ 三时区可真跑）
- model/Models.ets：CalendarEvent / CalendarListResponse（字段对齐服务端 JSON）
- NavItems：加「日历」，底部成为 通信/日历/联系人 三项（与 WebUI 同序）
- MainPage：日历是**常驻 pane**（visibility 控制），首次可见才拉数据；today 走
  @Prop @Watch(visible) 在 pane 变可见时重算 ⇒ 结算欠账 calendar-today-recompute
  （DEBTS 15 笔 → 14 笔，余额里不再计这一笔）

判据：harmony-calendar 新增 6 条（网格/表头同源、事件归日走 localIsoOf、三时区钟点、
today 重算路径、翻月走 addMonths、变异自检）；harmony-nav ② 分派与 ④ 让位跟着改成结构性判据
（④ 原来那个 400 字符窗口一加 pane 就红 —— 窗口式判据的又一次现身）；harmony-logic 两处
「只剩两个平级页签」跟着改成三项。

真机实测（harmony-emu + hvigorw assembleHap + hdc install + uitest click + dumpLayout）：
9 月网格星期对齐（周一起始，2026-09-01 落在「二」列）、事件点恰好在有日程的那 6 天
（11/17/18/24/25/30）、点 09-17 列出当天两条日程且钟点是本地时间（DB 里 02:20Z/08:30Z
→ 界面 10:20/16:30）。

client/electron/test/harmony-calendar.test.mjs

@@ -192,7 +192,9 @@ test('★ 鸿蒙树里不许用 toISOString 取日期键（今天标错格的直
  * 只是残留发生在**调用侧**。
  *
  * 纯逻辑侧能钉的是：同一次输入给同一结果、不同输入各自独立、**不许跨调用残留**。
- * 调用侧义务（pane 变可见时重算）登记在 docs/DEBTS.json 的 `calendar-today-recompute`。
+ * 调用侧义务（pane 变可见时重算）原登记在 docs/DEBTS.json 的 `calendar-today-recompute`，
+ * **2026-09-14 已结算**：日历页落地时用 `@Prop @Watch('onVisibleChanged') visible` 实现，
+ * 判据见本文件末尾的「★ today 在 pane **变可见时**重算」。
  */
 test('★ today 不许跨调用残留：连续两次不同输入各自独立，且推进一天后值必须变', () => {
   const mark = g => g.flat().filter(c => c.isToday).map(c => c.iso);
@@ -210,3 +212,84 @@ test('★ today 不许跨调用残留：连续两次不同输入各自独立，
   assert.equal(mark(C.monthGrid(2026, 9, 1)).length, 0,
     '不传就不许有今天（不许内部兜底取系统时间 —— 那正是"取一次"的写法）');
 });
+
+/*
+ * ═══════════════════════════════════════════════════════════════════
+ *  P6 第 1 步的**页面那一半**（2026-09-14：日历入口上架）
+ *
+ *  上面那些钉的是"算术对不对"；从这里开始钉"页面有没有如实消费它"。
+ *  两者分工明确：算术错 → 日子错位；消费错 → 数据对但画错、或永远画不出来。
+ */
+
+test('页面：网格与表头都走 Calendar.ts 的同一套入参（WEEK_START=1，与 WebUI 同值）', () => {
+  const page = code(join(ETS, 'pages', 'CalendarPage.ets'));
+  // 网格：行来自 monthGrid，且 weekStart 传的是常量（不是字面量 0/1 —— 那会与表头分叉）
+  assert.match(page, /monthGrid\(this\.year, this\.month, WEEK_START, this\.todayIso\)/,
+    '网格必须由 monthGrid 生成，并把 WEEK_START 与 todayIso 一起传进去');
+  assert.match(page, /weekdayLabels\(WEEK_START\)/,
+    '表头顺序必须来自 weekdayLabels(WEEK_START) —— 硬编码成 日/一/二… 就是第二个分叉点（表头整体错一列）');
+  const decl = /const WEEK_START: number = (\d)/.exec(page);
+  assert.ok(decl, 'WEEK_START 要是常量，判据要能读到它');
+  assert.equal(decl[1], '1', '周起始必须是周一（1）—— 与 WebUI lib/calendar.ts 的 startOfWeek 同值，两端不同值会让同一天落在不同列');
+});
+
+test('页面：事件按 localIsoOf 归日，且不自己切时间戳', () => {
+  const page = code(join(ETS, 'pages', 'CalendarPage.ets'));
+  assert.match(page, /localIsoOf\(/, '事件归日必须走 localIsoOf');
+  assert.ok(!/\.slice\(0, 10\)/.test(page),
+    '页面里不许切时间戳前 10 位取日期（那是 UTC 日期 ⇒ UTC+8 的凌晨会把事件画到前一天）');
+  // 会话/列表侧的日期格式化也不许自己切（同一族：只有 localIsoOf/hhmmAtOffset 两个出口）
+  assert.match(page, /hhmmAtOffset\(/, '钟点显示走 hhmmAtOffset（偏移是入参，可判据）');
+});
+
+test('★ localIsoOf / hhmmAtOffset：偏移是入参，所以三个时区都能真跑', () => {
+  // UTC+8 的 09-15 00:30 在 UTC 里是 09-14T16:30Z —— 切字符串会给 09-14（错一天）
+  assert.equal(C.localIsoOf('2026-09-14T16:30:00Z'), C.isoAtOffset(new Date('2026-09-14T16:30:00Z'), C.deviceOffsetMinutes(new Date('2026-09-14T16:30:00Z'))),
+    'localIsoOf 必须与 isoAtOffset(设备偏移) 同口径');
+  assert.equal(C.hhmmAtOffset('2026-09-14T16:30:00Z', 480), '00:30', 'UTC+8 的钟点');
+  assert.equal(C.hhmmAtOffset('2026-09-14T16:30:00Z', -480), '08:30', 'UTC-8 的钟点');
+  assert.equal(C.hhmmAtOffset('2026-09-14T16:30:00Z', 0), '16:30', 'UTC 的钟点');
+  // 坏值不许把整个月画崩
+  assert.equal(C.localIsoOf('not-a-time'), '');
+  assert.equal(C.hhmmAtOffset('not-a-time', 480), '');
+});
+
+test('★ today 在 pane **变可见时**重算（DEBTS 的 calendar-today-recompute）', () => {
+  /*
+   * 这条欠账的到期前提就是"日历页面骨架写完后立刻"，现在到期了 —— 于是要么实现、要么改前提。
+   * 实现方式：`@Prop @Watch('onVisibleChanged') visible` + aboutToAppear 各自重算一次。
+   *
+   * 为什么两条都要：
+   *   · 重新挂载（切页签）→ aboutToAppear 重算 ✓；
+   *   · 常驻 pane 一直开着跨过午夜 → **只有 @Watch(visible)** 能救（卸载重挂不会发生）。
+   * 判据盯的是"重算路径存在且绑定在可见性上"，不是"今天恰好是几号"（那个由纯逻辑判据管）。
+   */
+  const raw = code(join(ETS, 'pages', 'CalendarPage.ets'));
+  assert.match(raw, /@Prop @Watch\('onVisibleChanged'\) visible: boolean/,
+    'visible 必须挂 @Watch —— 否则常驻 pane 跨午夜后 today 停在昨天');
+  assert.match(raw, /onVisibleChanged\([^)]*\): void \{[\s\S]{0,200}?refreshToday\(\)/,
+    'onVisibleChanged 里必须重算 today');
+  assert.match(raw, /refreshToday\(\)[\s\S]{0,60}isoOfLocal\(new Date\(\)\)/,
+    'today 只能由 isoOfLocal(new Date()) 求（toISOString 是 UTC 口径，清晨会给出昨天）');
+  // 首次可见才拉数据：常驻挂载 ≠ 常拉（隐藏着也发请求是给用户白花的流量/电）
+  assert.match(raw, /if \(!this\.loadedOnce\)/,
+    '首次可见才拉数据 —— 常驻挂载不等于启动就拉');
+});
+
+test('页面：翻月走 addMonths（跨年两个方向已被纯逻辑钉过），不自己算 month+1', () => {
+  const page = code(join(ETS, 'pages', 'CalendarPage.ets'));
+  assert.match(page, /addMonths\(this\.year, this\.month, delta\)/, '翻月必须复用 addMonths');
+  assert.ok(!/this\.month \+ 1|this\.month - 1/.test(page),
+    '页面里不许自己算 month±1 —— "翻到 13 月"就是那样来的（纯逻辑判据已覆盖 addMonths，别在页面重写一遍）');
+});
+
+test('★ 判据自检：把错误写法喂进来必须判红', () => {
+  // ① 自己切时间戳取日期键（UTC 口径 ⇒ 错一天）
+  assert.ok(/\.slice\(0, 10\)/.test("localIsoOf(e.event_time.slice(0, 10))"), '切时间戳能被"不许切"这条命中');
+  // ② 表头硬编码（与网格分叉）
+  assert.ok(!/weekdayLabels/.test("['日','一','二','三','四','五','六']"), '硬编码表头能被"必须来自 weekdayLabels"命中');
+  // ③ month±1 自算
+  assert.ok(/this\.month \+ 1/.test('const m = this.month + 1;'), '自算 month+1 能被命中');
+  // ④ 没有 @Watch（today 跨午夜停在昨天）
+  assert.ok(!/@Prop @Watch\('onVisibleChanged'\)/.test('@Prop visible: boolean = true;'), '缺 @Watch 能被命中');
+});