新增系统日历镜像功能，镜像与备份目标统一改用 bookId；修复重复日程覆盖行、备份目标随勾选漂移等一批问题

- 新增 SystemCalendarMirror / MirrorSnapshot / MirrorInbound：把选定的 CalDAV 日历本镜像写入系统日历（供小艺、桌面日历卡片、手表可见），并做入站对账，区分"自己写入的 / 用户改的 / 用户删的 / 用户新建的"，镜像标识一律用稳定的 bookId（accId-href哈希），不再用会随勾选顺序漂移的 calKey
- 后台同步接入镜像：同步前先做入站对账、同步后自动出站镜像，无需用户手动触发
- 系统日历备份目标改用 bookId：当用户取消同步某个日历本导致目标失效时，自动清空目标并把模式回退为"仅显示"；开启备份必须先选定目标本，不再自动挑第一个本
- EventDb：覆盖行保留 RECURRENCE-ID，排除主事件对应发生改用 overrideKey(calKey, uid, recurrenceId, startTime)，修复重复日程出现"幽灵条目"的问题
- 新增 WRITE_CALENDAR 权限声明及其用途说明；添加日历不再出现"本机"，日历本对齐显示；版本升至 0.0.3(300)

entry/src/main/ets/common/AppSettings.ets

@@ -11,13 +11,22 @@ export class AppSettings {
   private static readonly KEY_SYNC_INTERVAL: string = 'sync_interval_minutes';
   private static readonly KEY_BACKGROUND_SYNC: string = 'background_sync';
   private static readonly KEY_SYS_MODE: string = 'sys_cal_mode';       // 'display' | 'backup'
-  private static readonly KEY_BACKUP_KEY: string = 'sys_backup_cal_key'; // 备份目标 DAV 日历本
+  // ⚠️ 备份目标**必须**用稳定标识 bookId 存（由服务器 href 派生，见 SystemCalendarMirror.listBooks）。
+  //    老键存的是 calKey（`accId_序号`），序号会随"取消勾选某个日历本/服务器新增日历本"整体漂移
+  //    → 目标本会**悄悄变成另一个本**，把系统日历导进用户没选过的本（用户实测发现）。
+  //    KEY_BACKUP_KEY 仅保留用于老值一次性迁移，读到后立即换存 KEY_BACKUP_BOOK_ID 并清空。
+  private static readonly KEY_BACKUP_KEY: string = 'sys_backup_cal_key';   // 【已废弃】备份目标 calKey（仅迁移用）
+  private static readonly KEY_BACKUP_BOOK_ID: string = 'sys_backup_book_id'; // ⭐ 备份目标稳定标识 bookId
   private static readonly KEY_MANUAL_READONLY: string = 'manual_readonly_keys'; // 手动标记只读的 calKey
   private static readonly KEY_MUTED_REMINDER: string = 'muted_reminder_keys';  // 提醒静音的 calKey
   private static readonly KEY_REMINDER_TICK: string = 'reminder_tick';         // 应用内提醒上次检查时间戳
   private static readonly KEY_FULL_REFETCH: string = 'full_refetch_done'; // 一次性全量重拉已完成
   private static readonly KEY_DEFAULT_VIEW: string = 'default_view';      // 打开 App 默认视图
   private static readonly KEY_DISPLAY_STYLE: string = 'display_style';    // 日程显示方式：'timeline' | 'list'
+  private static readonly KEY_MIRROR_ENABLED: string = 'mirror_enabled';   // 是否把选中 CalDAV 日历本镜像到系统日历（默认关）
+  private static readonly KEY_MIRROR_KEYS: string = 'mirror_cal_keys';     // 要镜像的 DAV 日历本 calKey 列表
+  private static readonly KEY_MIRROR_BOOK_IDS: string = 'mirror_book_ids'; // ⭐ 要镜像的日历本**稳定标识** bookId（由服务器 href 派生，不随序号变）
+  private static readonly KEY_MIRROR_INBOUND: string = 'mirror_inbound';   // 是否把系统日历的改动回写 CalDAV（默认关）
   private static readonly KEY_POLICY_AGREED: string = 'policy_agreed';    // 是否已同意隐私政策与用户协议
   // 首启功能引导"用户已看过并关闭"的标记。键名带版本号：改动引导内容后把 vN 加 1，用户即可再看一次。
   // 注意：只在用户主动关闭（"开始使用" / ✕ / 点遮罩）时才置 true，**不再"显示前就置 true"**——
@@ -149,6 +158,141 @@ export class AppSettings {
     }
   }
 
