Add files via upload

save-manager.js

@@ -0,0 +1,140 @@
+/**
+ * 统一保存管理器
+ * 解决频繁调用 saveSettingsDebounced 导致的 "Settings could not be saved" 问题
+ */
+
+import { saveSettingsDebounced } from '../../../../script.js';
+
+// 保存状态
+let saveTimer = null;
+let isSaving = false;
+let pendingSave = false;
+let autoSaveTimer = null;
+let hasPendingChanges = false; // 标记是否有未保存的变更
+
+// 配置
+const SAVE_DELAY = 2500; // 2.5秒延迟，合并频繁操作
+const SAVE_COOLDOWN = 1000; // 保存后的冷却时间
+const AUTO_SAVE_INTERVAL = 15000; // 15秒自动保存间隔（移动端保险）
+
+/**
+ * 请求保存（防抖）
+ * 用于一般操作，会合并多次调用
+ */
+export function requestSave() {
+  hasPendingChanges = true; // 标记有待保存的变更
+
+  // 如果已经有待处理的定时器，清除它
+  if (saveTimer) {
+    clearTimeout(saveTimer);
+  }
+
+  // 设置新的定时器
+  saveTimer = setTimeout(() => {
+    saveTimer = null;
+    executeSave();
+  }, SAVE_DELAY);
+}
+
+/**
+ * 立即保存
+ * 用于关键操作，如发送消息完成、删除联系人等
+ */
+export function saveNow() {
+  hasPendingChanges = true; // 确保标记
+  // 清除待处理的定时器
+  if (saveTimer) {
+    clearTimeout(saveTimer);
+    saveTimer = null;
+  }
+
+  executeSave();
+}
+
+/**
+ * 执行实际保存
+ */
+function executeSave() {
+  // 如果正在保存，标记有待处理的保存请求
+  if (isSaving) {
+    pendingSave = true;
+    return;
+  }
+
+  isSaving = true;
+  hasPendingChanges = false; // 清除待保存标记
+
+  try {
+    saveSettingsDebounced();
+  } catch (e) {
+    console.error('[SaveManager] 保存失败:', e);
+  }
+
+  // 冷却期后重置状态
+  setTimeout(() => {
+    isSaving = false;
+    // 如果冷却期间有新的保存请求，执行它
+    if (pendingSave) {
+      pendingSave = false;
+      executeSave();
+    }
+  }, SAVE_COOLDOWN);
+}
+
+/**
+ * 自动保存检查
+ * 定期检查是否有未保存的变更，有则保存
+ */
+function autoSaveCheck() {
+  if (hasPendingChanges && !isSaving && !saveTimer) {
+    console.log('[SaveManager] 自动保存触发');
+    executeSave();
+  }
+}
+
+/**
+ * 启动自动保存定时器
+ */
+function startAutoSave() {
+  if (autoSaveTimer) return; // 避免重复启动
+  autoSaveTimer = setInterval(autoSaveCheck, AUTO_SAVE_INTERVAL);
+}
+
+/**
+ * 统一处理页面卸载/隐藏时的保存
+ */
+function handleUnload() {
+  if (saveTimer) {
+    clearTimeout(saveTimer);
+    saveTimer = null;
+  }
+  // 直接调用原始保存函数，确保数据不丢失
+  if (hasPendingChanges) {
+    saveSettingsDebounced();
+    hasPendingChanges = false;
+  }
+}
+
+/**
+ * 页面卸载前保存
+ * 支持桌面端和移动端
+ */
+export function setupUnloadSave() {
+  // 桌面端：关闭/刷新页面时触发
+  window.addEventListener('beforeunload', handleUnload);
+
+  // 移动端关键：页面变为不可见时立即保存
+  // 当用户切换应用、锁屏、切换标签页时触发
+  document.addEventListener('visibilitychange', () => {
+    if (document.visibilityState === 'hidden') {
+      handleUnload();
+    }
+  });
+
+  // 移动端补充：比 beforeunload 更可靠的页面卸载事件
+  // 在 iOS Safari 和部分 Android 浏览器上效果更好
+  window.addEventListener('pagehide', handleUnload);
+
+  // 启动自动保存（移动端的最后保险）
+  startAutoSave();
+}