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

用户：「要给鸿蒙端做功能同步」。按 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/harmony/entry/src/main/ets/api/CalendarApi.ets

@@ -0,0 +1,32 @@
+/*
+ * AgentMail 鸿蒙客户端 — 日历 API
+ * GET /calendar/events?from=&to=
+ *
+ * 与 WebUI 同源同参（`client/electron/src/api/client.ts` 的 listCalendarEvents）：
+ * from/to 是 **RFC3339 区间**，服务端按 `event_time` 落在区间内筛。
+ *
+ * 区间必须按**网格**算，不是按月首月末算 —— 月视图首尾会显示上/下月的格子，
+ * 只查当月会让那几个格子永远空着（看着像"那天没事件"，其实是没查）。
+ */
+import { ApiClient } from './ApiClient';
+import { CalendarListResponse } from '../model/Models';
+
+export class CalendarApi {
+  private client: ApiClient;
+
+  constructor(client: ApiClient) {
+    this.client = client;
+  }
+
+  /**
+   * 列区间内的事件。
+   *
+   * `from`/`to` 走 `encodeURIComponent`：RFC3339 里的 `+08:00` 若不编码，
+   * 查询串里的 `+` 会被服务端解成空格，`time.Parse` 直接失败 ⇒ 静默返回空列表
+   * （界面表现为"这个月没有日程"，而实际是参数被吃掉了）。
+   */
+  async listEvents(from: string, to: string): Promise<CalendarListResponse> {
+    const query: string = 'from=' + encodeURIComponent(from) + '&to=' + encodeURIComponent(to);
+    return this.client.get<CalendarListResponse>('/calendar/events', query);
+  }
+}