+  /**
+   * 是否把选中的 CalDAV 日历本镜像到系统日历（默认关）。
+   * ⚠️ 该开关必须与 WRITE_CALENDAR 授权状态一致：未授权即为关（权限按需申请约束）。
+   */
+  static async getMirrorEnabled(context: common.Context): Promise<boolean> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      return await store.get(AppSettings.KEY_MIRROR_ENABLED, false) as boolean;
+    } catch (err) {
+      return false;
+    }
+  }
+
+  static async setMirrorEnabled(context: common.Context, value: boolean): Promise<void> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      await store.put(AppSettings.KEY_MIRROR_ENABLED, value);
+      await store.flush();
+    } catch (err) {
+      const e = err as BusinessError;
+      console.error(`保存镜像开关失败: ${e.message}`);
+    }
+  }
+
+  /**
+   * ⚠️ **已废弃**：早期用 calKey 存"要镜像哪些本"，但 calKey 是 `<账号ID>_<序号>`，
+   *     日历本重排后序号会变 → 选中的本串成另一个本、镜像账户名也变 → 系统日历出现重复账户与串本。
+   *     新代码一律用 `getMirrorBookIds()`。这里只为读取历史值做迁移。
+   */
+  static async getMirrorKeys(context: common.Context): Promise<string[]> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      const raw: string = await store.get(AppSettings.KEY_MIRROR_KEYS, '') as string;
+      if (raw === '') {
+        return [];
+      }
+      const arr: string[] = JSON.parse(raw) as string[];
+      if (!Array.isArray(arr)) {
+        return [];
+      }
+      const out: string[] = [];
+      for (let i: number = 0; i < arr.length; i++) {
+        const v: string = arr[i];
+        if (typeof v === 'string' && v !== '') {
+          out.push(v);
+        }
+      }
+      return out;
+    } catch (err) {
+      return [];
+    }
+  }
+
+  static async setMirrorKeys(context: common.Context, keys: string[]): Promise<void> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      await store.put(AppSettings.KEY_MIRROR_KEYS, JSON.stringify(keys));
+      await store.flush();
+    } catch (err) {
+      const e = err as BusinessError;
+      console.error(`保存镜像日历本失败: ${e.message}`);
+    }
+  }
+
+  /**
+   * ⭐ 要镜像到系统日历的日历本**稳定标识** bookId 列表，空 = 未选择。
+   * bookId = `<账号ID>-<href哈希>`，由服务器分配的 href 派生 —— 日历本增删改序都不会变。
+   */
+  static async getMirrorBookIds(context: common.Context): Promise<string[]> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      const raw: string = await store.get(AppSettings.KEY_MIRROR_BOOK_IDS, '') as string;
+      if (raw === '') {
+        return [];
+      }
+      const arr: string[] = JSON.parse(raw) as string[];
+      if (!Array.isArray(arr)) {
+        return [];
+      }
+      const out: string[] = [];
+      for (let i: number = 0; i < arr.length; i++) {
+        const v: string = arr[i];
+        if (typeof v === 'string' && v !== '') {
+          out.push(v);
+        }
+      }
+      return out;
+    } catch (err) {
+      return [];
+    }
+  }
+
+  static async setMirrorBookIds(context: common.Context, ids: string[]): Promise<void> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      await store.put(AppSettings.KEY_MIRROR_BOOK_IDS, JSON.stringify(ids));
+      await store.flush();
+    } catch (err) {
+      const e = err as BusinessError;
+      console.error(`保存镜像日历本(bookId)失败: ${e.message}`);
+    }
+  }
+
+  /**
+   * 是否把"用户在系统日历里的改动"回写到 CalDAV（**默认关**）。
+   * ⚠️ 默认关是有意的：这个功能会写用户的服务器数据，首次上线必须先单向观察一轮再开。
+   */
+  static async getMirrorInbound(context: common.Context): Promise<boolean> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      return await store.get(AppSettings.KEY_MIRROR_INBOUND, false) as boolean;
+    } catch (err) {
+      return false;
+    }
+  }
+
+  static async setMirrorInbound(context: common.Context, value: boolean): Promise<void> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      await store.put(AppSettings.KEY_MIRROR_INBOUND, value);
+      await store.flush();
+    } catch (err) {
+      const e = err as BusinessError;
+      console.error(`保存回写开关失败: ${e.message}`);
+    }
+  }
+
   /**
    * 是否还需要一次性全量重拉：修复历史同步（REPORT 剥离 VALARM 时期）落库的残缺数据。
    * 全量重拉期间忽略 etag 复用，所有资源 GET 完整 ICS；成功完成后标记，恢复增量模式。
@@ -286,9 +430,14 @@ export class AppSettings {
       if (muted2.length !== muted.length) {
         await AppSettings.setMutedReminderKeys(context, muted2);
       }
-      const backupKey: string = await AppSettings.getBackupCalKey(context);
-      if (backupKey.startsWith(`${accId}_`)) {
-        await AppSettings.setBackupCalKey(context, '');
+      // 备份目标指向该账号名下某个本 → 目标必失效：清空目标**并关闭备份功能**
+      // （只清空目标会让"备份到 CalDAV"开关停在开着却什么都不做的状态，状态与实际不符）
+      const bookId: string = await AppSettings.getBackupBookId(context);
+      const legacyKey: string = await AppSettings.getBackupCalKey(context);
+      if (bookId.startsWith(`${accId}-`) || legacyKey.startsWith(`${accId}_`)) {
+        await AppSettings.clearBackupTarget(context);
+        await AppSettings.setSysCalMode(context, 'display');
+        console.log(`删除账号 ${accId}：其名下的系统日历备份目标已失效，备份功能自动关闭`);
       }
     } catch (err) {
       const e = err as BusinessError;
@@ -319,7 +468,12 @@ export class AppSettings {
     }
   }
 
-  /** 备份目标日历本 calKey（accId_序号），空 = 未选择 */
+  /**
+   * 【已废弃，仅供老值迁移】备份目标 calKey（`accId_序号`）。
+   * ⚠️ 不要再用它做判断！序号会漂移（见 KEY_BACKUP_KEY 处注释）。
+   *    新代码一律用 `SystemCalendarMirror.backupTargetRef()` / `checkBackupTarget()`，
+   *    它内部会把这个老值翻译成 bookId 并清空本键。
+   */
   static async getBackupCalKey(context: common.Context): Promise<string> {
     try {
       const store: preferences.Preferences =
@@ -330,18 +484,49 @@ export class AppSettings {
     }
   }
 
+  /** 【已废弃】写老键。新代码请用 setBackupBookId()。 */
   static async setBackupCalKey(context: common.Context, calKey: string): Promise<void> {
     try {
       const store: preferences.Preferences =
         await preferences.getPreferences(context, AppSettings.STORE);
       await store.put(AppSettings.KEY_BACKUP_KEY, calKey);
       await store.flush();
+    } catch (err) {
+      const e = err as BusinessError;
+      console.error(`保存备份目标(老键)失败: ${e.message}`);
+    }
+  }
+
+  /** ⭐ 备份目标日历本的稳定标识 bookId（`<accId>-<href哈希>`），空 = 未选择 */
+  static async getBackupBookId(context: common.Context): Promise<string> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      return await store.get(AppSettings.KEY_BACKUP_BOOK_ID, '') as string;
+    } catch (err) {
+      return '';
+    }
+  }
+
+  /** ⭐ 保存备份目标（bookId）。传空字符串 = 取消选择。 */
+  static async setBackupBookId(context: common.Context, bookId: string): Promise<void> {
+    try {
+      const store: preferences.Preferences =
+        await preferences.getPreferences(context, AppSettings.STORE);
+      await store.put(AppSettings.KEY_BACKUP_BOOK_ID, bookId);
+      await store.flush();
     } catch (err) {
       const e = err as BusinessError;
       console.error(`保存备份目标失败: ${e.message}`);
     }
   }
 
+  /** 一次清空备份目标（新键 + 老键一起清，避免迁移残留又复活） */
+  static async clearBackupTarget(context: common.Context): Promise<void> {
+    await AppSettings.setBackupBookId(context, '');
+    await AppSettings.setBackupCalKey(context, '');
+  }
+
   /** 是否开启后台持续同步（长时任务，默认关） */
   static async getBackgroundSync(context: common.Context): Promise<boolean> {
     try {

entry/src/main/ets/common/CalendarDataService.ets

@@ -202,12 +202,14 @@ export class CalendarDataService {
       }
       // 单次覆盖实例（RECURRENCE-ID 独立行）：展开时跳过对应发生，避免重复。
       // 注意：①排除键必须带 calKey（同一系列可能出现在多个日历本）；
-      // ②只有"可见日历本"的覆盖行才参与排除——历史孤儿行（旧账号迁移残留）
+      // ②键必须用 **recurrenceId（原始发生时刻）**——覆盖行的 startTime 是"被改到的新时间"，
+      //   用它做键时主事件在原时间的那次发生不会被排除 → 同一日程显示两条（幽灵日程）；
+      // ③只有"可见日历本"的覆盖行才参与排除——历史孤儿行（旧账号迁移残留）
       //    自己不显示，却会把主事件的对应发生排除掉，导致"第一次不显示"
       const overrideKeys: string[] = [];
       for (const e of rows) {
         if (e.rrule === '' && e.recurring && visibleKeys.includes(e.calKey)) {
-          overrideKeys.push(`${e.calKey}_${e.uid}_${e.startTime}`);
+          overrideKeys.push(EventDb.overrideKey(e.calKey, e.uid, e.recurrenceId, e.startTime));
         }
       }
       let occTotal: number = 0;
@@ -232,7 +234,7 @@ export class CalendarDataService {
           const occs: number[] = RruleUtil.expand(e.rrule, e.startTime, start, end, exNums, 1500);
           if (occs.length > 0) {
             times = occs.filter((occ: number): boolean =>
-              !overrideKeys.includes(`${e.calKey}_${e.uid}_${occ}`));
+              !overrideKeys.includes(EventDb.overrideKey(e.calKey, e.uid, 0, occ)));
           }
         }
         for (const occ of times) {

entry/src/main/ets/common/EventDb.ets

@@ -25,6 +25,10 @@ export class LocalEvent {
   completed: boolean = false; // 待办是否已完成（STATUS:COMPLETED）
   rrule: string = '';       // 原始 RRULE（空 = 非重复）；显示时按规则展开多次发生
   exdate: string = '';      // 原始 EXDATE 排除日期，分号分隔
+  /** ⭐ RECURRENCE-ID：本行"覆盖"的是主事件的哪一次发生（毫秒，0 = 无/旧数据未回填）。
+   *  只改标题时它等于 startTime；**把某次发生改期**时它才是原始时刻——
+   *  排除主事件对应发生时必须用它，否则原时间会残留成"幽灵日程"。 */
+  recurrenceId: number = 0;
   reminder: number = 0;     // 主提醒提前分钟数（第一个提醒，兼容旧字段），0 = 不提醒
   reminders: number[] = []; // 全部提醒提前分钟数（多选），按添加顺序
 }
@@ -44,6 +48,7 @@ export class RemoteEvent {
   completed: boolean = false; // VTODO STATUS:COMPLETED
   rrule: string = '';         // 原始 RRULE
   exdate: string = '';        // 原始 EXDATE（分号分隔）
+  recurrenceId: number = 0;   // 原始 RECURRENCE-ID（毫秒；0 = 无）
   reminder: number = 0;       // 主提醒提前分钟数（第一个提醒，兼容旧字段）
   reminders: number[] = [];   // 全部提醒提前分钟数（多选）
 }
@@ -51,6 +56,36 @@ export class RemoteEvent {
 export class EventDb {
   private static db: relationalStore.RdbStore | null = null;
 
+  /**
+   * ⭐ 统计"是覆盖实例（RECURRENCE-ID 行）但还没回填 recurrence_id"的行数。
+   *
+   * 语义：`recurring=1 且 rrule=''` ⟺ 这一行的 .ics 里有 RECURRENCE-ID。
+   * 老库升级后这些行的 recurrence_id 一律是 0（字段以前被丢弃，无法从本地反推），
+   * 必须靠一次全量重拉（GET 每个 .ics）才能填上。
+   * **用数据本身当标志，而不是内存变量** —— 卡片进程/进程重启会把内存标志吃掉
+   *（实测 2026-09-19 18:30/18:36 两次同步都没触发全量重拉）。
+   * 回填完成后返回值自然变 0，不会反复触发。
+   */
+  static async countOverridesMissingRecurrenceId(context: common.Context): Promise<number> {
+    try {
+      const store = await EventDb.getDb(context);
+      const rs = await store.querySql(
+        "select count(*) c from events " +
+        "where deleted = 0 and recurring = 1 and rrule = '' and recurrence_id = 0");
+      let n: number = 0;
+      try {
+        if (rs.goToNextRow()) {
+          n = rs.getLong(rs.getColumnIndex('c'));
+        }
+      } finally {
+        rs.close();
+      }
+      return n;
+    } catch (err) {
+      return 0;
+    }
+  }
+
   static async getDb(context: common.Context): Promise<relationalStore.RdbStore> {
     if (EventDb.db !== null) {
       return EventDb.db;
@@ -104,6 +139,12 @@ export class EventDb {
     } catch (err) {
       // 列已存在
     }
+    // ⭐ 覆盖实例的"原始发生时刻"（RECURRENCE-ID）。老库升级后该列一律为 0，需要一次全量重拉回填
+    try {
+      await store.executeSql('ALTER TABLE events ADD COLUMN recurrence_id INTEGER DEFAULT 0');
+    } catch (err) {
+      // 列已存在
+    }
     EventDb.db = store;
     return store;
   }
@@ -124,6 +165,18 @@ export class EventDb {
     return EventDb.normalizeReminders(list).join(',');
   }
 
+  /**
+   * ⭐ 覆盖实例（RECURRENCE-ID 独立行）"排除主事件哪一次发生"用的键。
+   *
+   * 必须优先用 **recurrenceId**（原始发生时刻）：覆盖行的 startTime 是**被改到的新时间**，
+   * 用它做键时主事件在**原时间**的那次发生不会被排除 → App 与系统日历里同一日程出现两条
+   * （2026-09-19 真机实测：窗口内 63 条这种"幽灵日程"）。
+   * recurrenceId = 0 表示旧库数据（还没回填）→ 回退到 startTime，保持老行为不变。
+   */
+  static overrideKey(calKey: string, uid: string, recurrenceId: number, startTime: number): string {
+    return `${calKey}_${uid}_${recurrenceId > 0 ? recurrenceId : startTime}`;
+  }
+
   private static fromRow(rs: relationalStore.ResultSet): LocalEvent {
     const e = new LocalEvent();
     e.id = rs.getLong(rs.getColumnIndex('id'));
@@ -146,6 +199,7 @@ export class EventDb {
     e.completed = rs.getLong(rs.getColumnIndex('completed')) === 1;
     e.rrule = rs.getString(rs.getColumnIndex('rrule'));
     e.exdate = rs.getString(rs.getColumnIndex('exdate'));
+    e.recurrenceId = rs.getLong(rs.getColumnIndex('recurrence_id'));
     e.reminder = rs.getLong(rs.getColumnIndex('reminder'));
     // 多提醒（逗号分隔分钟数）；旧数据无该列时回退单提醒
     const remStr: string = rs.getString(rs.getColumnIndex('reminders'));
@@ -178,6 +232,7 @@ export class EventDb {
       'completed': e.completed ? 1 : 0,
       'rrule': e.rrule,
       'exdate': e.exdate,
+      'recurrence_id': e.recurrenceId,
       'reminder': e.reminders.length > 0 ? e.reminders[0] : 0,
       'reminders': e.reminders.map((n: number): string => String(n)).join(',')
     };
@@ -371,12 +426,22 @@ export class EventDb {
     }
 
     const remoteKeys: string[] = [];
+    // ⭐ 同一次解析里可能出现同一资源的多条相同 VEVENT（同 uid + 同 DTSTART）。
+    //    旧版用循环前的 existing 快照判重，插入后不回写 → 第二条仍判为"新增"又插一行，
+    //    在本地库留下 href/etag/remote_path 完全相同的冗余行（2026-09-19 实测 10 组）。
+    const seenKeys: Set<string> = new Set<string>();
     for (const r of remote) {
-      // 重复日程实例共享 UID，唯一标识 = uid + 开始时间
-      const key: string = `${r.uid}_${r.startTime}`;
+      // 重复日程实例共享 UID，唯一标识 = uid + 开始时间 + RECURRENCE-ID
+      //（同一时刻可能同时存在"主事件"与"覆盖该次发生的实例行"，只带上 recurrenceId 才唯一）
+      const key: string = `${r.uid}_${r.startTime}_${r.recurrenceId}`;
+      if (seenKeys.has(key)) {
+        continue; // 同一资源内的重复条目 → 只保留一条
+      }
+      seenKeys.add(key);
       remoteKeys.push(key);
       const found = existing.find((x: LocalEvent): boolean =>
-        !x.dirty && x.uid === r.uid && x.startTime === r.startTime);
+        !x.dirty && x.uid === r.uid && x.startTime === r.startTime
+        && x.recurrenceId === r.recurrenceId);
       if (found === undefined) {
         // 新增
         const e = new LocalEvent();
@@ -398,6 +463,7 @@ export class EventDb {
         e.completed = r.completed;
         e.rrule = r.rrule;
         e.exdate = r.exdate;
+        e.recurrenceId = r.recurrenceId;
         e.reminder = r.reminder;
         e.reminders = r.reminders;
         await store.insert('events', EventDb.toBucket(e));
@@ -420,6 +486,7 @@ export class EventDb {
         found.completed = r.completed;
         found.rrule = r.rrule;
         found.exdate = r.exdate;
+        found.recurrenceId = r.recurrenceId;
         found.reminder = r.reminder;
         found.reminders = r.reminders;
         const up = new relationalStore.RdbPredicates('events');
@@ -435,7 +502,7 @@ export class EventDb {
       if (local.dirty) {
         continue;
       }
-      const localKey: string = `${local.uid}_${local.startTime}`;
+      const localKey: string = `${local.uid}_${local.startTime}_${local.recurrenceId}`;
       if (!remoteKeys.includes(localKey)) {
         const del = new relationalStore.RdbPredicates('events');
         del.equalTo('id', local.id);
@@ -446,11 +513,72 @@ export class EventDb {
     return `新增${added} 更新${updated} 删除${removed} 不变${unchanged}`;
   }
 
-  /** 查询某日历本下同类型的全部行（同步 etag 比对用，含 dirty 行） */
+  /**
+   * 清理"同一资源"的冗余重复行（**纯本地去重，绝不触碰服务器**）。
+   *
+   * 起因：旧版 applyRemote 用循环前的一次性 existing 快照判重，同一个 .ics 里若含
+   * 多条相同 (UID, DTSTART) 的 VEVENT，第二条仍被判为"新增"再插一行 →
+   * 本地库出现 href / etag / remote_path 完全相同的重复行（2026-09-19 实测 10 组）。
+   * 影响：① App 里同一日程显示两条；② 镜像到系统日历后同一 identifier 互相覆盖，
+   *      出现"计划 984 条、系统只写出 983 条"的口径差。
+   *
+   * 口径：同 (cal_key, uid, start_time, recurrence_id) 且在**同一资源**（href 非空）下，
+   * 只保留 id 最小的一行。
+   * 含本地未推送修改（dirty=1）的行整个不参与，绝不会连带删掉待推送数据。
+   * 被删行**不置 dirty/deleted**，因此不会向服务器推送任何删除。
+   * ⚠️ 分组必须带上 recurrence_id：主事件与"覆盖该次发生的实例行"可能同 uid 同 start_time，
+   *    它们是两条**合法**的不同发生，不能被当成冗余行删掉。
+   * @returns 删除的冗余行数
+   */
+  static async dedupeDuplicateRows(context: common.Context): Promise<number> {
+    let removed: number = 0;
+    try {
+      const store = await EventDb.getDb(context);
+      // 只处理"远端资源、已删标记为 0、且没有本地未推送修改（dirty=0）"的行。
+      // 某个组里只要有一行是 dirty，它就不参与分组 → 组内只剩 1 行 → count(*)>1 不成立 → 不动。
+      // 这样绝不会把"待推送的本地修改"连带删掉。
+      const rs = await store.querySql(
+        "select group_concat(id) ids from events " +
+        "where deleted = 0 and dirty = 0 and href <> '' " +
+        "group by cal_key, uid, start_time, recurrence_id having count(*) > 1");
+      const groups: string[] = [];
+      try {
+        while (rs.goToNextRow()) {
+          const v: string = rs.getString(rs.getColumnIndex('ids'));
+          if (v !== undefined && v !== null && v !== '') {
+            groups.push(v);
+          }
+        }
+      } finally {
+        rs.close();
+      }
+      for (const g of groups) {
+        const ids: number[] = g.split(',')
+          .map((s: string): number => Number(s.trim()))
+          .filter((n: number): boolean => !Number.isNaN(n));
+        ids.sort((a: number, b: number): number => a - b);
+        for (let i: number = 1; i < ids.length; i++) { // 0 号（最小 id）保留
+          const del = new relationalStore.RdbPredicates('events');
+          del.equalTo('id', ids[i]);
+          await store.delete(del);
+          removed++;
+        }
+      }
+    } catch (err) {
+      // 去重失败不影响主流程
+      return removed;
+    }
+    return removed;
+  }
+
+  /** 查询某日历本下同类型的全部行（同步 etag 比对用，含 dirty 行）
+   *  ⭐ 固定按 id 升序：镜像/展示遇到"同 uid 多行"时谁先谁后必须稳定，
+   *  否则同一 identifier 每次换一行 → 系统日历在两处之间反复翻转（实测过）。 */
   static async queryByCalKey(context: common.Context, calKey: string, kind: string): Promise<LocalEvent[]> {
     const store = await EventDb.getDb(context);
     const predicates = new relationalStore.RdbPredicates('events');
     predicates.equalTo('cal_key', calKey).and().equalTo('kind', kind);
+    predicates.orderByAsc('id');
     const rs = await store.query(predicates);
     const list: LocalEvent[] = [];
     try {

entry/src/main/ets/common/IcsUtil.ets

@@ -16,6 +16,7 @@ class ParsedEvent {
   inAlarm: boolean = false; // 是否处于 VALARM 子组件内（内部属性不参与解析）
   rrule: string = '';       // 原始 RRULE 值
   exdates: string[] = [];   // 原始 EXDATE 值列表
+  recurrenceId: number = 0; // 原始 RECURRENCE-ID（毫秒）——本行覆盖的是主事件的哪一次发生
   reminder: number = 0;     // 主提醒提前分钟数（第一个 VALARM，0 = 不提醒）
   reminders: number[] = []; // 全部提醒提前分钟数（多 VALARM）
 }
@@ -102,6 +103,16 @@ export class IcsUtil {
         current.recurring = true;
         if (propName === 'RRULE') {
           current.rrule = value;
+        } else {
+          // ⭐ 必须**保留 RECURRENCE-ID 的值**：它指出本行覆盖的是主事件哪一次发生。
+          //    覆盖行的 DTSTART 是"被改到的新时间"，只改标题时两者才相同；
+          //    一旦把某次发生改期，用 startTime 排除主事件那次发生就会漏掉 →
+          //    App 与系统日历里同一日程出现两条（2026-09-19 真机事故）。
+          const recDateOnly: boolean = propPart.toUpperCase().includes('VALUE=DATE');
+          const rt = IcsUtil.parseTime(value, recDateOnly);
+          if (rt !== null) {
+            current.recurrenceId = rt.time;
+          }
         }
       } else if (propName === 'EXDATE') {
         const exValues: string[] = value.split(',');
@@ -140,6 +151,7 @@ export class IcsUtil {
       r.recurring = p.recurring;
       r.rrule = p.rrule;
       r.exdate = p.exdates.join(';');
+      r.recurrenceId = p.recurrenceId;
       r.reminder = p.reminder;
       r.reminders = p.reminders;
       return r;

entry/src/main/ets/common/MirrorInbound.ets

@@ -0,0 +1,328 @@
+// entry/src/main/ets/common/MirrorInbound.ets
+// 入站对账：把"用户在系统日历里做的改动"读回来，写回本地库并置 dirty，随下一次同步推送到 CalDAV。
+//
+// 这是「系统日历 ↔ 同步日历 App ↔ CalDAV 服务器」闭环的**回程**。
+// 出站（CalDAV → 系统日历）在 SystemCalendarMirror，本文件负责反向。
+//
+// ⚠️ 防回灌是这里唯一的核心难题：系统日历里既有"我们写进去的"，也有"用户改的/新建的/删的"，
+//    靠 `MirrorSnapshot`（上次写入值的内容指纹）区分：
+//
+//    | 系统日历当前状态                    | 判定             | 动作                      |
+//    |-----------------------------------|------------------|---------------------------|
+//    | 有 identifier，指纹 == 快照          | 我们自己写的      | 跳过                      |
+//    | 有 identifier，指纹 != 快照          | 用户改了          | 写回本地库 → 置 dirty 推送  |
+//    | 有 identifier，但**没有快照**        | 认作是我们写的    | **补快照后跳过**（不误判）  |
+//    | 快照有，系统里没了                   | 用户删了          | markDeleted → 推送 DELETE |
+//    | identifier 不是我们的格式            | 用户在系统日历新建 | 新建 LocalEvent → 推送     |
+//
+// ⚠️ "没有快照就补快照后跳过"这条非常关键：首次启用回写时快照是空的，
+//    若按"无快照＝用户改了"处理，会把全部日程标脏、全量重推服务器。
+
+import { common } from '@kit.AbilityKit';
+import { calendarManager } from '@kit.CalendarKit';
+import { BusinessError } from '@kit.BasicServicesKit';
+import { EventDb, LocalEvent } from './EventDb';
+import { LogUtil } from './LogUtil';
+import { AppSettings } from './AppSettings';
+import { MirrorSnapshot, MirrorSnapshotRow } from './MirrorSnapshot';
+import { BookRef, SystemCalendarMirror } from './SystemCalendarMirror';
+
+/** 一次入站对账的统计 */
+export class InboundResult {
+  created: number = 0; // 系统日历新建 → 加进 CalDAV
+  updated: number = 0; // 系统日历修改 → 回写 CalDAV
+  deleted: number = 0; // 系统日历删除 → 从 CalDAV 删
+  skipped: number = 0;
+  failed: number = 0;
+}
+
+export class MirrorInbound {
+  private static readonly DAY: number = 86400000;
+  private static readonly QUERY_FIELDS: (keyof calendarManager.Event)[] = [
+    'id', 'type', 'title', 'startTime', 'endTime', 'isAllDay',
+    'description', 'location', 'identifier', 'reminderTime', 'recurrenceRule'
+  ];
+
+  /**
+   * 入站对账主入口。
+   * ⚠️ 必须在 `SyncEngine.syncAccount()` **之前**调用 —— 它产生的 dirty 行要借本次同步一起推送。
+   */
+  static async reconcile(context: common.Context): Promise<InboundResult> {
+    const res: InboundResult = new InboundResult();
+    try {
+      const on: boolean = await AppSettings.getMirrorInbound(context);
+      if (!on) {
+        return res;
+      }
+      if (!await SystemCalendarMirror.hasPermission()) {
+        return res;
+      }
+      const cm: calendarManager.CalendarManager = calendarManager.getCalendarManager(context);
+      // ⭐ 与出站镜像用**同一套**稳定引用（bookId 由服务器 href 派生），否则两边对不上号
+      const refs: BookRef[] = await SystemCalendarMirror.selectedBookRefs(context);
+      for (const ref of refs) {
+        try {
+          await MirrorInbound.reconcileBook(context, cm, ref, res);
+        } catch (err) {
+          const e = err as BusinessError;
+          res.failed++;
+          LogUtil.write(`入站对账失败 bookId=${ref.bookId}: ${e.code ?? ''} ${e.message}`);
+        }
+      }
+      if (res.created + res.updated + res.deleted > 0) {
+        LogUtil.write(
+          `入站对账：新建=${res.created} 修改=${res.updated} 删除=${res.deleted} 跳过=${res.skipped}`);
+      }
+    } catch (err) {
+      const e = err as BusinessError;
+      LogUtil.write(`入站对账异常: ${e.message}`);
+    }
+    return res;
+  }
+
+  /* ==================== 单个日历本 ==================== */
+
+  private static async reconcileBook(
+    context: common.Context,
+    cm: calendarManager.CalendarManager,
+    ref: BookRef,
+    res: InboundResult
+  ): Promise<void> {
+    const calKey: string = ref.calKey; // 仅用于查本地库
+    const bucket: string = ref.bookId; // ⭐ 系统日历侧的一切标识都用 bookId
+    const accountName: string = ref.sysAccountName;
+    let cal: calendarManager.Calendar | undefined = undefined;
+    const calendars: calendarManager.Calendar[] = await cm.getAllCalendars();
+    for (const c of calendars) {
+      if (c.getAccount().name === accountName) {
+        cal = c;
+        break;
+      }
+    }
+    if (cal === undefined) {
+      return; // 还没镜像过，无从对账
+    }
+    const href: string = ref.href;
+    if (href === '') {
+      LogUtil.write(`入站对账跳过 bookId=${bucket}：找不到对应的日历本集合 URL`);
+      return;
+    }
+
+    const snaps: Map<string, MirrorSnapshotRow> = await MirrorSnapshot.loadMap(context, bucket);
+    const events: calendarManager.Event[] = await cal.getEvents(
+      undefined, MirrorInbound.QUERY_FIELDS);
+
+    // 分成两类：带我们 identifier 的（可判定改/删） vs 不是我们的（用户新建）
+    const mine: Map<string, calendarManager.Event> = new Map<string, calendarManager.Event>();
+    const others: calendarManager.Event[] = [];
+    for (const ev of events) {
+      const id: string = ev.identifier ?? '';
+      if (id !== '' && id.startsWith(`${bucket}|`)) {
+        mine.set(id, ev);
+      } else {
+        others.push(ev);
+      }
+    }
+
+    // 本地库现有事件：uid -> LocalEvent
+    const locals: LocalEvent[] = await EventDb.queryByCalKey(context, calKey, 'event');
+    const byUid: Map<string, LocalEvent> = new Map<string, LocalEvent>();
+    for (const e of locals) {
+      if (e.uid !== '') {
+        byUid.set(e.uid, e);
+      }
+    }
+
+    // ① 修改
+    for (const id of mine.keys()) {
+      const ev: calendarManager.Event | undefined = mine.get(id);
+      if (ev === undefined) {
+        continue;
+      }
+      const fp: string = MirrorSnapshot.fingerprintOf(ev);
+      const snap: MirrorSnapshotRow | undefined = snaps.get(id);
+      if (snap === undefined) {
+        // ⚠️ 没有快照：认作是我们自己写的，补一份后跳过 —— 绝不误判成"用户改了"
+        await MirrorSnapshot.put(context, MirrorInbound.rowOf(bucket, id, ev, fp));
+        res.skipped++;
+        continue;
+      }
+      snaps.delete(id); // 还活着，稍后剩下的才是"被删了"
+      if (snap.fingerprint === fp) {
+        res.skipped++; // 没动
+        continue;
+      }
+      // ⚠️ 重复日程的**某一次发生**（identifier 形如 `<bookId>|<uid>@<发生时间戳>`）：
+      //    它是我们从一条重复日程展开出来的，不是独立事件 —— 改它没法映射回服务器上的
+      //    那一条 VEVENT，直接跳过，避免把服务器数据搞乱。
+      if (MirrorInbound.isOccurrence(id)) {
+        res.skipped++;
+        await MirrorSnapshot.put(context, MirrorInbound.rowOf(bucket, id, ev, fp));
+        continue;
+      }
+      const uid: string = MirrorSnapshot.uidOf(id);
+      const local: LocalEvent | undefined = byUid.get(uid);
+      if (local === undefined) {
+        res.skipped++; // 本地已无此条（服务器删了/还没落库）→ 交给出站镜像处理
+        continue;
+      }
+      if (local.dirty || local.deleted) {
+        res.skipped++; // 本地本来就有待推送的改动 → 不拿系统值覆盖，避免两边打架
+        continue;
+      }
+      MirrorInbound.applyToLocal(local, ev);
+      await EventDb.updateLocal(context, local);
+      await MirrorSnapshot.put(context, MirrorInbound.rowOf(bucket, id, ev, fp));
+      res.updated++;
+      LogUtil.write(`入站修改回写：${id}（${local.title}）`);
+    }
+
+    // ② 删除：快照里剩下的（系统日历里已经没有了）
+    for (const id of snaps.keys()) {
+      const snap: MirrorSnapshotRow | undefined = snaps.get(id);
+      if (snap === undefined) {
+        continue;
+      }
+      // 同上：展开出来的"某一次发生"消失（多半是滑出镜像窗口），不能当成用户删除
+      if (MirrorInbound.isOccurrence(id)) {
+        res.skipped++;
+        await MirrorSnapshot.remove(context, id);
+        continue;
+      }
+      const local: LocalEvent | undefined = byUid.get(snap.uid);
+      if (local !== undefined && !local.deleted) {
+        await EventDb.markDeleted(context, local.id);
+        res.deleted++;
+        LogUtil.write(`入站删除回写：${id}（${local.title}）`);
+      } else {
+        res.skipped++;
+      }
+      await MirrorSnapshot.remove(context, id);
+    }
+
+    // ③ 新建：系统日历里 identifier 不是我们格式的条目（用户在系统日历里手动加的）
+    for (const ev of others) {
+      if (ev.id === undefined) {
+        continue;
+      }
+      const uid: string = `sc-${bucket}-${ev.id}`;
+      if (byUid.has(uid)) {
+        continue;
+      }
+      // ⚠️ 先把 identifier 写回系统日历，让它变成"我们的"条目。
+      //    否则下一次出站镜像会把同一条再加一遍 → 系统日历里出现重复。
+      const identifier: string = `${bucket}|${uid}`;
+      const stamped: calendarManager.Event = ev;
+      stamped.identifier = identifier;
+      try {
+        await cal.updateEvent(stamped);
+      } catch (err) {
+        const e = err as BusinessError;
+        res.skipped++;
+        LogUtil.write(`入站新建跳过：无法写回 identifier（${e.message}），避免重复`);
+        continue;
+      }
+      const e: LocalEvent = new LocalEvent();
+      e.uid = uid;
+      e.calKey = calKey;
+      e.href = href;
+      e.remotePath = encodeURIComponent(uid) + '.ics';
+      e.kind = 'event';
+      MirrorInbound.applyToLocal(e, ev);
+      await EventDb.insertLocal(context, e);
+      await MirrorSnapshot.put(context, MirrorInbound.rowOf(
+        bucket, identifier, ev, MirrorSnapshot.fingerprintOf(ev)));
+      res.created++;
+      LogUtil.write(`入站新建回写：${identifier}（${e.title}）`);
+    }
+  }
+
+  /* ==================== 辅助 ==================== */
+
+  /**
+   * 是不是"重复系列里的某一次发生"？identifier 形如 `<bookId>|<uid>@<发生时间戳>`。
+   *
+   * ⚠️ 不能用 `includes('@')` 判断：**uid 本身就常含 @**（如 `20260906T163329-d13e0cb6@172.17.0.1`），
+   *    会误判。只有"最后一段是纯数字"才是我们加的发生时间戳。
+   */
+  private static isOccurrence(id: string): boolean {
+    const pos: number = id.lastIndexOf('@');
+    if (pos < 0) {
+      return false;
+    }
+    const tail: string = id.substring(pos + 1);
+    if (tail === '') {
+      return false;
+    }
+    for (let i: number = 0; i < tail.length; i++) {
+      const c: string = tail[i];
+      if (c < '0' || c > '9') {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  private static rowOf(
+    bucket: string,
+    identifier: string,
+    ev: calendarManager.Event,
+    fp: string
+  ): MirrorSnapshotRow {
+    const row: MirrorSnapshotRow = new MirrorSnapshotRow();
+    row.identifier = identifier;
+    row.calKey = bucket;
+    row.uid = MirrorSnapshot.uidOf(identifier);
+    row.sysId = ev.id ?? -1;
+    row.fingerprint = fp;
+    return row;
+  }
+
+  /** 系统日历 Event → 本工程 LocalEvent（只覆盖可映射字段） */
+  private static applyToLocal(e: LocalEvent, ev: calendarManager.Event): void {
+    e.title = ev.title ?? '';
+    e.description = ev.description ?? '';
+    e.location = ev.location?.location ?? '';
+    e.startTime = ev.startTime;
+    e.isAllDay = ev.isAllDay === true;
+    // 系统全天 endTime 可能是"次日 00:00"，也可能是"当日 23:59:59.999"
+    // → 统一成本工程约定："排他结束日前一毫秒"
+    e.endTime = e.isAllDay
+      ? MirrorInbound.dayStart(ev.endTime - 1) + MirrorInbound.DAY - 1
+      : ev.endTime;
+    e.rrule = MirrorInbound.rruleOf(ev);
+    e.recurring = e.rrule !== '';
+    if (ev.reminderTime !== undefined && ev.reminderTime.length > 0) {
+      e.reminders = [...ev.reminderTime];
+      e.reminder = ev.reminderTime[0];
+    }
+  }
+
+  private static dayStart(ts: number): number {
+    const d: Date = new Date(ts);
+    d.setHours(0, 0, 0, 0);
+    return d.getTime();
+  }
+
+  /** 系统 RecurrenceRule → RRULE 字符串（仅 FREQ/INTERVAL；复杂规则以服务器端为准） */
+  private static rruleOf(ev: calendarManager.Event): string {
+    try {
+      const rr = ev.recurrenceRule;
+      if (rr === undefined) {
+        return '';
+      }
+      const freqMap: string[] = ['YEARLY', 'MONTHLY', 'WEEKLY', 'DAILY'];
+      const fi: number = rr.recurrenceFrequency as number;
+      if (Number.isNaN(fi) || fi < 0 || fi >= freqMap.length) {
+        return '';
+      }
+      let rrule: string = `FREQ=${freqMap[fi]}`;
+      if (rr.interval !== undefined && rr.interval > 1) {
+        rrule += `;INTERVAL=${rr.interval}`;
+      }
+      return rrule;
+    } catch (err) {
+      return '';
+    }
+  }
+}

entry/src/main/ets/common/MirrorSnapshot.ets

@@ -0,0 +1,241 @@
+// entry/src/main/ets/common/MirrorSnapshot.ets
+// 镜像快照：记录"上一次我们把什么写进了系统日历"。
+//
+// 为什么必须有它（防回灌 / 防死循环）：
+//   流程是 CalDAV → 本地库 → 写进系统日历。下一轮同步如果直接读系统日历当"用户改动"，
+//   就会把我们刚写进去的当成用户改的 → 回写服务器 → 服务器变了 → 又镜像回系统日历 …… 死循环。
+//   有了快照就能三方比对：
+//     · 系统当前值 == 快照        → 没动，是我们自己写的，跳过
+//     · 系统当前值 != 快照        → 用户在系统日历改了 → 回写 CalDAV
+//     · 快照有、系统里没了        → 用户在系统日历删了 → 从 CalDAV 删
+//     · 系统里有、快照没有且 identifier 不是我们的格式 → 用户在系统日历新建 → 加进 CalDAV
+//
+// ⚠️ 只存"状态指纹"，**不存日程内容**（内容仍在系统日历与本地库各一份，这是阶段 2 的取舍）。
+//    日程内容只有一份的形态（阶段 3）需要配合"影子表 + 系统日历为内容源"，那是另一件事。
+
+import { common } from '@kit.AbilityKit';
+import { relationalStore } from '@kit.ArkData';
+import { calendarManager } from '@kit.CalendarKit';
+import { BusinessError } from '@kit.BasicServicesKit';
+import { LogUtil } from './LogUtil';
+
+/**
+ * 快照行。
+ * ⚠️ `calKey` 这一列实际存的是**镜像桶标识 = bookId**（由服务器 href 派生的稳定标识），
+ *    与系统日历侧 identifier 前缀、账户名后缀完全一致。列名沿用未改，别再传会变的 calKey。
+ */
+export class MirrorSnapshotRow {
+  identifier: string = '';  // `<bookId>|<uid>`
+  calKey: string = '';
+  uid: string = '';
+  sysId: number = -1;       // 系统日历里的 event id（删除时用）
+  fingerprint: string = ''; // 写入值的内容指纹
+}
+
+export class MirrorSnapshot {
+  private static readonly TABLE: string = 'mirror_snapshot';
+  private static ready: boolean = false;
+
+  /* ==================== 表 ==================== */
+
+  private static async db(context: common.Context): Promise<relationalStore.RdbStore> {
+    const store: relationalStore.RdbStore = await relationalStore.getRdbStore(context, {
+      name: 'sync_calendar.db',
+      securityLevel: relationalStore.SecurityLevel.S1
+    });
+    if (!MirrorSnapshot.ready) {
+      await store.executeSql(
+        'CREATE TABLE IF NOT EXISTS mirror_snapshot (' +
+        'identifier TEXT PRIMARY KEY, cal_key TEXT, uid TEXT, ' +
+        'sys_id INTEGER, fingerprint TEXT, updated_at INTEGER)'
+      );
+      MirrorSnapshot.ready = true;
+    }
+    return store;
+  }
+
+  /* ==================== 读写 ==================== */
+
+  /** 取某个日历本的全部快照，key = identifier。**bucket 必须是 bookId** */
+  static async loadMap(context: common.Context, bucket: string): Promise<Map<string, MirrorSnapshotRow>> {
+    const out: Map<string, MirrorSnapshotRow> = new Map<string, MirrorSnapshotRow>();
+    try {
+      const store: relationalStore.RdbStore = await MirrorSnapshot.db(context);
+      const predicates = new relationalStore.RdbPredicates(MirrorSnapshot.TABLE);
+      predicates.equalTo('cal_key', bucket);
+      const rs = await store.query(predicates);
+      try {
+        while (rs.goToNextRow()) {
+          const row: MirrorSnapshotRow = new MirrorSnapshotRow();
+          row.identifier = rs.getString(rs.getColumnIndex('identifier'));
+          row.calKey = bucket;
+          row.uid = rs.getString(rs.getColumnIndex('uid'));
+          row.sysId = rs.getLong(rs.getColumnIndex('sys_id'));
+          row.fingerprint = rs.getString(rs.getColumnIndex('fingerprint'));
+          out.set(row.identifier, row);
+        }
+      } finally {
+        rs.close();
+      }
+    } catch (err) {
+      const e = err as BusinessError;
+      LogUtil.write(`读取镜像快照失败 bucket=${bucket}: ${e.message}`);
+    }
+    return out;
+  }
+
+  /**
+   * **整体重建**某个日历本的快照：先删光旧行，再写入新行。
+   * 为什么不用增量：出站镜像后直接把系统日历里该账户的实际内容重新读一遍再落快照最稳，
+   * 不用在写入过程中追踪 addEvent 返回的 id（批量 addEvents 还不返回 id）。
+   */
+  static async replaceAll(
+    context: common.Context,
+    bucket: string,
+    events: calendarManager.Event[]
+  ): Promise<number> {
+    let n: number = 0;
+    try {
+      const store: relationalStore.RdbStore = await MirrorSnapshot.db(context);
+      const del = new relationalStore.RdbPredicates(MirrorSnapshot.TABLE);
+      del.equalTo('cal_key', bucket);
+      await store.delete(del);
+      const now: number = Date.now();
+      for (const ev of events) {
+        const id: string = ev.identifier ?? '';
+        if (id === '') {
+          continue; // 用户在系统日历自己加的、没有我们 identifier 的 → 不进快照（由入站对账新建）
+        }
+        const vb: relationalStore.ValuesBucket = {
+          'identifier': id,
+          'cal_key': bucket,
+          'uid': MirrorSnapshot.uidOf(id),
+          'sys_id': ev.id ?? -1,
+          'fingerprint': MirrorSnapshot.fingerprintOf(ev),
+          'updated_at': now
+        };
+        await store.insert(MirrorSnapshot.TABLE, vb);
+        n++;
+      }
+    } catch (err) {
+      const e = err as BusinessError;
+      LogUtil.write(`重建镜像快照失败 bucket=${bucket}: ${e.message}`);
+    }
+    return n;
+  }
+
+  /** 写入/更新单条快照（入站回写成功后同步指纹，避免下次重复判定为"用户改了"） */
+  static async put(context: common.Context, row: MirrorSnapshotRow): Promise<void> {
+    try {
+      const store: relationalStore.RdbStore = await MirrorSnapshot.db(context);
+      const bucket: relationalStore.ValuesBucket = {
+        'identifier': row.identifier,
+        'cal_key': row.calKey,
+        'uid': row.uid,
+        'sys_id': row.sysId,
+        'fingerprint': row.fingerprint,
+        'updated_at': Date.now()
+      };
+      await store.insert(MirrorSnapshot.TABLE, bucket);
+    } catch (err) {
+      // 主键冲突时改成 update
+      try {
+        const store: relationalStore.RdbStore = await MirrorSnapshot.db(context);
+        const bucket: relationalStore.ValuesBucket = {
+          'sys_id': row.sysId,
+          'fingerprint': row.fingerprint,
+          'updated_at': Date.now()
+        };
+        const predicates = new relationalStore.RdbPredicates(MirrorSnapshot.TABLE);
+        predicates.equalTo('identifier', row.identifier);
+        await store.update(bucket, predicates);
+      } catch (err2) {
+        const e = err2 as BusinessError;
+        LogUtil.write(`写入镜像快照失败 ${row.identifier}: ${e.message}`);
+      }
+    }
+  }
+
+  /** 删除单条（用户删了 / 本地已不存在） */
+  static async remove(context: common.Context, identifier: string): Promise<void> {
+    try {
+      const store: relationalStore.RdbStore = await MirrorSnapshot.db(context);
+      const predicates = new relationalStore.RdbPredicates(MirrorSnapshot.TABLE);
+      predicates.equalTo('identifier', identifier);
+      await store.delete(predicates);
+    } catch (err) {
+      // 忽略
+    }
+  }
+
+  /** 删除整个日历本的快照（取消勾选 / 关闭镜像时调用）。bucket = bookId */
+  static async removeByCalKey(context: common.Context, bucket: string): Promise<void> {
+    try {
+      const store: relationalStore.RdbStore = await MirrorSnapshot.db(context);
+      const predicates = new relationalStore.RdbPredicates(MirrorSnapshot.TABLE);
+      predicates.equalTo('cal_key', bucket);
+      await store.delete(predicates);
+    } catch (err) {
+      // 忽略
+    }
+  }
+
+  /** 清空全部快照（关闭镜像总开关时用，顺带清掉历史遗留的 calKey 键） */
+  static async clearAll(context: common.Context): Promise<void> {
+    try {
+      const store: relationalStore.RdbStore = await MirrorSnapshot.db(context);
+      const predicates = new relationalStore.RdbPredicates(MirrorSnapshot.TABLE);
+      await store.delete(predicates);
+    } catch (err) {
+      // 忽略
+    }
+  }
+
+  /* ==================== 指纹 ==================== */
+
+  /**
+   * 事件内容指纹。用于判断"系统日历里这条，是不是还是我们上次写进去的样子"。
+   * ⚠️ 全天日程的 endTime 会被系统归一化（我们写次日 00:00，可能读回 23:59:59.999），
+   * 所以全天一律折成"日"再算指纹，否则每次都判定成"用户改了"。
+   */
+  static fingerprintOf(ev: calendarManager.Event): string {
+    const allDay: boolean = ev.isAllDay === true;
+    let start: number = ev.startTime;
+    let end: number = ev.endTime;
+    if (allDay) {
+      start = MirrorSnapshot.dayStart(start);
+      end = MirrorSnapshot.dayStart(end - 1);
+    }
+    const raw: string = [
+      ev.title ?? '',
+      `${start}`,
+      `${end}`,
+      allDay ? '1' : '0',
+      ev.location?.location ?? '',
+      ev.description ?? '',
+      MirrorSnapshot.hash(ev.recurrenceRule !== undefined ? JSON.stringify(ev.recurrenceRule) : '')
+    ].join('\u0001');
+    return `${MirrorSnapshot.hash(raw)}:${MirrorSnapshot.hash(raw, 5381)}`;
+  }
+
+  /** identifier (`<calKey>|<uid>`) → uid */
+  static uidOf(identifier: string): string {
+    const pos: number = identifier.indexOf('|');
+    return pos < 0 ? '' : identifier.substring(pos + 1);
+  }
+
+  private static dayStart(ts: number): number {
+    const d: Date = new Date(ts);
+    d.setHours(0, 0, 0, 0);
+    return d.getTime();
+  }
+
+  /** 简单字符串哈希（djb2 变体）。两个不同种子各算一次拼起来，降低碰撞概率 */
+  private static hash(s: string, seed?: number): string {
+    let h: number = seed === undefined ? 0 : seed;
+    for (let i: number = 0; i < s.length; i++) {
+      h = ((h << 5) + h + s.charCodeAt(i)) | 0;
+    }
+    return (h >>> 0).toString(36);
+  }
+}

entry/src/main/ets/common/SyncEngine.ets

@@ -46,6 +46,18 @@ export class SyncEngine {
     // 日志不记录账号名（用户自定义，可能含个人信息），以 id + 服务器地址定位
     LogUtil.write(`========== 同步账号 id=${acc.id} 开始：服务器 ${acc.serverUrl}，共 ${acc.calendarHrefs.length} 个日历本 ==========`);
     try {
+      // ⭐ 库结构升级（recurrence_id 列）：老库里覆盖实例的该列全是 0，而被丢弃的
+      //    RECURRENCE-ID 无法从本地任何字段反推 → 必须靠一次全量重拉（GET 每个 .ics）回填。
+      //    不回填的后果：把某次发生改期的覆盖实例无法排除主事件在原时间的那次发生，
+      //    App 与系统日历里同一日程会显示两条（幽灵日程）。
+      //    ⚠️ 判据必须是**数据库里的真实状态**：内存标志会被卡片进程/进程重启吃掉
+      //    （2026-09-19 实测两次同步都没触发）。回填完成后计数自然归 0，不会反复重拉。
+      await EventDb.getDb(context);
+      const ridMissing: number = await EventDb.countOverridesMissingRecurrenceId(context);
+      if (ridMissing > 0) {
+        LogUtil.write(`recurrence_id 待回填 ${ridMissing} 条覆盖实例 → 重置"一次性全量重拉"`);
+        await AppSettings.resetFullRefetch(context);
+      }
       // 全量重拉（升级后首次）要逐个 GET 所有资源，放宽超时到 10 分钟；常规 5 分钟
       const fullRefetch: boolean = await AppSettings.isFullRefetchPending(context);
       const timeoutMs: number = fullRefetch ? 600000 : 300000;
@@ -280,6 +292,7 @@ export class SyncEngine {
     r.completed = e.completed;
     r.rrule = e.rrule;
     r.exdate = e.exdate;
+    r.recurrenceId = e.recurrenceId;
     r.reminder = e.reminder;
     r.reminders = e.reminders.slice();
     return r;
@@ -345,6 +358,16 @@ export class SyncEngine {
         await EventDb.clearDirty(context, e.id, '');
       }
     }
+    // ⭐ 顺带清理"同一资源被重复插入"的冗余行（旧版 applyRemote 判重缺陷遗留的脏数据）。
+    //    纯本地去重、不推服务器；放在这里是因为它是每次同步都会经过的收尾步骤。
+    try {
+      const dup: number = await EventDb.dedupeDuplicateRows(context);
+      if (dup > 0) {
+        LogUtil.write(`清理本地重复行：${dup} 条（同一资源被插了多次）`);
+      }
+    } catch (err) {
+      // 忽略：去重失败不影响同步
+    }
   }
 
   /**

entry/src/main/ets/common/SystemCalendarImport.ets

@@ -5,10 +5,10 @@
 import { common } from '@kit.AbilityKit';
 import { calendarManager } from '@kit.CalendarKit';
 import { BusinessError } from '@kit.BasicServicesKit';
-import { AccountStore, DavAccount } from './AccountStore';
 import { EventDb, LocalEvent } from './EventDb';
 import { AppSettings } from './AppSettings';
 import { LogUtil } from './LogUtil';
+import { BookRef, SystemCalendarMirror } from './SystemCalendarMirror';
 
 export class SystemCalendarImport {
   /**
@@ -16,6 +16,15 @@ export class SystemCalendarImport {
    * 幂等：uid = syscal-<系统日历id>-<事件id>，已存在则跳过，因此每次同步都可安全执行。
    * 只读取 calendarType = LOCAL 的系统日历（手机本地日历/应用创建的日程），
    * 系统 CalDAV 同步产生的账户日历一律跳过，避免死循环回灌。
+   *
+   * ⚠️ 另有两层防重复（09-18 补）：
+   *   1. **跳过本应用镜像出去的账户**（`synccalendar.mirror.*`）——它们的 type 也是 LOCAL，
+   *      但内容是我们从 CalDAV 写进去的，再导进备份本会让同一条日程在服务器出现两份。
+   *   2. 导进备份本的 uid 统一带 `syscal-` 前缀，出站镜像会跳过该前缀 → 备份本不会被镜像回系统日历。
+   *
+   * ⚠️ 目标本用**稳定标识 bookId** 解析（`SystemCalendarMirror.backupTargetRef`）：
+   *    用户「取消勾选」目标本后序号会整体前移，老版本按 `accId_序号` 定位会**导进另一个本**。
+   *    现在解析不到即视为失效，并把「备份到 CalDAV」模式**自动关回仅显示**。
    */
   static async importIfNeeded(context: common.Context): Promise<number> {
     try {
@@ -23,30 +32,42 @@ export class SystemCalendarImport {
       if (mode !== 'backup') {
         return 0;
       }
-      const calKey: string = await AppSettings.getBackupCalKey(context);
-      if (calKey === '') {
-        LogUtil.write('系统日历备份：未选择目标日历本，跳过导入');
+      // ⭐ 目标本一律走 `backupTargetRef()`：内部用**稳定标识 bookId** 解析，
+      //    并兼做「老 calKey 值 → bookId」的一次性迁移。
+      //    解析不到时它会**自动把 sys_cal_mode 关回 display**（用户明确要求的行为）：
+      //    目标本被取消同步/账号被删后，绝不能"随便挑一个本"把系统日历导进去。
+      const ref: BookRef | undefined = await SystemCalendarMirror.backupTargetRef(context);
+      if (ref === undefined) {
+        // 未选择目标本（或刚被判失效并关闭）→ 跳过。原因已由 backupTargetRef 写进日志。
+        LogUtil.write('系统日历备份：当前无有效目标日历本，跳过导入');
         return 0;
       }
-      // 定位目标 CalDAV 日历本
-      const accounts: DavAccount[] = await AccountStore.loadAll(context);
-      let targetHref: string = '';
-      for (const acc of accounts) {
-        for (let i = 0; i < acc.calendarHrefs.length; i++) {
-          if (`${acc.id}_${i}` === calKey) {
-            targetHref = acc.calendarHrefs[i];
-          }
-        }
-      }
+      const calKey: string = ref.calKey; // 仅用于查本地库 / 落库
+      const targetHref: string = ref.href;
       if (targetHref === '') {
-        LogUtil.write(`系统日历备份：目标日历本 ${calKey} 不存在（账号可能已删除），跳过导入`);
+        LogUtil.write(`系统日历备份：目标日历本 ${ref.bookId} 缺少集合 URL，跳过导入`);
         return 0;
       }
       const uiContext = context as common.UIAbilityContext;
       const mgr: calendarManager.CalendarManager = calendarManager.getCalendarManager(uiContext);
       const calendars: calendarManager.Calendar[] = await mgr.getAllCalendars();
+      // 诊断：把 getAllCalendars() 实际能读到的账户全列出来。
+      // 用于确认"是否只能读到本应用创建的 + 系统默认账户"，还是能读到其他应用自建的日历账户。
+      const brief: string[] = [];
+      for (const cal of calendars) {
+        let acc: calendarManager.CalendarAccount;
+        try {
+          acc = cal.getAccount();
+        } catch (err) {
+          continue;
+        }
+        const tag: string = SystemCalendarMirror.isMirrorAccountName(acc.name) ? '(我们的镜像)' : '';
+        brief.push(`${acc.name}[type=${acc.type}]${tag}`);
+      }
+      LogUtil.write(`系统日历账户清单：共 ${calendars.length} 个 → ${brief.join(' | ')}`);
       let imported: number = 0;
       let skippedCal: number = 0;
+      let skippedMirror: number = 0; // 本应用镜像出去的账户（不能导进备份本，否则重复）
       for (const cal of calendars) {
         try {
           // 只处理"本地"类型系统日历；CalDAV/订阅等账户日历的数据源本来就在服务器上，跳过防回灌
@@ -55,6 +76,13 @@ export class SystemCalendarImport {
             skippedCal++;
             continue;
           }
+          // ⚠️ 关键：跳过**本应用自己镜像出去的账户**（type 同样 LOCAL，但内容是我们从 CalDAV 写进去的）。
+          //    若一并导入备份本，同一条日程会在服务器里出现两份（原始本一份、备份本一份）→ 数据非常乱。
+          //    这些账户的改动由 MirrorInbound 负责回写到它**原本所属**的日历本，不走备份通道。
+          if (SystemCalendarMirror.isMirrorAccountName(account.name)) {
+            skippedMirror++;
+            continue;
+          }
           const events: calendarManager.Event[] = await cal.getEvents();
           for (const ev of events) {
             if (ev.id === undefined) {
@@ -86,8 +114,9 @@ export class SystemCalendarImport {
           // 单个日历读取失败不影响其余
         }
       }
-      if (imported > 0 || skippedCal > 0) {
-        LogUtil.write(`系统日历备份：新增 ${imported} 条 → ${calKey}（跳过账户日历 ${skippedCal} 个）`);
+      if (imported > 0 || skippedCal > 0 || skippedMirror > 0) {
+        LogUtil.write(
+          `系统日历备份：新增 ${imported} 条 → ${calKey}（跳过非本地账户 ${skippedCal} 个、镜像账户 ${skippedMirror} 个）`);
       }
       return imported;
     } catch (err) {