@pisell/pisellos 0.0.568 → 0.0.569

package/dist/server/modules/order/index.js

@@ -1,10 +1,14 @@
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
@@ -29,6 +33,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import { cloneDeep } from 'lodash-es';
 import dayjs from 'dayjs';
 import { BaseModule } from "../../../modules/BaseModule";
+import { applyOrderCollectionUidRemaps, getOrderCollectionPersistentId, getOrderCollectionReferenceUid, getOrderCollectionUid, isSameOrderCollectionItem, mergeOrderCollectionItems, normalizeOrderCollections } from "../../../modules/Order/utils/orderCollectionIdentity";
 import { OrderHooks } from "./types";
 
 /**
@@ -36,6 +41,27 @@ import { OrderHooks } from "./types";
  */
 var INDEXDB_STORE_NAME = 'orders';
 var ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY = 'server_order_last_full_fetch_at';
+var ORDER_SYNC_THROTTLE_MS_STORAGE_KEY = 'order_sync_throttle_ms';
+var DEFAULT_ORDER_SYNC_THROTTLE_MS = 2000;
+/** pubsub 回声写入去重窗口：业务 API 刚写入后，跳过同单 SQLite patch */
+var ORDER_SQLITE_DEDUPE_MS = 15000;
+/** silentRefresh 最小间隔，避免 preload 后立即全量重拉 */
+var ORDER_SILENT_REFRESH_MIN_INTERVAL_MS = 30000;
+/** 视为「业务侧刚写入」的来源，pubsub 回声可跳过 SQLite */
+var ORDER_BUSINESS_WRITE_SOURCES = new Set(['upsertOrdersFromRemote', 'upsertPendingSyncOrders', 'overwriteExistingOrder', 'markOrderSyncedByExternalSaleNumber']);
+
+/**
+ * 合并热路径全表去重自检开关：默认关闭。
+ * 开启后每次合并会额外对整张 store 做一次 O(n^2) 重复检测并告警，
+ * 仅用于排查增量身份索引是否遗漏了重复订单，不应在生产常开。
+ */
+var ORDER_MERGE_SELF_CHECK = false;
+var ORDER_AUTHORITATIVE_COLLECTION_FIELDS = ['products', 'bookings', 'payments'];
+var ORDER_COLLECTION_KIND_BY_FIELD = {
+  products: 'product',
+  bookings: 'booking',
+  payments: 'payment'
+};
 
 /**
  * Order 模块 - 基础框架
@@ -54,22 +80,68 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "orderDataSource", void 0);
     _defineProperty(_assertThisInitialized(_this), "pendingSyncMessages", []);
     _defineProperty(_assertThisInitialized(_this), "syncTimer", void 0);
-    _defineProperty(_assertThisInitialized(_this), "ORDER_SYNC_DEBOUNCE_MS", 5000);
-    // Map<resource_id, OrderId[]> 资源到订单的倒排索引
-    _defineProperty(_assertThisInitialized(_this), "resourceIdIndex", new Map());
+    _defineProperty(_assertThisInitialized(_this), "isProcessingSyncBatch", false);
+    _defineProperty(_assertThisInitialized(_this), "isIdlePhase", true);
     _defineProperty(_assertThisInitialized(_this), "logger", void 0);
     // LoggerManager 实例
     _defineProperty(_assertThisInitialized(_this), "storage", void 0);
+    _defineProperty(_assertThisInitialized(_this), "orderSQLiteSaveQueue", Promise.resolve());
+    /** 按 storageKey 记录最近一次 SQLite 写入来源与时间，用于去重 */
+    _defineProperty(_assertThisInitialized(_this), "recentSqliteWriteByStorageKey", new Map());
+    /** 最近一次 SSE 全量拉取完成时间 */
+    _defineProperty(_assertThisInitialized(_this), "lastServerFullFetchAtMs", 0);
     return _this;
   }
+
+  /**
+   * 广播订单变更事件，兼容全量列表订阅并额外携带本次变更订单。
+   *
+   * @example
+   * await this.emitOrdersChanged([freshOrder], 'pubsub.bodyUpsert')
+   */
   _createClass(OrderModule, [{
-    key: "initialize",
-    value: function () {
-      var _initialize = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(core, options) {
-        var _options$initialState;
-        var appPlugin, app, _this$store$createdAt, coreData, today, operatingDayBoundary, boundaryTime, boundaryStart, boundaryEnd;
+    key: "emitOrdersChanged",
+    value: (function () {
+      var _emitOrdersChanged = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+        var _this2 = this;
+        var changedOrders,
+          source,
+          payload,
+          _args = arguments;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
+            case 0:
+              changedOrders = _args.length > 0 && _args[0] !== undefined ? _args[0] : [];
+              source = _args.length > 1 ? _args[1] : undefined;
+              payload = {
+                list: this.store.list,
+                changedOrders: changedOrders.map(function (order) {
+                  return _this2.normalizeOrderForMemoryList(order);
+                }),
+                source: source
+              };
+              _context.next = 5;
+              return this.core.effects.emit(OrderHooks.onOrdersChanged, payload);
+            case 5:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function emitOrdersChanged() {
+        return _emitOrdersChanged.apply(this, arguments);
+      }
+      return emitOrdersChanged;
+    }())
+  }, {
+    key: "initialize",
+    value: function () {
+      var _initialize = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(core, options) {
+        var _options$initialState,
+          _this3 = this;
+        var appPlugin, app;
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
             case 0:
               this.core = core;
               this.store = options === null || options === void 0 ? void 0 : options.store;
@@ -80,42 +152,14 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 this.dbManager = app.sqlite;
                 this.logger = app.logger;
                 this.storage = app.storage;
-                coreData = app.data.store.getStore().getDataByModel('core');
-                if (!((_this$store$createdAt = this.store.createdAtQuery) !== null && _this$store$createdAt !== void 0 && _this$store$createdAt.sales_time_between) && coreData !== null && coreData !== void 0 && coreData.core) {
-                  today = dayjs();
-                  if (coreData !== null && coreData !== void 0 && coreData.core.operating_day_boundary) {
-                    operatingDayBoundary = coreData.core.operating_day_boundary;
-                    if (operatingDayBoundary.type === 'start_time') {
-                      boundaryTime = String(operatingDayBoundary.time || '').trim();
-                      boundaryStart = dayjs("".concat(today.format('YYYY-MM-DD'), " ").concat(boundaryTime));
-                      boundaryEnd = boundaryStart.add(1, 'day');
-                      if (boundaryStart.isValid()) {
-                        this.store.createdAtQuery = {
-                          sales_time_between: [boundaryStart.format('YYYY-MM-DD HH:mm:ss'), boundaryEnd.format('YYYY-MM-DD HH:mm:ss')]
-                        };
-                      } else {
-                        // 边界时间异常时回退到自然日，避免 createdAtQuery 为空导致后续查询异常
-                        this.store.createdAtQuery = {
-                          sales_time_between: [today.startOf('day').format('YYYY-MM-DD HH:mm:ss'), today.endOf('day').format('YYYY-MM-DD HH:mm:ss')]
-                        };
-                      }
-                    } else {
-                      this.store.createdAtQuery = {
-                        sales_time_between: [today.startOf('day').format('YYYY-MM-DD HH:mm:ss'), today.endOf('day').format('YYYY-MM-DD HH:mm:ss')]
-                      };
-                    }
-                  } else {
-                    // TODO: 这里后续可能需要使用店铺营业时间查询
-                    this.store.createdAtQuery = {
-                      sales_time_between: [today.startOf('day').format('YYYY-MM-DD HH:mm:ss'), today.endOf('day').format('YYYY-MM-DD HH:mm:ss')]
-                    };
-                  }
-                }
+                this.updateCreateStore();
               }
               if (Array.isArray(options === null || options === void 0 || (_options$initialState = options.initialState) === null || _options$initialState === void 0 ? void 0 : _options$initialState.list)) {
-                this.store.list = options.initialState.list;
+                this.store.list = options.initialState.list.map(function (order) {
+                  return _this3.normalizeOrderForMemoryList(order);
+                });
                 this.syncOrdersMap();
-                this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
+                this.emitOrdersChanged([], 'initialState');
               } else {
                 this.store.list = [];
                 this.store.map = new Map();
@@ -129,9 +173,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               });
             case 10:
             case "end":
-              return _context.stop();
+              return _context2.stop();
           }
-        }, _callee, this);
+        }, _callee2, this);
       }));
       function initialize(_x, _x2) {
         return _initialize.apply(this, arguments);
@@ -139,10 +183,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return initialize;
     }()
     /**
-    * 记录信息日志
-    * @param title 日志标题
-    * @param metadata 日志元数据
-    */
+     * 记录信息日志
+     * @param title 日志标题
+     * @param metadata 日志元数据
+     */
   }, {
     key: "logInfo",
     value: function logInfo(title, metadata) {
@@ -179,32 +223,439 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         // 日志记录失败不影响主流程
       }
     }
+  }, {
+    key: "logWarning",
+    value: function logWarning(title, metadata) {
+      try {
+        if (this.logger) {
+          this.logger.addLog({
+            type: 'warning',
+            title: "[OrderServerModule] ".concat(title),
+            metadata: metadata || {}
+          });
+        }
+      } catch (_unused3) {
+        // 日志记录失败不影响主流程
+      }
+    }
+
+    /**
+     * 在订单进入内存或 SQLite 前统一压缩子项强身份重复并补齐协议 UID。
+     * 仅记录计数与订单标识，不输出商品、预约、支付或客户明细。
+     */
+  }, {
+    key: "normalizeOrderCollectionsForIngress",
+    value: function normalizeOrderCollectionsForIngress(order, source) {
+      var result = normalizeOrderCollections(order);
+      var kinds = ['product', 'booking', 'payment'];
+      var hasChanges = kinds.some(function (kind) {
+        var stats = result.stats[kind];
+        return stats.backfilledUidCount > 0 || stats.collapsedDuplicateCount > 0 || stats.uidConflictCount > 0 || stats.anonymousRowCount > 0;
+      });
+      if (hasChanges) {
+        var _order$order_id, _external_sale_number;
+        var summarize = function summarize(stats) {
+          return {
+            backfilled_uid_count: stats.backfilledUidCount,
+            collapsed_duplicate_count: stats.collapsedDuplicateCount,
+            uid_conflict_count: stats.uidConflictCount,
+            anonymous_row_count: stats.anonymousRowCount
+          };
+        };
+        var context = {
+          source: source,
+          order_id: (_order$order_id = order === null || order === void 0 ? void 0 : order.order_id) !== null && _order$order_id !== void 0 ? _order$order_id : null,
+          external_sale_number: (_external_sale_number = order === null || order === void 0 ? void 0 : order.external_sale_number) !== null && _external_sale_number !== void 0 ? _external_sale_number : null,
+          products: summarize(result.stats.product),
+          bookings: summarize(result.stats.booking),
+          payments: summarize(result.stats.payment)
+        };
+        var hasUnsafeIdentity = kinds.some(function (kind) {
+          var stats = result.stats[kind];
+          return stats.uidConflictCount > 0 || stats.anonymousRowCount > 0;
+        });
+        if (hasUnsafeIdentity) {
+          this.logWarning('订单子项身份存在冲突或匿名行', context);
+        } else {
+          this.logInfo('订单子项身份已规范化', context);
+        }
+      }
+      return result.order;
+    }
+
+    /**
+     * incoming 决定权威成员集合；同一持久化行仍从 existing 补齐 incoming 省略的本地展示字段。
+     */
+  }, {
+    key: "mergeAuthoritativeOrderCollection",
+    value: function mergeAuthoritativeOrderCollection(field, existing, incoming) {
+      var uidRemaps = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : [];
+      var kind = ORDER_COLLECTION_KIND_BY_FIELD[field];
+      var existingItems = Array.isArray(existing) ? existing : [];
+      return incoming.map(function (incomingItem) {
+        var existingItem = existingItems.find(function (item) {
+          return isSameOrderCollectionItem(kind, item, incomingItem);
+        });
+        if (!existingItem) return cloneDeep(incomingItem);
+        var mergedItem = mergeOrderCollectionItems(kind, existingItem, incomingItem);
+        var mergedUid = getOrderCollectionUid(kind, mergedItem);
+        if (mergedUid) {
+          var _iterator = _createForOfIteratorHelper(new Set([getOrderCollectionReferenceUid(kind, existingItem), getOrderCollectionReferenceUid(kind, incomingItem)])),
+            _step;
+          try {
+            for (_iterator.s(); !(_step = _iterator.n()).done;) {
+              var from = _step.value;
+              if (!from || from === mergedUid) continue;
+              uidRemaps.push({
+                kind: kind,
+                from: from,
+                to: mergedUid,
+                persistentId: getOrderCollectionPersistentId(kind, incomingItem) || getOrderCollectionPersistentId(kind, existingItem)
+              });
+            }
+          } catch (err) {
+            _iterator.e(err);
+          } finally {
+            _iterator.f();
+          }
+        }
+        return mergedItem;
+      });
+    }
+  }, {
+    key: "reconcileOverwriteOrderCollections",
+    value: function reconcileOverwriteOrderCollections(existing, incoming) {
+      var reconciled = cloneDeep(incoming);
+      var existingRecord = existing;
+      var incomingRecord = incoming;
+      var uidRemaps = [];
+      for (var _i = 0, _ORDER_AUTHORITATIVE_ = ORDER_AUTHORITATIVE_COLLECTION_FIELDS; _i < _ORDER_AUTHORITATIVE_.length; _i++) {
+        var field = _ORDER_AUTHORITATIVE_[_i];
+        if (!Array.isArray(incomingRecord[field])) continue;
+        reconciled[field] = this.mergeAuthoritativeOrderCollection(field, existingRecord[field], incomingRecord[field], uidRemaps);
+      }
+      return this.normalizeOrderCollectionsForIngress(applyOrderCollectionUidRemaps(reconciled, uidRemaps), 'overwriteExistingOrder.reconciled');
+    }
+
+    /**
+     * 记录订单最近一次 SQLite 写入，供 pubsub 回声去重使用。
+     *
+     * @example
+     * this.recordRecentSqliteWrite('upsertOrdersFromRemote', orders)
+     */
+  }, {
+    key: "recordRecentSqliteWrite",
+    value: function recordRecentSqliteWrite(source, orders) {
+      var now = Date.now();
+      var _iterator2 = _createForOfIteratorHelper(orders),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var order = _step2.value;
+          var storageKey = this.getOrderStorageKey(order);
+          if (!storageKey) continue;
+          this.recentSqliteWriteByStorageKey.set(storageKey, {
+            source: source,
+            ts: now
+          });
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+    }
+
+    /**
+     * 过滤 pubsub 触发的冗余 SQLite patch（业务 API 刚写入过的 update 回声）。
+     *
+     * @example
+     * const { toWrite, skipped } = this.filterRedundantPatchOrders('pubsub.bodyUpsert', orders, mergeActions)
+     */
+  }, {
+    key: "filterRedundantPatchOrders",
+    value: function filterRedundantPatchOrders(source, orders, mergeActions) {
+      var eligibleSkipSources = new Set(['pubsub.bodyUpsert', 'pubsub.httpRefresh']);
+      if (!eligibleSkipSources.has(source)) {
+        return {
+          toWrite: orders,
+          skipped: []
+        };
+      }
+      var now = Date.now();
+      var toWrite = [];
+      var skipped = [];
+      var _iterator3 = _createForOfIteratorHelper(orders),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var order = _step3.value;
+          var storageKey = this.getOrderStorageKey(order);
+          if (!storageKey) {
+            toWrite.push(order);
+            continue;
+          }
+          var orderKey = order.order_id !== undefined && order.order_id !== null ? this.getIdKey(order.order_id) : '';
+          var mergeAction = orderKey ? mergeActions[orderKey] : undefined;
+
+          // 新增单必须落库，不参与去重
+          if (mergeAction === 'insert') {
+            toWrite.push(order);
+            continue;
+          }
+          var recent = this.recentSqliteWriteByStorageKey.get(storageKey);
+          if (recent && ORDER_BUSINESS_WRITE_SOURCES.has(recent.source) && now - recent.ts < ORDER_SQLITE_DEDUPE_MS) {
+            var _order$order_id2;
+            skipped.push({
+              orderId: (_order$order_id2 = order.order_id) !== null && _order$order_id2 !== void 0 ? _order$order_id2 : null,
+              storageKey: storageKey,
+              reason: 'skip_pubsub_echo_after_business_write',
+              lastSource: recent.source,
+              elapsedMs: now - recent.ts
+            });
+            continue;
+          }
+          toWrite.push(order);
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+      return {
+        toWrite: toWrite,
+        skipped: skipped
+      };
+    }
+
+    /**
+     * 过滤 pubsub HTTP 增量拉取 ids：本地刚由业务 API 写入的单可跳过 HTTP。
+     *
+     * @example
+     * const ids = this.filterRedundantHttpRefreshIds([99331, 99332])
+     */
+  }, {
+    key: "filterRedundantHttpRefreshIds",
+    value: function filterRedundantHttpRefreshIds(ids) {
+      var now = Date.now();
+      var toFetch = [];
+      var skipped = [];
+      var _iterator4 = _createForOfIteratorHelper(ids),
+        _step4;
+      try {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var id = _step4.value;
+          var existing = this.getOrderByOrderId(id);
+          if (!existing) {
+            toFetch.push(id);
+            continue;
+          }
+          var storageKey = this.getOrderStorageKey(existing);
+          var recent = storageKey ? this.recentSqliteWriteByStorageKey.get(storageKey) : undefined;
+          if (recent && recent.source === 'upsertOrdersFromRemote' && now - recent.ts < ORDER_SQLITE_DEDUPE_MS) {
+            skipped.push({
+              orderId: id,
+              lastSource: recent.source,
+              elapsedMs: now - recent.ts
+            });
+            continue;
+          }
+          toFetch.push(id);
+        }
+      } catch (err) {
+        _iterator4.e(err);
+      } finally {
+        _iterator4.f();
+      }
+      return {
+        toFetch: toFetch,
+        skipped: skipped
+      };
+    }
+
+    /**
+     * 解析 pubsub 消息会走哪条同步分支，便于对照为何触发 HTTP 重拉或 body 直写。
+     *
+     * @example
+     * this.resolveSyncMessageRoute(msg)
+     * // => { route: 'httpRefresh.batchIds', ... }
+     */
+  }, {
+    key: "resolveSyncMessageRoute",
+    value: function resolveSyncMessageRoute(msg) {
+      var _msg$id, _msg$relation_order_i, _normalizedBody$order5;
+      var hasBatchIds = Array.isArray(msg.ids) && msg.ids.length > 0;
+      var singleIdRaw = (_msg$id = msg.id) !== null && _msg$id !== void 0 ? _msg$id : msg.order_id;
+      var hasSingleId = !hasBatchIds && singleIdRaw !== undefined && singleIdRaw !== null;
+      var normalizedBody = this.normalizeOrderSyncPayload(msg.body || msg.data);
+      if (hasBatchIds) {
+        var _normalizedBody$order;
+        return {
+          route: 'httpRefresh.batchIds',
+          hasBatchIds: true,
+          hasSingleId: false,
+          hasNormalizedBody: !!normalizedBody,
+          singleId: null,
+          batchIds: msg.ids || [],
+          bodyOrderId: (_normalizedBody$order = normalizedBody === null || normalizedBody === void 0 ? void 0 : normalizedBody.order_id) !== null && _normalizedBody$order !== void 0 ? _normalizedBody$order : null
+        };
+      }
+      if (hasSingleId && normalizedBody) {
+        var _normalizedBody$order2;
+        return {
+          route: 'bodyUpsert',
+          hasBatchIds: false,
+          hasSingleId: true,
+          hasNormalizedBody: true,
+          singleId: singleIdRaw,
+          batchIds: [],
+          bodyOrderId: (_normalizedBody$order2 = normalizedBody.order_id) !== null && _normalizedBody$order2 !== void 0 ? _normalizedBody$order2 : null
+        };
+      }
+      if (hasSingleId) {
+        var _normalizedBody$order3;
+        return {
+          route: 'httpRefresh.singleId',
+          hasBatchIds: false,
+          hasSingleId: true,
+          hasNormalizedBody: !!normalizedBody,
+          singleId: singleIdRaw,
+          batchIds: [],
+          bodyOrderId: (_normalizedBody$order3 = normalizedBody === null || normalizedBody === void 0 ? void 0 : normalizedBody.order_id) !== null && _normalizedBody$order3 !== void 0 ? _normalizedBody$order3 : null
+        };
+      }
+      if ((_msg$relation_order_i = msg.relation_order_ids) !== null && _msg$relation_order_i !== void 0 && _msg$relation_order_i.length) {
+        var _normalizedBody$order4;
+        return {
+          route: 'httpRefresh.relationIds',
+          hasBatchIds: false,
+          hasSingleId: false,
+          hasNormalizedBody: !!normalizedBody,
+          singleId: null,
+          batchIds: msg.relation_order_ids,
+          bodyOrderId: (_normalizedBody$order4 = normalizedBody === null || normalizedBody === void 0 ? void 0 : normalizedBody.order_id) !== null && _normalizedBody$order4 !== void 0 ? _normalizedBody$order4 : null
+        };
+      }
+      return {
+        route: 'noop',
+        hasBatchIds: false,
+        hasSingleId: false,
+        hasNormalizedBody: !!normalizedBody,
+        singleId: null,
+        batchIds: [],
+        bodyOrderId: (_normalizedBody$order5 = normalizedBody === null || normalizedBody === void 0 ? void 0 : normalizedBody.order_id) !== null && _normalizedBody$order5 !== void 0 ? _normalizedBody$order5 : null
+      };
+    }
+  }, {
+    key: "updateCreateStore",
+    value: function updateCreateStore() {
+      var appPlugin = this.core.getPlugin('app');
+      var app = appPlugin === null || appPlugin === void 0 ? void 0 : appPlugin.getApp();
+      if (app) {
+        var coreData = app.data.store.getStore().getDataByModel('core');
+        if (coreData !== null && coreData !== void 0 && coreData.core) {
+          var today = dayjs();
+          if (coreData !== null && coreData !== void 0 && coreData.core.operating_day_boundary) {
+            var operatingDayBoundary = coreData.core.operating_day_boundary;
+            if (operatingDayBoundary.type === 'start_time') {
+              var boundaryTime = String(operatingDayBoundary.time || '').trim();
+              var boundaryStart = dayjs("".concat(today.format('YYYY-MM-DD'), " ").concat(boundaryTime));
+              if (boundaryStart.isValid()) {
+                var isAfterBoundary = today.isAfter(boundaryStart);
+                var queryStart = isAfterBoundary ? today.startOf('day') : today.subtract(1, 'day').startOf('day');
+                var queryEnd = isAfterBoundary ? today.add(1, 'day').endOf('day') : today.endOf('day');
+                this.store.createdAtQuery = {
+                  sales_time_between: [queryStart.format('YYYY-MM-DD HH:mm:ss'), queryEnd.format('YYYY-MM-DD HH:mm:ss')]
+                };
+              } else {
+                // 边界时间异常时回退到自然日，避免 createdAtQuery 为空导致后续查询异常
+                this.store.createdAtQuery = {
+                  sales_time_between: [today.startOf('day').format('YYYY-MM-DD HH:mm:ss'), today.endOf('day').format('YYYY-MM-DD HH:mm:ss')]
+                };
+              }
+            } else {
+              this.store.createdAtQuery = {
+                sales_time_between: [today.startOf('day').format('YYYY-MM-DD HH:mm:ss'), today.endOf('day').format('YYYY-MM-DD HH:mm:ss')]
+              };
+            }
+          } else {
+            // TODO: 这里后续可能需要使用店铺营业时间查询
+            this.store.createdAtQuery = {
+              sales_time_between: [today.startOf('day').format('YYYY-MM-DD HH:mm:ss'), today.endOf('day').format('YYYY-MM-DD HH:mm:ss')]
+            };
+          }
+        }
+      }
+    }
+  }, {
+    key: "getOrderSyncThrottleMs",
+    value: function getOrderSyncThrottleMs() {
+      var raw = localStorage.getItem(ORDER_SYNC_THROTTLE_MS_STORAGE_KEY);
+      if (raw !== null) {
+        var parsed = Number(raw);
+        if (Number.isFinite(parsed) && parsed >= 0) return parsed;
+      }
+      return DEFAULT_ORDER_SYNC_THROTTLE_MS;
+    }
   }, {
     key: "preload",
     value: function () {
-      var _preload = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
-        var orders;
-        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
-          while (1) switch (_context2.prev = _context2.next) {
+      var _preload = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+        var _this4 = this;
+        var getData;
+        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
             case 0:
-              _context2.next = 2;
-              return this.loadOrdersByServer();
+              // const hasPulledInCurrentWindow = this.hasPulledOrdersToday()
+              // // 仅当缓存属于当前统计窗口时才直接复用，避免跨天/跨营业日窗口继续使用旧数据
+              // if (cachedOrders.length > 0 && hasPulledInCurrentWindow) {
+              //   this.store.list = cloneDeep(cachedOrders)
+              //   this.syncOrdersMap()
+              //   this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list)
+              //   return
+              // }
+              // if (hasPulledInCurrentWindow) {
+              //   this.logInfo('当天已完成全量订单拉取，跳过本次全量拉取', {
+              //     lastFullFetchAt: this.getStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY),
+              //   })
+              //   return
+              // }
+              getData = /*#__PURE__*/function () {
+                var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
+                  var orders;
+                  return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+                    while (1) switch (_context3.prev = _context3.next) {
+                      case 0:
+                        _context3.next = 2;
+                        return _this4.loadOrdersByServer();
+                      case 2:
+                        orders = _context3.sent;
+                        if (!(orders.length === 0)) {
+                          _context3.next = 5;
+                          break;
+                        }
+                        return _context3.abrupt("return");
+                      case 5:
+                        _this4.store.list = cloneDeep(orders);
+                        _this4.syncOrdersMap();
+                        _this4.emitOrdersChanged([], 'preload');
+                        _this4.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
+                      case 9:
+                      case "end":
+                        return _context3.stop();
+                    }
+                  }, _callee3);
+                }));
+                return function getData() {
+                  return _ref.apply(this, arguments);
+                };
+              }();
+              getData();
             case 2:
-              orders = _context2.sent;
-              if (!(orders.length === 0)) {
-                _context2.next = 5;
-                break;
-              }
-              return _context2.abrupt("return");
-            case 5:
-              this.store.list = cloneDeep(orders);
-              this.syncOrdersMap();
-              this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
-            case 8:
             case "end":
-              return _context2.stop();
+              return _context4.stop();
           }
-        }, _callee2, this);
+        }, _callee4);
       }));
       function preload() {
         return _preload.apply(this, arguments);
@@ -222,72 +673,620 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return this.store.map.get(this.getIdKey(id));
     }
 
-    /** 按 order_id 查询（推荐） */
+    /** 按 order_id 查询内存订单。 */
   }, {
     key: "getOrderByOrderId",
     value: function getOrderByOrderId(orderId) {
       return this.store.map.get(this.getIdKey(orderId));
     }
+  }, {
+    key: "getLocalOrderFromMemoryByLookup",
+    value: function getLocalOrderFromMemoryByLookup(lookup) {
+      var _this5 = this;
+      var key = this.getIdKey(lookup);
+      var memoryOrderById = this.store.map.get(key);
+      if (memoryOrderById) return memoryOrderById;
+      var memoryOrder = this.store.list.find(function (order) {
+        return _this5.isOrderLookupMatch(order, key);
+      });
+      return memoryOrder || null;
+    }
+  }, {
+    key: "getLocalOrderByLookup",
+    value: function () {
+      var _getLocalOrderByLookup = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(lookup) {
+        var _this6 = this;
+        var key, memoryOrderById, memoryOrder, orders, localOrder;
+        return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+          while (1) switch (_context5.prev = _context5.next) {
+            case 0:
+              key = this.getIdKey(lookup);
+              memoryOrderById = this.store.map.get(key);
+              if (!memoryOrderById) {
+                _context5.next = 4;
+                break;
+              }
+              return _context5.abrupt("return", memoryOrderById);
+            case 4:
+              memoryOrder = this.store.list.find(function (order) {
+                return _this6.isOrderLookupMatch(order, key);
+              });
+              if (!memoryOrder) {
+                _context5.next = 7;
+                break;
+              }
+              return _context5.abrupt("return", memoryOrder);
+            case 7:
+              _context5.next = 9;
+              return this.loadOrdersFromSQLite();
+            case 9:
+              orders = _context5.sent;
+              localOrder = orders.find(function (order) {
+                return _this6.isOrderLookupMatch(order, key);
+              });
+              if (localOrder) {
+                _context5.next = 13;
+                break;
+              }
+              return _context5.abrupt("return", null);
+            case 13:
+              this.store.list = orders.map(function (order) {
+                return _this6.normalizeOrderForMemoryList(order);
+              });
+              this.syncOrdersMap();
+              return _context5.abrupt("return", this.normalizeOrderForMemoryList(localOrder));
+            case 16:
+            case "end":
+              return _context5.stop();
+          }
+        }, _callee5, this);
+      }));
+      function getLocalOrderByLookup(_x3) {
+        return _getLocalOrderByLookup.apply(this, arguments);
+      }
+      return getLocalOrderByLookup;
+    }()
   }, {
     key: "loadOrdersByServer",
     value: function () {
-      var _loadOrdersByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
-        var orderList, data;
-        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
-          while (1) switch (_context3.prev = _context3.next) {
+      var _loadOrdersByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
+        var _this$store,
+          _this7 = this;
+        var orderList, data, mergedOrders, memoryOrders;
+        return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+          while (1) switch (_context6.prev = _context6.next) {
             case 0:
               orderList = [];
+              this.logInfo('loadOrdersByServer-开始', {
+                hasOrderDataSource: !!this.orderDataSource,
+                query: ((_this$store = this.store) === null || _this$store === void 0 ? void 0 : _this$store.createdAtQuery) || null
+              });
               if (!this.orderDataSource) {
-                _context3.next = 13;
+                _context6.next = 17;
                 break;
               }
-              _context3.prev = 2;
-              _context3.next = 5;
+              _context6.prev = 3;
+              _context6.next = 6;
               return this.orderDataSource.run({
-                http: {
+                sse: {
                   query: this.store.createdAtQuery
                 }
               });
-            case 5:
-              data = _context3.sent;
+            case 6:
+              data = _context6.sent;
               orderList = data || [];
+              this.logInfo('loadOrdersByServer-SSE拉取成功', {
+                count: orderList.length
+              });
               this.markOrderPulledAtNow();
-              _context3.next = 13;
+              this.lastServerFullFetchAtMs = Date.now();
+              _context6.next = 17;
               break;
-            case 10:
-              _context3.prev = 10;
-              _context3.t0 = _context3["catch"](2);
-              orderList = [];
             case 13:
-              _context3.next = 15;
-              return this.saveOrdersToSQLite(orderList);
-            case 15:
-              _context3.next = 17;
-              return this.core.effects.emit(OrderHooks.onOrdersLoaded, orderList);
+              _context6.prev = 13;
+              _context6.t0 = _context6["catch"](3);
+              this.logInfo('loadOrdersByServer-SSE拉取失败，保持当前内存订单');
+              return _context6.abrupt("return", this.store.list);
             case 17:
-              return _context3.abrupt("return", orderList);
-            case 18:
+              _context6.next = 19;
+              return this.replaceOrdersSnapshotInSQLite(orderList, 'loadOrdersByServer');
+            case 19:
+              mergedOrders = _context6.sent;
+              memoryOrders = mergedOrders.map(function (order) {
+                return _this7.normalizeOrderForMemoryList(order);
+              });
+              this.logInfo('loadOrdersByServer-结束', {
+                count: memoryOrders.length
+              });
+              _context6.next = 24;
+              return this.core.effects.emit(OrderHooks.onOrdersLoaded, memoryOrders);
+            case 24:
+              return _context6.abrupt("return", memoryOrders);
+            case 25:
             case "end":
-              return _context3.stop();
+              return _context6.stop();
           }
-        }, _callee3, this, [[2, 10]]);
+        }, _callee6, this, [[3, 13]]);
       }));
       function loadOrdersByServer() {
         return _loadOrdersByServer.apply(this, arguments);
       }
       return loadOrdersByServer;
     }()
+    /**
+     * 静默全量刷新：后台重新拉取全量 SSE 订单数据并更新本地
+     * 拿到完整数据后一次性替换 store，触发订单变更与同步完成事件
+     * @returns 刷新后的订单列表
+     */
+  }, {
+    key: "silentRefresh",
+    value: (function () {
+      var _silentRefresh = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7() {
+        var startTime, elapsedSinceFullFetch, orders, errorMessage;
+        return _regeneratorRuntime().wrap(function _callee7$(_context7) {
+          while (1) switch (_context7.prev = _context7.next) {
+            case 0:
+              startTime = Date.now();
+              elapsedSinceFullFetch = Date.now() - this.lastServerFullFetchAtMs;
+              if (!(this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < ORDER_SILENT_REFRESH_MIN_INTERVAL_MS)) {
+                _context7.next = 4;
+                break;
+              }
+              return _context7.abrupt("return", this.store.list);
+            case 4:
+              this.logInfo('silentRefresh 开始');
+              _context7.prev = 5;
+              // 刷新前，需要更新当前营业日边界（store.createdAtQuery）
+              this.updateCreateStore();
+              _context7.next = 9;
+              return this.loadOrdersByServer();
+            case 9:
+              orders = _context7.sent;
+              if (!(orders.length > 0)) {
+                _context7.next = 19;
+                break;
+              }
+              this.store.list = cloneDeep(orders);
+              this.syncOrdersMap();
+              this.emitOrdersChanged([], 'silentRefresh');
+              _context7.next = 16;
+              return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
+            case 16:
+              this.logInfo('silentRefresh 完成', {
+                orderCount: orders.length,
+                duration: "".concat(Date.now() - startTime, "ms")
+              });
+              _context7.next = 20;
+              break;
+            case 19:
+              this.logInfo('silentRefresh: 服务器未返回数据');
+            case 20:
+              return _context7.abrupt("return", this.store.list);
+            case 23:
+              _context7.prev = 23;
+              _context7.t0 = _context7["catch"](5);
+              errorMessage = _context7.t0 instanceof Error ? _context7.t0.message : String(_context7.t0);
+              this.logError('silentRefresh 失败', {
+                duration: "".concat(Date.now() - startTime, "ms"),
+                error: errorMessage
+              });
+              return _context7.abrupt("return", this.store.list);
+            case 28:
+            case "end":
+              return _context7.stop();
+          }
+        }, _callee7, this, [[5, 23]]);
+      }));
+      function silentRefresh() {
+        return _silentRefresh.apply(this, arguments);
+      }
+      return silentRefresh;
+    }())
   }, {
-    key: "getOrdersByResourceId",
-    value: function getOrdersByResourceId(resourceId) {
-      var _this2 = this;
-      var ids = this.resourceIdIndex.get(String(resourceId)) || [];
-      return ids.map(function (id) {
-        return _this2.store.map.get(id);
-      }).filter(function (order) {
-        return !!order;
+    key: "normalizeOrderForMemoryList",
+    value: function normalizeOrderForMemoryList(order) {
+      var source = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'normalizeOrderForMemoryList';
+      var normalizedOrder = this.normalizeOrderCollectionsForIngress(order, source);
+      var externalSaleNumber = normalizedOrder === null || normalizedOrder === void 0 ? void 0 : normalizedOrder.external_sale_number;
+      if ((normalizedOrder === null || normalizedOrder === void 0 ? void 0 : normalizedOrder.order_id) !== undefined && (normalizedOrder === null || normalizedOrder === void 0 ? void 0 : normalizedOrder.order_id) !== null && (normalizedOrder === null || normalizedOrder === void 0 ? void 0 : normalizedOrder.order_id) !== '') {
+        return normalizedOrder;
+      }
+      if (externalSaleNumber === undefined || externalSaleNumber === null || externalSaleNumber === '') {
+        return normalizedOrder;
+      }
+      return _objectSpread(_objectSpread({}, normalizedOrder), {}, {
+        order_id: externalSaleNumber
       });
     }
+
+    /**
+     * 仅覆盖本地已存在的订单；不存在则直接跳过，不落库、不 emit。
+     * 适用于"按 order_id 主动刷新本地订单详情"的代理场景。
+     */
+  }, {
+    key: "overwriteExistingOrder",
+    value: (function () {
+      var _overwriteExistingOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8(fresh) {
+        var _this8 = this;
+        var orderId, key, normalizedFresh, existingOrder, reconciledFresh;
+        return _regeneratorRuntime().wrap(function _callee8$(_context8) {
+          while (1) switch (_context8.prev = _context8.next) {
+            case 0:
+              orderId = fresh === null || fresh === void 0 ? void 0 : fresh.order_id;
+              if (!(orderId === undefined || orderId === null)) {
+                _context8.next = 4;
+                break;
+              }
+              this.logError('overwriteExistingOrder-入参缺少 order_id');
+              return _context8.abrupt("return", {
+                overwritten: false
+              });
+            case 4:
+              key = this.getIdKey(orderId);
+              if (this.store.map.has(key)) {
+                _context8.next = 8;
+                break;
+              }
+              this.logInfo('overwriteExistingOrder-本地不存在该订单，跳过', {
+                orderId: orderId
+              });
+              return _context8.abrupt("return", {
+                overwritten: false
+              });
+            case 8:
+              this.logInfo('overwriteExistingOrder-开始覆盖', {
+                orderId: orderId,
+                storeOrderCountBefore: this.store.list.length
+              });
+              normalizedFresh = this.normalizeOrderForMemoryList(fresh, 'overwriteExistingOrder.incoming');
+              existingOrder = this.store.map.get(key);
+              reconciledFresh = this.reconcileOverwriteOrderCollections(existingOrder, normalizedFresh);
+              this.store.list = this.store.list.map(function (order) {
+                var id = order === null || order === void 0 ? void 0 : order.order_id;
+                if (id === undefined || id === null) {
+                  return _this8.normalizeOrderForMemoryList(order, 'overwriteExistingOrder.existingMemory');
+                }
+                return _this8.getIdKey(id) === key ? reconciledFresh : _this8.normalizeOrderForMemoryList(order, 'overwriteExistingOrder.existingMemory');
+              });
+              this.syncOrdersMap();
+              _context8.next = 16;
+              return this.updateOrderInSQLite(reconciledFresh, 'overwriteExistingOrder');
+            case 16:
+              this.logInfo('overwriteExistingOrder-结束', {
+                orderId: orderId,
+                storeOrderCountAfter: this.store.list.length
+              });
+              _context8.next = 19;
+              return this.emitOrdersChanged([reconciledFresh], 'overwriteExistingOrder');
+            case 19:
+              return _context8.abrupt("return", {
+                overwritten: true
+              });
+            case 20:
+            case "end":
+              return _context8.stop();
+          }
+        }, _callee8, this);
+      }));
+      function overwriteExistingOrder(_x4) {
+        return _overwriteExistingOrder.apply(this, arguments);
+      }
+      return overwriteExistingOrder;
+    }()
+    /**
+     * 将远端拉取的订单合并进本地 store（已存在则更新，不存在则追加），落库并 emit onOrdersChanged。
+     * 供 /update/localOrder 等在「本地尚无该单」时写入新建单。
+     */
+    )
+  }, {
+    key: "upsertOrdersFromRemote",
+    value: (function () {
+      var _upsertOrdersFromRemote = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9(freshOrders) {
+        return _regeneratorRuntime().wrap(function _callee9$(_context9) {
+          while (1) switch (_context9.prev = _context9.next) {
+            case 0:
+              if (freshOrders !== null && freshOrders !== void 0 && freshOrders.length) {
+                _context9.next = 3;
+                break;
+              }
+              this.logInfo('upsertOrdersFromRemote-订单列表为空', {});
+              return _context9.abrupt("return");
+            case 3:
+              this.logInfo('upsertOrdersFromRemote-开始', {
+                count: freshOrders.length
+              });
+              _context9.next = 6;
+              return this.mergeOrdersToStore(freshOrders, 'upsertOrdersFromRemote');
+            case 6:
+            case "end":
+              return _context9.stop();
+          }
+        }, _callee9, this);
+      }));
+      function upsertOrdersFromRemote(_x5) {
+        return _upsertOrdersFromRemote.apply(this, arguments);
+      }
+      return upsertOrdersFromRemote;
+    }())
+  }, {
+    key: "markOrderSyncedByExternalSaleNumber",
+    value: function () {
+      var _markOrderSyncedByExternalSaleNumber = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10(params) {
+        var _this9 = this,
+          _existing$external_sa,
+          _nextOrder$order_id;
+        var externalSaleNumber, key, targetIndex, existing, nextOrder, storageKey;
+        return _regeneratorRuntime().wrap(function _callee10$(_context10) {
+          while (1) switch (_context10.prev = _context10.next) {
+            case 0:
+              externalSaleNumber = params.externalSaleNumber;
+              if (!(externalSaleNumber === undefined || externalSaleNumber === null || externalSaleNumber === '')) {
+                _context10.next = 4;
+                break;
+              }
+              this.logError('markOrderSyncedByExternalSaleNumber-缺少 external_sale_number');
+              return _context10.abrupt("return", {
+                updated: false
+              });
+            case 4:
+              key = this.getIdKey(externalSaleNumber);
+              targetIndex = this.store.list.findIndex(function (order) {
+                var value = order === null || order === void 0 ? void 0 : order.external_sale_number;
+                if (value === undefined || value === null || value === '') return false;
+                return _this9.getIdKey(value) === key;
+              });
+              if (!(targetIndex < 0)) {
+                _context10.next = 9;
+                break;
+              }
+              this.logInfo('markOrderSyncedByExternalSaleNumber-本地订单不存在，跳过', {
+                external_sale_number: externalSaleNumber
+              });
+              return _context10.abrupt("return", {
+                updated: false
+              });
+            case 9:
+              existing = this.store.list[targetIndex];
+              nextOrder = this.normalizeRemoteSyncedOrder(_objectSpread(_objectSpread(_objectSpread({}, existing), params.patch || {}), {}, {
+                external_sale_number: (_existing$external_sa = existing.external_sale_number) !== null && _existing$external_sa !== void 0 ? _existing$external_sa : externalSaleNumber,
+                need_sync: 0
+              }));
+              storageKey = this.getOrderStorageKey(nextOrder) || key;
+              this.store.list = this.store.list.map(function (order, index) {
+                if (index !== targetIndex) return order;
+                return nextOrder;
+              });
+              this.syncOrdersMap();
+              _context10.next = 16;
+              return this.patchOrdersInSQLite([nextOrder], 'markOrderSyncedByExternalSaleNumber', _defineProperty({}, storageKey, 'update'));
+            case 16:
+              this.logInfo('markOrderSyncedByExternalSaleNumber-完成', {
+                external_sale_number: externalSaleNumber,
+                order_id: (_nextOrder$order_id = nextOrder.order_id) !== null && _nextOrder$order_id !== void 0 ? _nextOrder$order_id : null
+              });
+              _context10.next = 19;
+              return this.emitOrdersChanged([nextOrder], 'markOrderSyncedByExternalSaleNumber');
+            case 19:
+              return _context10.abrupt("return", {
+                updated: true,
+                order: nextOrder
+              });
+            case 20:
+            case "end":
+              return _context10.stop();
+          }
+        }, _callee10, this);
+      }));
+      function markOrderSyncedByExternalSaleNumber(_x6) {
+        return _markOrderSyncedByExternalSaleNumber.apply(this, arguments);
+      }
+      return markOrderSyncedByExternalSaleNumber;
+    }()
+    /**
+     * 将本地待同步订单按 SQLite storage key 合并进 store 并落库。
+     * checkout 离线兜底可能没有 order_id，但通常会有 external_sale_number。
+     */
+  }, {
+    key: "upsertPendingSyncOrders",
+    value: (function () {
+      var _upsertPendingSyncOrders = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11(pendingOrders) {
+        var _this10 = this;
+        var pendingMap, memoryPendingMap, _iterator5, _step5, order, normalizedOrder, storageKey, mergeActions, updatedList, identityKeyToIndex, index, _iterator6, _step6, key, _iterator7, _step7, _step7$value, _storageKey, pendingOrder, matchIndex, existingOrder, mergedOrder, pendingSnapshot, insertIndex, patchedOrders;
+        return _regeneratorRuntime().wrap(function _callee11$(_context11) {
+          while (1) switch (_context11.prev = _context11.next) {
+            case 0:
+              if (pendingOrders !== null && pendingOrders !== void 0 && pendingOrders.length) {
+                _context11.next = 3;
+                break;
+              }
+              this.logInfo('upsertPendingSyncOrders-订单列表为空', {});
+              return _context11.abrupt("return");
+            case 3:
+              pendingMap = new Map();
+              memoryPendingMap = new Map();
+              _iterator5 = _createForOfIteratorHelper(pendingOrders);
+              _context11.prev = 6;
+              _iterator5.s();
+            case 8:
+              if ((_step5 = _iterator5.n()).done) {
+                _context11.next = 18;
+                break;
+              }
+              order = _step5.value;
+              normalizedOrder = this.normalizeOrderCollectionsForIngress(order, 'upsertPendingSyncOrders.incoming');
+              storageKey = this.getOrderStorageKey(normalizedOrder);
+              if (storageKey) {
+                _context11.next = 14;
+                break;
+              }
+              return _context11.abrupt("continue", 16);
+            case 14:
+              pendingMap.set(storageKey, normalizedOrder);
+              memoryPendingMap.set(storageKey, this.normalizeOrderForMemoryList(normalizedOrder, 'upsertPendingSyncOrders.memory'));
+            case 16:
+              _context11.next = 8;
+              break;
+            case 18:
+              _context11.next = 23;
+              break;
+            case 20:
+              _context11.prev = 20;
+              _context11.t0 = _context11["catch"](6);
+              _iterator5.e(_context11.t0);
+            case 23:
+              _context11.prev = 23;
+              _iterator5.f();
+              return _context11.finish(23);
+            case 26:
+              if (!(pendingMap.size === 0)) {
+                _context11.next = 29;
+                break;
+              }
+              this.logError('upsertPendingSyncOrders-订单缺少可落库标识', {
+                count: pendingOrders.length
+              });
+              return _context11.abrupt("return");
+            case 29:
+              this.logInfo('upsertPendingSyncOrders-开始', {
+                count: pendingMap.size
+              });
+              mergeActions = {};
+              updatedList = this.store.list.map(function (order) {
+                return _this10.normalizeOrderForMemoryList(order, 'upsertPendingSyncOrders.existingMemory');
+              }); // 与 mergeOrdersToStore 一致：基于身份键（field:value）建立索引，把「查找已存在订单」
+              // 从 O(n) 线性扫描降为 O(1)，整体复杂度由 O(n^2) 降为 O(n + m)。
+              identityKeyToIndex = new Map();
+              for (index = 0; index < updatedList.length; index += 1) {
+                _iterator6 = _createForOfIteratorHelper(this.getOrderIdentityMatchKeys(updatedList[index]));
+                try {
+                  for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
+                    key = _step6.value;
+                    // 同一 key 命中多张时保留最靠前的下标，与原 findIndex「取首个匹配」一致
+                    if (!identityKeyToIndex.has(key)) identityKeyToIndex.set(key, index);
+                  }
+                } catch (err) {
+                  _iterator6.e(err);
+                } finally {
+                  _iterator6.f();
+                }
+              }
+              _iterator7 = _createForOfIteratorHelper(memoryPendingMap.entries());
+              _context11.prev = 35;
+              _iterator7.s();
+            case 37:
+              if ((_step7 = _iterator7.n()).done) {
+                _context11.next = 55;
+                break;
+              }
+              _step7$value = _slicedToArray(_step7.value, 2), _storageKey = _step7$value[0], pendingOrder = _step7$value[1];
+              matchIndex = this.lookupOrderIndexByIdentityKeys(identityKeyToIndex, this.getOrderIdentityMatchKeys(pendingOrder));
+              if (!(matchIndex >= 0)) {
+                _context11.next = 49;
+                break;
+              }
+              existingOrder = updatedList[matchIndex];
+              mergedOrder = this.mergeOrderRecords(existingOrder, pendingOrder);
+              updatedList[matchIndex] = mergedOrder;
+              pendingSnapshot = pendingMap.get(_storageKey);
+              if (pendingSnapshot) {
+                pendingMap.set(_storageKey, this.reconcileOverwriteOrderCollections(existingOrder, pendingSnapshot));
+              }
+              // 合并后身份字段可能新增（如挂单拿到 order_id），同步登记，供同批后续 pending 命中同一槽位
+              this.registerOrderIdentityKeys(identityKeyToIndex, mergedOrder, matchIndex);
+              mergeActions[_storageKey] = 'update';
+              return _context11.abrupt("continue", 53);
+            case 49:
+              insertIndex = updatedList.length;
+              updatedList.push(pendingOrder);
+              this.registerOrderIdentityKeys(identityKeyToIndex, pendingOrder, insertIndex);
+              mergeActions[_storageKey] = 'insert';
+            case 53:
+              _context11.next = 37;
+              break;
+            case 55:
+              _context11.next = 60;
+              break;
+            case 57:
+              _context11.prev = 57;
+              _context11.t1 = _context11["catch"](35);
+              _iterator7.e(_context11.t1);
+            case 60:
+              _context11.prev = 60;
+              _iterator7.f();
+              return _context11.finish(60);
+            case 63:
+              patchedOrders = _toConsumableArray(pendingMap.values()); // 增量索引已保证 store 去重不变量，无需再对全表做 O(n^2) 压缩；仅自检开关开启时兜底。
+              this.store.list = this.runOrderStoreSelfCheck(updatedList, 'upsertPendingSyncOrders.store');
+              this.syncOrdersMap();
+              _context11.next = 68;
+              return this.patchOrdersInSQLite(patchedOrders, 'upsertPendingSyncOrders', mergeActions);
+            case 68:
+              this.logInfo('upsertPendingSyncOrders-结束', {
+                count: patchedOrders.length,
+                storeOrderCountAfter: this.store.list.length
+              });
+              _context11.next = 71;
+              return this.emitOrdersChanged(patchedOrders, 'upsertPendingSyncOrders');
+            case 71:
+            case "end":
+              return _context11.stop();
+          }
+        }, _callee11, this, [[6, 20, 23, 26], [35, 57, 60, 63]]);
+      }));
+      function upsertPendingSyncOrders(_x7) {
+        return _upsertPendingSyncOrders.apply(this, arguments);
+      }
+      return upsertPendingSyncOrders;
+    }()
+    /**
+     * 通过 SSE 按自定义 query 拉取订单（支持 select/with 精简字段）
+     */
+    )
+  }, {
+    key: "fetchOrdersBySSE",
+    value: (function () {
+      var _fetchOrdersBySSE = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee12() {
+        var query,
+          data,
+          _args12 = arguments;
+        return _regeneratorRuntime().wrap(function _callee12$(_context12) {
+          while (1) switch (_context12.prev = _context12.next) {
+            case 0:
+              query = _args12.length > 0 && _args12[0] !== undefined ? _args12[0] : {};
+              if (this.orderDataSource) {
+                _context12.next = 3;
+                break;
+              }
+              return _context12.abrupt("return", []);
+            case 3:
+              _context12.prev = 3;
+              _context12.next = 6;
+              return this.orderDataSource.run({
+                sse: {
+                  query: query
+                }
+              });
+            case 6:
+              data = _context12.sent;
+              return _context12.abrupt("return", data || []);
+            case 10:
+              _context12.prev = 10;
+              _context12.t0 = _context12["catch"](3);
+              this.logError('fetchOrdersBySSE-失败', {
+                error: _context12.t0 instanceof Error ? _context12.t0.message : String(_context12.t0)
+              });
+              return _context12.abrupt("return", []);
+            case 14:
+            case "end":
+              return _context12.stop();
+          }
+        }, _callee12, this, [[3, 10]]);
+      }));
+      function fetchOrdersBySSE() {
+        return _fetchOrdersBySSE.apply(this, arguments);
+      }
+      return fetchOrdersBySSE;
+    }())
   }, {
     key: "getRoutes",
     value: function getRoutes() {
@@ -301,6 +1300,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         clearTimeout(this.syncTimer);
         this.syncTimer = undefined;
       }
+      this.isProcessingSyncBatch = false;
       this.pendingSyncMessages = [];
       if ((_this$orderDataSource = this.orderDataSource) !== null && _this$orderDataSource !== void 0 && _this$orderDataSource.destroy) this.orderDataSource.destroy();
       _get(_getPrototypeOf(OrderModule.prototype), "destroy", this).call(this);
@@ -308,72 +1308,104 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "syncOrdersMap",
     value: function syncOrdersMap() {
-      var _this3 = this;
       this.store.map.clear();
-      this.resourceIdIndex.clear();
-      var _iterator = _createForOfIteratorHelper(this.store.list),
-        _step;
+      var _iterator8 = _createForOfIteratorHelper(this.store.list),
+        _step8;
       try {
-        var _loop = function _loop() {
-          var order = _step.value;
-          var id = order.order_id;
-          if (id === undefined || id === null) return 1; // continue
-          _this3.store.map.set(_this3.getIdKey(id), order);
-          var resourceIds = _this3.extractResourceIds(order);
-          var _iterator2 = _createForOfIteratorHelper(resourceIds),
-            _step2;
-          try {
-            for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-              var resourceId = _step2.value;
-              var key = String(resourceId);
-              var existing = _this3.resourceIdIndex.get(key) || [];
-              if (existing.some(function (eid) {
-                return _this3.getIdKey(eid) === _this3.getIdKey(id);
-              })) continue;
-              existing.push(id);
-              _this3.resourceIdIndex.set(key, existing);
-            }
-          } catch (err) {
-            _iterator2.e(err);
-          } finally {
-            _iterator2.f();
-          }
-        };
-        for (_iterator.s(); !(_step = _iterator.n()).done;) {
-          if (_loop()) continue;
+        for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
+          var order = _step8.value;
+          var primaryIdentity = this.getOrderMapKey(order);
+          if (!primaryIdentity) continue;
+          this.store.map.set(primaryIdentity, order);
         }
       } catch (err) {
-        _iterator.e(err);
+        _iterator8.e(err);
       } finally {
-        _iterator.f();
+        _iterator8.f();
       }
     }
   }, {
-    key: "extractResourceIds",
-    value: function extractResourceIds(order) {
-      var ids = new Set();
-      var visitResources = function visitResources(resources) {
-        if (!Array.isArray(resources)) return;
-        resources.forEach(function (resource) {
-          var rid = resource === null || resource === void 0 ? void 0 : resource.relation_id;
-          if (rid !== undefined && rid !== null && rid !== '') ids.add(String(rid));
-          if (Array.isArray(resource === null || resource === void 0 ? void 0 : resource.children)) visitResources(resource.children);
-        });
-      };
-      if (Array.isArray(order === null || order === void 0 ? void 0 : order.bookings)) {
-        order.bookings.forEach(function (booking) {
-          return visitResources((booking === null || booking === void 0 ? void 0 : booking.resources) || []);
-        });
+    key: "getOrderMapKey",
+    value: function getOrderMapKey(order) {
+      if (!order) return '';
+      if (!this.isBlankIdentityValue(order.order_id)) {
+        return this.getIdKey(order.order_id);
       }
-      return _toConsumableArray(ids);
+      var externalSaleNumber = order.external_sale_number;
+      if (!this.isBlankIdentityValue(externalSaleNumber)) {
+        return this.getIdKey(externalSaleNumber);
+      }
+      return '';
+    }
+  }, {
+    key: "isBlankIdentityValue",
+    value: function isBlankIdentityValue(value) {
+      return value === undefined || value === null || value === '';
+    }
+  }, {
+    key: "getOrderIdentityEntries",
+    value: function getOrderIdentityEntries(order) {
+      var _this11 = this;
+      if (!order) return [];
+      var record = order;
+      var candidates = [{
+        field: 'order_id',
+        value: order.order_id
+      }, {
+        field: 'external_sale_number',
+        value: record.external_sale_number
+      }, {
+        field: 'order_number',
+        value: record.order_number
+      }, {
+        field: 'shop_order_number',
+        value: record.shop_order_number
+      }];
+      var entries = [];
+      var _loop = function _loop() {
+          var candidate = _candidates[_i2];
+          if (_this11.isBlankIdentityValue(candidate.value)) return 0; // continue
+          var key = _this11.getIdKey(candidate.value);
+          if (entries.some(function (entry) {
+            return entry.field === candidate.field && entry.key === key;
+          })) return 0; // continue
+          entries.push({
+            field: candidate.field,
+            key: key
+          });
+        },
+        _ret;
+      for (var _i2 = 0, _candidates = candidates; _i2 < _candidates.length; _i2++) {
+        _ret = _loop();
+        if (_ret === 0) continue;
+      }
+      return entries;
+    }
+  }, {
+    key: "getOrderIdentityKeys",
+    value: function getOrderIdentityKeys(order) {
+      var keys = [];
+      var _iterator9 = _createForOfIteratorHelper(this.getOrderIdentityEntries(order)),
+        _step9;
+      try {
+        for (_iterator9.s(); !(_step9 = _iterator9.n()).done;) {
+          var entry = _step9.value;
+          if (!keys.includes(entry.key)) keys.push(entry.key);
+        }
+      } catch (err) {
+        _iterator9.e(err);
+      } finally {
+        _iterator9.f();
+      }
+      return keys;
     }
   }, {
     key: "getOrderDateKey",
     value: function getOrderDateKey(order) {
       var _order$bookings, _order$bookings2;
       var candidates = [order === null || order === void 0 ? void 0 : order.schedule_date, order === null || order === void 0 ? void 0 : order.create_date, order === null || order === void 0 ? void 0 : order.created_at, order === null || order === void 0 || (_order$bookings = order.bookings) === null || _order$bookings === void 0 || (_order$bookings = _order$bookings[0]) === null || _order$bookings === void 0 ? void 0 : _order$bookings.start_date, order === null || order === void 0 || (_order$bookings2 = order.bookings) === null || _order$bookings2 === void 0 || (_order$bookings2 = _order$bookings2[0]) === null || _order$bookings2 === void 0 ? void 0 : _order$bookings2.select_date];
-      for (var _i = 0, _candidates = candidates; _i < _candidates.length; _i++) {
-        var v = _candidates[_i];
+      for (var _i3 = 0, _candidates2 = candidates; _i3 < _candidates2.length; _i3++) {
+        var v = _candidates2[_i3];
         if (!v) continue;
         var text = String(v);
         if (!text) continue;
@@ -395,137 +1427,225 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     }
 
     /**
-     * 初始化 pubsub 订阅，监听订单变更
+     * 初始化 pubsub 订阅，监听订单变更（纯订阅，不拉数据；全量 SSE 由 loadOrdersByServer 负责）
      */
   }, {
     key: "setupOrderSync",
     value: function setupOrderSync() {
-      var _this4 = this;
+      var _this12 = this;
       if (!this.orderDataSource) return;
-      var shouldSkipHttpPull = this.hasPulledOrdersToday();
-      var syncPayload = {
+      this.orderDataSource.run({
         pubsub: {
           callback: function callback(res) {
-            var message = _this4.normalizeOrderSyncMessage(res);
+            var _message$id, _message$order_id, _message$type;
+            var pubsubReceivedAt = Date.now();
+            var message = _this12.normalizeOrderSyncMessage(res);
             if (!message) return;
-            _this4.pendingSyncMessages.push(message);
-            if (_this4.syncTimer) clearTimeout(_this4.syncTimer);
-            _this4.syncTimer = setTimeout(function () {
-              _this4.processOrderSyncMessages();
-            }, _this4.ORDER_SYNC_DEBOUNCE_MS);
+            message._pubsubReceivedAt = pubsubReceivedAt;
+            _this12.pendingSyncMessages.push(message);
+            var throttleMs = _this12.getOrderSyncThrottleMs();
+            var routeInfo = _this12.resolveSyncMessageRoute(message);
+            _this12.logInfo('orderSync-收到消息并入队', {
+              id: (_message$id = message.id) !== null && _message$id !== void 0 ? _message$id : null,
+              order_id: (_message$order_id = message.order_id) !== null && _message$order_id !== void 0 ? _message$order_id : null,
+              type: (_message$type = message.type) !== null && _message$type !== void 0 ? _message$type : null,
+              pendingCount: _this12.pendingSyncMessages.length,
+              throttleMs: throttleMs,
+              pubsubReceivedAt: new Date(pubsubReceivedAt).toISOString(),
+              fullMessage: JSON.stringify(message)
+            });
+            _this12.scheduleOrderSyncThrottle();
           }
         }
-      };
-      syncPayload.http = {
-        query: this.store.createdAtQuery,
-        skipHttp: shouldSkipHttpPull
-      };
-      this.orderDataSource.run(syncPayload).then(function () {
-        if (!shouldSkipHttpPull) _this4.markOrderPulledAtNow();
       }).catch(function () {
         // 忽略同步初始化异常，避免影响主流程
       });
     }
 
     /**
-     * 处理防抖后的同步消息批次
+     * 调度订单同步节流窗口（leading-edge throttle）：
+     * - 空闲状态下收到的第一条消息立即触发批处理，无需等待；
+     * - 首条处理后进入冷却窗口，窗口期间的后续消息聚合，窗口结束后批量处理；
+     * - 若当前批处理执行中，则由批处理结束后决定是否开启下一轮窗口。
+     */
+  }, {
+    key: "scheduleOrderSyncThrottle",
+    value: function scheduleOrderSyncThrottle() {
+      var _this13 = this;
+      if (this.isProcessingSyncBatch) return;
+      if (this.isIdlePhase) {
+        this.isIdlePhase = false;
+        this.logInfo('orderSync-首条消息立即触发处理');
+        void this.flushOrderSyncMessagesByThrottle();
+        return;
+      }
+      if (this.syncTimer) return;
+      var throttleMs = this.getOrderSyncThrottleMs();
+      this.syncTimer = setTimeout(function () {
+        _this13.syncTimer = undefined;
+        void _this13.flushOrderSyncMessagesByThrottle();
+      }, throttleMs);
+    }
+
+    /**
+     * 执行一次节流批处理并在需要时续约下一轮窗口。
+     * 批处理完成且无后续消息时恢复空闲状态，下一条消息将立即触发。
+     */
+  }, {
+    key: "flushOrderSyncMessagesByThrottle",
+    value: (function () {
+      var _flushOrderSyncMessagesByThrottle = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee13() {
+        return _regeneratorRuntime().wrap(function _callee13$(_context13) {
+          while (1) switch (_context13.prev = _context13.next) {
+            case 0:
+              if (!this.isProcessingSyncBatch) {
+                _context13.next = 2;
+                break;
+              }
+              return _context13.abrupt("return");
+            case 2:
+              if (!(this.pendingSyncMessages.length === 0)) {
+                _context13.next = 5;
+                break;
+              }
+              this.isIdlePhase = true;
+              return _context13.abrupt("return");
+            case 5:
+              this.isProcessingSyncBatch = true;
+              _context13.prev = 6;
+              _context13.next = 9;
+              return this.processOrderSyncMessages();
+            case 9:
+              _context13.prev = 9;
+              this.isProcessingSyncBatch = false;
+              if (this.pendingSyncMessages.length > 0) {
+                this.scheduleOrderSyncThrottle();
+              } else {
+                this.isIdlePhase = true;
+              }
+              return _context13.finish(9);
+            case 13:
+            case "end":
+              return _context13.stop();
+          }
+        }, _callee13, this, [[6,, 9, 13]]);
+      }));
+      function flushOrderSyncMessagesByThrottle() {
+        return _flushOrderSyncMessagesByThrottle.apply(this, arguments);
+      }
+      return flushOrderSyncMessagesByThrottle;
+    }()
+    /**
+     * 处理节流窗口内聚合后的同步消息批次
      *
      * 后端统一发送 change 消息，不再区分新增/编辑/删除。
      * - 单条（id/order_id）：若携带 body/data 则直接 upsert 到本地
      * - 批量（ids）：通过 HTTP 按 ids 增量拉取，再 merge 到本地
+     *
+     * @example
+     * // pending 队列中存在 8 条消息时，仅处理一次批次并统一 merge
+     * await this.processOrderSyncMessages()
      */
+    )
   }, {
     key: "processOrderSyncMessages",
     value: (function () {
-      var _processOrderSyncMessages = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
-        var messages, upsertOrders, refreshIds, _iterator3, _step3, _msg$id, _msg$relation_order_i, msg, hasBatchIds, singleId, hasSingleId, rawBody, normalizedBody, uniqueRefreshIds, upsertList, freshOrders;
-        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
-          while (1) switch (_context4.prev = _context4.next) {
+      var _processOrderSyncMessages = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee14() {
+        var _this14 = this;
+        var messages, batchProcessStartAt, earliestReceivedAt, upsertOrders, refreshIds, uniqueRefreshIds, upsertList, _this$filterRedundant, toFetch, skipped, freshOrders, batchProcessEndAt;
+        return _regeneratorRuntime().wrap(function _callee14$(_context14) {
+          while (1) switch (_context14.prev = _context14.next) {
             case 0:
               messages = _toConsumableArray(this.pendingSyncMessages);
               this.pendingSyncMessages = [];
               if (!(messages.length === 0)) {
-                _context4.next = 4;
+                _context14.next = 4;
                 break;
               }
-              return _context4.abrupt("return");
+              return _context14.abrupt("return");
             case 4:
+              batchProcessStartAt = Date.now();
+              earliestReceivedAt = Math.min.apply(Math, _toConsumableArray(messages.map(function (m) {
+                var _m$_pubsubReceivedAt;
+                return (_m$_pubsubReceivedAt = m._pubsubReceivedAt) !== null && _m$_pubsubReceivedAt !== void 0 ? _m$_pubsubReceivedAt : batchProcessStartAt;
+              })));
+              this.logInfo('processOrderSyncMessages-开始', {
+                messageCount: messages.length,
+                earliestReceivedAt: new Date(earliestReceivedAt).toISOString(),
+                batchProcessStartAt: new Date(batchProcessStartAt).toISOString(),
+                waitDurationMs: batchProcessStartAt - earliestReceivedAt
+              });
               upsertOrders = new Map();
               refreshIds = [];
-              _iterator3 = _createForOfIteratorHelper(messages);
-              _context4.prev = 7;
-              _iterator3.s();
-            case 9:
-              if ((_step3 = _iterator3.n()).done) {
-                _context4.next = 22;
-                break;
-              }
-              msg = _step3.value;
-              hasBatchIds = Array.isArray(msg.ids) && msg.ids.length > 0;
-              singleId = (_msg$id = msg.id) !== null && _msg$id !== void 0 ? _msg$id : msg.order_id;
-              hasSingleId = !hasBatchIds && singleId !== undefined && singleId !== null;
-              rawBody = msg.body || msg.data;
-              normalizedBody = this.normalizeOrderSyncPayload(rawBody);
-              if (!(hasSingleId && normalizedBody)) {
-                _context4.next = 19;
-                break;
-              }
-              upsertOrders.set(this.getIdKey(normalizedBody.order_id), normalizedBody);
-              return _context4.abrupt("continue", 20);
-            case 19:
-              if (hasBatchIds) refreshIds.push.apply(refreshIds, _toConsumableArray(msg.ids));else if (hasSingleId) refreshIds.push(singleId);else if ((_msg$relation_order_i = msg.relation_order_ids) !== null && _msg$relation_order_i !== void 0 && _msg$relation_order_i.length) refreshIds.push.apply(refreshIds, _toConsumableArray(msg.relation_order_ids));
-            case 20:
-              _context4.next = 9;
-              break;
-            case 22:
-              _context4.next = 27;
-              break;
-            case 24:
-              _context4.prev = 24;
-              _context4.t0 = _context4["catch"](7);
-              _iterator3.e(_context4.t0);
-            case 27:
-              _context4.prev = 27;
-              _iterator3.f();
-              return _context4.finish(27);
-            case 30:
+              messages.forEach(function (msg, msgIndex) {
+                var routeInfo = _this14.resolveSyncMessageRoute(msg);
+                var hasBatchIds = routeInfo.hasBatchIds;
+                var singleId = routeInfo.singleId;
+                var hasSingleId = routeInfo.hasSingleId;
+                var normalizedBody = _this14.normalizeOrderSyncPayload(msg.body || msg.data);
+                if (routeInfo.route === 'bodyUpsert' && normalizedBody) {
+                  upsertOrders.set(_this14.getIdKey(normalizedBody.order_id), normalizedBody);
+                  return;
+                }
+                if (hasBatchIds) refreshIds.push.apply(refreshIds, _toConsumableArray(routeInfo.batchIds));else if (routeInfo.route === 'httpRefresh.singleId' && singleId !== null) refreshIds.push(singleId);else if (routeInfo.route === 'httpRefresh.relationIds') refreshIds.push.apply(refreshIds, _toConsumableArray(routeInfo.batchIds));
+              });
               uniqueRefreshIds = this.uniqueOrderIds(refreshIds);
               upsertList = _toConsumableArray(upsertOrders.values());
+              this.logInfo('processOrderSyncMessages-去重完成', {
+                upsertCount: upsertList.length,
+                refreshIdCount: uniqueRefreshIds.length
+              });
               if (!(upsertList.length > 0)) {
-                _context4.next = 35;
+                _context14.next = 16;
                 break;
               }
-              _context4.next = 35;
-              return this.mergeOrdersToStore(upsertList);
-            case 35:
+              _context14.next = 16;
+              return this.mergeOrdersToStore(upsertList, 'pubsub.bodyUpsert');
+            case 16:
               if (!(uniqueRefreshIds.length > 0)) {
-                _context4.next = 42;
+                _context14.next = 28;
                 break;
               }
-              _context4.next = 38;
-              return this.fetchOrdersByHttp(uniqueRefreshIds);
-            case 38:
-              freshOrders = _context4.sent;
+              _this$filterRedundant = this.filterRedundantHttpRefreshIds(uniqueRefreshIds), toFetch = _this$filterRedundant.toFetch, skipped = _this$filterRedundant.skipped;
+              if (skipped.length > 0) {}
+              if (!(toFetch.length > 0)) {
+                _context14.next = 28;
+                break;
+              }
+              _context14.next = 22;
+              return this.fetchOrdersByHttp(toFetch);
+            case 22:
+              freshOrders = _context14.sent;
               if (!(freshOrders.length > 0)) {
-                _context4.next = 42;
+                _context14.next = 28;
                 break;
               }
-              _context4.next = 42;
-              return this.mergeOrdersToStore(freshOrders);
-            case 42:
+              _context14.next = 26;
+              return this.mergeOrdersToStore(freshOrders, 'pubsub.httpRefresh');
+            case 26:
+              _context14.next = 28;
+              break;
+            case 28:
               if (!(upsertList.length === 0 && uniqueRefreshIds.length === 0)) {
-                _context4.next = 44;
+                _context14.next = 30;
                 break;
               }
-              return _context4.abrupt("return");
-            case 44:
-              _context4.next = 46;
+              return _context14.abrupt("return");
+            case 30:
+              batchProcessEndAt = Date.now();
+              this.logInfo('processOrderSyncMessages-结束', {
+                upsertCount: upsertList.length,
+                refreshIdCount: uniqueRefreshIds.length,
+                batchProcessDurationMs: batchProcessEndAt - batchProcessStartAt,
+                totalFromPubsubToProcessedMs: batchProcessEndAt - earliestReceivedAt
+              });
+              _context14.next = 34;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 46:
+            case 34:
             case "end":
-              return _context4.stop();
+              return _context14.stop();
           }
-        }, _callee4, this, [[7, 24, 27, 30]]);
+        }, _callee14, this);
       }));
       function processOrderSyncMessages() {
         return _processOrderSyncMessages.apply(this, arguments);
@@ -533,35 +1653,42 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return processOrderSyncMessages;
     }()
     /**
-     * 通过 HTTP 按 ids 增量拉取订单
+     * 通过 HTTP 按 ids 批量拉取订单详情（走 orderDataSource）。
+     *
+     * - 优先使用 `orderDataSource.fetchOrdersByIds`（如适配器实现了该方法）
+     * - 否则回退到 `orderDataSource.run({ http: { query: { ids } } })`
+     * - 失败统一返回空数组（由调用方按"返回缺失的 id" 判断单笔失败）
+     *
+     * @example
+     * const fresh = await orderModule.fetchOrdersByHttp(['96971', '96972'])
      */
     )
   }, {
     key: "fetchOrdersByHttp",
     value: (function () {
-      var _fetchOrdersByHttp = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(ids) {
-        var _orderList, orderList;
-        return _regeneratorRuntime().wrap(function _callee5$(_context5) {
-          while (1) switch (_context5.prev = _context5.next) {
+      var _fetchOrdersByHttp = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee15(ids) {
+        var _orderList, orderList;
+        return _regeneratorRuntime().wrap(function _callee15$(_context15) {
+          while (1) switch (_context15.prev = _context15.next) {
             case 0:
               if (!(!this.orderDataSource || ids.length === 0)) {
-                _context5.next = 2;
+                _context15.next = 2;
                 break;
               }
-              return _context5.abrupt("return", []);
+              return _context15.abrupt("return", []);
             case 2:
-              _context5.prev = 2;
+              _context15.prev = 2;
               if (!(typeof this.orderDataSource.fetchOrdersByIds === 'function')) {
-                _context5.next = 8;
+                _context15.next = 8;
                 break;
               }
-              _context5.next = 6;
+              _context15.next = 6;
               return this.orderDataSource.fetchOrdersByIds(ids);
             case 6:
-              _orderList = _context5.sent;
-              return _context5.abrupt("return", _orderList || []);
+              _orderList = _context15.sent;
+              return _context15.abrupt("return", _orderList || []);
             case 8:
-              _context5.next = 10;
+              _context15.next = 10;
               return this.orderDataSource.run({
                 http: {
                   query: {
@@ -570,19 +1697,19 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 }
               });
             case 10:
-              orderList = _context5.sent;
-              return _context5.abrupt("return", orderList || []);
+              orderList = _context15.sent;
+              return _context15.abrupt("return", orderList || []);
             case 14:
-              _context5.prev = 14;
-              _context5.t0 = _context5["catch"](2);
-              return _context5.abrupt("return", []);
+              _context15.prev = 14;
+              _context15.t0 = _context15["catch"](2);
+              return _context15.abrupt("return", []);
             case 17:
             case "end":
-              return _context5.stop();
+              return _context15.stop();
           }
-        }, _callee5, this, [[2, 14]]);
+        }, _callee15, this, [[2, 14]]);
       }));
-      function fetchOrdersByHttp(_x3) {
+      function fetchOrdersByHttp(_x8) {
         return _fetchOrdersByHttp.apply(this, arguments);
       }
       return fetchOrdersByHttp;
@@ -594,82 +1721,256 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "mergeOrdersToStore",
     value: (function () {
-      var _mergeOrdersToStore = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6(freshOrders) {
-        var _this5 = this;
-        var freshMap, _iterator4, _step4, order, id, updatedList, _iterator5, _step5, _order;
-        return _regeneratorRuntime().wrap(function _callee6$(_context6) {
-          while (1) switch (_context6.prev = _context6.next) {
+      var _mergeOrdersToStore = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee16(freshOrders, source) {
+        var _this15 = this;
+        var storeOrderCountBefore, normalizedFreshOrders, _iterator10, _step10, order, id, uniqueFreshOrders, uniqueFreshCount, patchedOrders, mergeActions, updatedList, identityKeyToIndex, index, identityKeys, _iterator11, _step11, key, _iterator12, _step12, fresh, freshIdentityKeys, matchIndex, storageKey, mergeKey, existingOrder, _ref2, _existingOrder$order_, _ref3, _external_sale_number2, _existingOrder$paymen, _fresh$payment_status, _existingOrder$need_s, _fresh$need_sync, mergedOrder, insertIndex, insertCount, updateCount;
+        return _regeneratorRuntime().wrap(function _callee16$(_context16) {
+          while (1) switch (_context16.prev = _context16.next) {
             case 0:
-              freshMap = new Map();
-              _iterator4 = _createForOfIteratorHelper(freshOrders);
-              _context6.prev = 2;
-              _iterator4.s();
-            case 4:
-              if ((_step4 = _iterator4.n()).done) {
-                _context6.next = 12;
+              storeOrderCountBefore = this.store.list.length;
+              this.logInfo('mergeOrdersToStore-开始', {
+                freshOrderCount: freshOrders.length,
+                storeOrderCountBefore: storeOrderCountBefore,
+                source: source
+              });
+              this.logDuplicateOrders("".concat(source, ".beforeMerge"), this.store.list);
+              normalizedFreshOrders = [];
+              _iterator10 = _createForOfIteratorHelper(freshOrders);
+              _context16.prev = 5;
+              _iterator10.s();
+            case 7:
+              if ((_step10 = _iterator10.n()).done) {
+                _context16.next = 15;
                 break;
               }
-              order = _step4.value;
+              order = _step10.value;
               id = order === null || order === void 0 ? void 0 : order.order_id;
               if (!(id === undefined || id === null)) {
-                _context6.next = 9;
+                _context16.next = 12;
                 break;
               }
-              return _context6.abrupt("continue", 10);
-            case 9:
-              freshMap.set(this.getIdKey(id), order);
-            case 10:
-              _context6.next = 4;
-              break;
+              return _context16.abrupt("continue", 13);
             case 12:
-              _context6.next = 17;
+              normalizedFreshOrders.push(this.normalizeRemoteSyncedOrder(order));
+            case 13:
+              _context16.next = 7;
+              break;
+            case 15:
+              _context16.next = 20;
               break;
-            case 14:
-              _context6.prev = 14;
-              _context6.t0 = _context6["catch"](2);
-              _iterator4.e(_context6.t0);
             case 17:
-              _context6.prev = 17;
-              _iterator4.f();
-              return _context6.finish(17);
+              _context16.prev = 17;
+              _context16.t0 = _context16["catch"](5);
+              _iterator10.e(_context16.t0);
             case 20:
+              _context16.prev = 20;
+              _iterator10.f();
+              return _context16.finish(20);
+            case 23:
+              // 先对本批新单做去重（批内规模 m 很小），保证每条 fresh 身份唯一
+              uniqueFreshOrders = this.compactOrderListByIdentity(normalizedFreshOrders, "".concat(source, ".incoming")).list;
+              uniqueFreshCount = uniqueFreshOrders.length;
+              patchedOrders = [];
+              mergeActions = {};
               updatedList = this.store.list.map(function (order) {
-                var id = order.order_id;
-                if (id === undefined || id === null) return order;
-                var key = _this5.getIdKey(id);
-                if (!freshMap.has(key)) return order;
-                var fresh = freshMap.get(key);
-                freshMap.delete(key);
-                return fresh;
-              });
-              _iterator5 = _createForOfIteratorHelper(freshMap.values());
-              try {
-                for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-                  _order = _step5.value;
-                  updatedList.push(_order);
+                return _this15.normalizeOrderForMemoryList(order, "".concat(source, ".existingMemory"));
+              }); // 基于身份键（field:value）建立索引，把「查找已存在订单」从 O(n) 线性扫描降为 O(1)，
+              // 整体合并复杂度由 O(n^2) 降为 O(n + m)。索引语义与 doOrdersShareIdentity 完全一致：
+              // 任一身份字段（order_id/external_sale_number/order_number/shop_order_number）同值即同一单。
+              identityKeyToIndex = new Map();
+              for (index = 0; index < updatedList.length; index += 1) {
+                identityKeys = this.getOrderIdentityMatchKeys(updatedList[index]);
+                _iterator11 = _createForOfIteratorHelper(identityKeys);
+                try {
+                  for (_iterator11.s(); !(_step11 = _iterator11.n()).done;) {
+                    key = _step11.value;
+                    // 同一 key 命中多张时保留最靠前的下标，与原 findIndex「取首个匹配」一致
+                    if (!identityKeyToIndex.has(key)) identityKeyToIndex.set(key, index);
+                  }
+                } catch (err) {
+                  _iterator11.e(err);
+                } finally {
+                  _iterator11.f();
                 }
-              } catch (err) {
-                _iterator5.e(err);
-              } finally {
-                _iterator5.f();
               }
-              this.store.list = updatedList;
+              _iterator12 = _createForOfIteratorHelper(uniqueFreshOrders);
+              _context16.prev = 31;
+              _iterator12.s();
+            case 33:
+              if ((_step12 = _iterator12.n()).done) {
+                _context16.next = 57;
+                break;
+              }
+              fresh = _step12.value;
+              freshIdentityKeys = this.getOrderIdentityMatchKeys(fresh);
+              matchIndex = this.lookupOrderIndexByIdentityKeys(identityKeyToIndex, freshIdentityKeys);
+              storageKey = this.getOrderStorageKey(fresh);
+              mergeKey = storageKey || (fresh.order_id !== undefined && fresh.order_id !== null ? this.getIdKey(fresh.order_id) : '');
+              if (!(matchIndex >= 0)) {
+                _context16.next = 50;
+                break;
+              }
+              existingOrder = updatedList[matchIndex];
+              if (!(this.isPendingSyncOrder(existingOrder) && this.isRemoteEchoMergeSource(source))) {
+                _context16.next = 44;
+                break;
+              }
+              this.logInfo('mergeOrdersToStore-跳过 pending 订单远端覆盖', {
+                source: source,
+                order_id: (_ref2 = (_existingOrder$order_ = existingOrder.order_id) !== null && _existingOrder$order_ !== void 0 ? _existingOrder$order_ : fresh.order_id) !== null && _ref2 !== void 0 ? _ref2 : null,
+                external_sale_number: (_ref3 = (_external_sale_number2 = existingOrder.external_sale_number) !== null && _external_sale_number2 !== void 0 ? _external_sale_number2 : fresh.external_sale_number) !== null && _ref3 !== void 0 ? _ref3 : null,
+                local_payment_status: (_existingOrder$paymen = existingOrder.payment_status) !== null && _existingOrder$paymen !== void 0 ? _existingOrder$paymen : null,
+                remote_payment_status: (_fresh$payment_status = fresh.payment_status) !== null && _fresh$payment_status !== void 0 ? _fresh$payment_status : null,
+                local_need_sync: (_existingOrder$need_s = existingOrder.need_sync) !== null && _existingOrder$need_s !== void 0 ? _existingOrder$need_s : null,
+                remote_need_sync: (_fresh$need_sync = fresh.need_sync) !== null && _fresh$need_sync !== void 0 ? _fresh$need_sync : null,
+                reason: 'protect_pending_sync_order_from_remote_echo'
+              });
+              return _context16.abrupt("continue", 55);
+            case 44:
+              mergedOrder = this.mergeOrderRecords(existingOrder, fresh);
+              updatedList[matchIndex] = mergedOrder;
+              // 合并后身份字段可能新增（如挂单拿到 order_id），同步登记到索引，
+              // 供同批后续 fresh 命中同一槽位，避免重复插入
+              this.registerOrderIdentityKeys(identityKeyToIndex, mergedOrder, matchIndex);
+              patchedOrders.push(mergedOrder);
+              if (mergeKey) mergeActions[mergeKey] = 'update';
+              return _context16.abrupt("continue", 55);
+            case 50:
+              insertIndex = updatedList.length;
+              updatedList.push(fresh);
+              this.registerOrderIdentityKeys(identityKeyToIndex, fresh, insertIndex);
+              patchedOrders.push(fresh);
+              if (mergeKey) mergeActions[mergeKey] = 'insert';
+            case 55:
+              _context16.next = 33;
+              break;
+            case 57:
+              _context16.next = 62;
+              break;
+            case 59:
+              _context16.prev = 59;
+              _context16.t1 = _context16["catch"](31);
+              _iterator12.e(_context16.t1);
+            case 62:
+              _context16.prev = 62;
+              _iterator12.f();
+              return _context16.finish(62);
+            case 65:
+              insertCount = Object.values(mergeActions).filter(function (v) {
+                return v === 'insert';
+              }).length;
+              updateCount = Object.values(mergeActions).filter(function (v) {
+                return v === 'update';
+              }).length;
+              this.logInfo('mergeOrdersToStore-合并完成', {
+                insertCount: insertCount,
+                updateCount: updateCount,
+                storeOrderCountAfter: this.store.list.length
+              });
+              // 增量索引已保证 store 去重不变量，无需再对全表做 O(n^2) 压缩；
+              // 仅在自检开关开启时做一次兜底校验。
+              this.store.list = this.runOrderStoreSelfCheck(updatedList, "".concat(source, ".store"));
               this.syncOrdersMap();
-              _context6.next = 27;
-              return this.saveOrdersToSQLite(this.store.list);
-            case 27:
-              this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
-            case 28:
+              _context16.next = 72;
+              return this.patchOrdersInSQLite(patchedOrders, source, mergeActions);
+            case 72:
+              this.logInfo('mergeOrdersToStore-结束', {
+                uniqueFreshCount: uniqueFreshCount,
+                storeOrderCountAfter: this.store.list.length,
+                insertCount: insertCount,
+                updateCount: updateCount
+              });
+              _context16.next = 75;
+              return this.emitOrdersChanged(patchedOrders, source);
+            case 75:
             case "end":
-              return _context6.stop();
+              return _context16.stop();
           }
-        }, _callee6, this, [[2, 14, 17, 20]]);
+        }, _callee16, this, [[5, 17, 20, 23], [31, 59, 62, 65]]);
       }));
-      function mergeOrdersToStore(_x4) {
+      function mergeOrdersToStore(_x9, _x10) {
         return _mergeOrdersToStore.apply(this, arguments);
       }
       return mergeOrdersToStore;
-    }())
+    }()
+    /**
+     * 在身份索引中查找与目标订单共享任一身份键的已存在订单下标。
+     * 返回所有命中键里最小的下标，等价于原 findOrderIndexByIdentity 的「取首个匹配」语义。
+     *
+     * @example
+     * const idx = this.lookupOrderIndexByIdentityKeys(identityKeyToIndex, freshIdentityKeys)
+     */
+    )
+  }, {
+    key: "lookupOrderIndexByIdentityKeys",
+    value: function lookupOrderIndexByIdentityKeys(identityKeyToIndex, identityKeys) {
+      var matchIndex = -1;
+      var _iterator13 = _createForOfIteratorHelper(identityKeys),
+        _step13;
+      try {
+        for (_iterator13.s(); !(_step13 = _iterator13.n()).done;) {
+          var key = _step13.value;
+          var index = identityKeyToIndex.get(key);
+          if (index === undefined) continue;
+          if (matchIndex < 0 || index < matchIndex) matchIndex = index;
+        }
+      } catch (err) {
+        _iterator13.e(err);
+      } finally {
+        _iterator13.f();
+      }
+      return matchIndex;
+    }
+  }, {
+    key: "isRemoteEchoMergeSource",
+    value: function isRemoteEchoMergeSource(source) {
+      return source === 'pubsub.bodyUpsert' || source === 'pubsub.httpRefresh';
+    }
+
+    /**
+     * 将订单的全部身份键登记到索引并指向其在列表中的下标。
+     * 合并后订单新增的身份字段（如挂单同步后拿到 order_id）也会被登记。
+     *
+     * @example
+     * this.registerOrderIdentityKeys(identityKeyToIndex, mergedOrder, matchIndex)
+     */
+  }, {
+    key: "registerOrderIdentityKeys",
+    value: function registerOrderIdentityKeys(identityKeyToIndex, order, index) {
+      var identityKeys = this.getOrderIdentityMatchKeys(order);
+      var _iterator14 = _createForOfIteratorHelper(identityKeys),
+        _step14;
+      try {
+        for (_iterator14.s(); !(_step14 = _iterator14.n()).done;) {
+          var key = _step14.value;
+          identityKeyToIndex.set(key, index);
+        }
+      } catch (err) {
+        _iterator14.e(err);
+      } finally {
+        _iterator14.f();
+      }
+    }
+
+    /**
+     * 合并热路径去重兜底：默认直接返回原列表（增量索引已保证无重复）。
+     * 仅当 ORDER_MERGE_SELF_CHECK 开启时，额外做一次全表压缩并在发现残留重复时告警。
+     */
+  }, {
+    key: "runOrderStoreSelfCheck",
+    value: function runOrderStoreSelfCheck(orders, source) {
+      if (!ORDER_MERGE_SELF_CHECK) return orders;
+      var _this$compactOrderLis = this.compactOrderListByIdentity(orders, source),
+        list = _this$compactOrderLis.list,
+        removedCount = _this$compactOrderLis.removedCount;
+      if (removedCount > 0) {
+        this.logWarning('合并自检发现残留重复订单，已压缩', {
+          source: source,
+          removedCount: removedCount
+        });
+      }
+      return list;
+    }
   }, {
     key: "normalizeOrderSyncMessage",
     value: function normalizeOrderSyncMessage(res) {
@@ -702,17 +2003,17 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "uniqueOrderIds",
     value: function uniqueOrderIds(ids) {
       var idMap = new Map();
-      var _iterator6 = _createForOfIteratorHelper(ids),
-        _step6;
+      var _iterator15 = _createForOfIteratorHelper(ids),
+        _step15;
       try {
-        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-          var id = _step6.value;
+        for (_iterator15.s(); !(_step15 = _iterator15.n()).done;) {
+          var id = _step15.value;
           idMap.set(this.getIdKey(id), id);
         }
       } catch (err) {
-        _iterator6.e(err);
+        _iterator15.e(err);
       } finally {
-        _iterator6.f();
+        _iterator15.f();
       }
       return _toConsumableArray(idMap.values());
     }
@@ -721,6 +2022,238 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     value: function getIdKey(id) {
       return String(id);
     }
+  }, {
+    key: "isOrderLookupMatch",
+    value: function isOrderLookupMatch(order, lookupKey) {
+      var _this16 = this;
+      if (!order || !lookupKey) return false;
+      var candidates = [order.order_id, order.external_sale_number, order.order_number, order.shop_order_number, order.shop_full_order_number];
+      return candidates.some(function (value) {
+        if (value === undefined || value === null || value === '') return false;
+        return _this16.getIdKey(value) === lookupKey;
+      });
+    }
+
+    /**
+     * 解析订单 SQLite 主键，规则与宿主 OrderDataSource.getOrderStorageKey 一致。
+     *
+     * @example
+     * const key = this.getOrderStorageKey({ order_id: 1001, external_sale_number: 'S-1001' })
+     * // => 'S-1001'
+     */
+  }, {
+    key: "getOrderStorageKey",
+    value: function getOrderStorageKey(order) {
+      var externalSaleNumber = order === null || order === void 0 ? void 0 : order.external_sale_number;
+      if (externalSaleNumber !== undefined && externalSaleNumber !== null && externalSaleNumber !== '') {
+        return String(externalSaleNumber);
+      }
+      var orderId = order === null || order === void 0 ? void 0 : order.order_id;
+      if (orderId !== undefined && orderId !== null && orderId !== '') {
+        return String(orderId);
+      }
+      return '';
+    }
+  }, {
+    key: "getOrderIdentityMatchKeys",
+    value: function getOrderIdentityMatchKeys(order) {
+      return this.getOrderIdentityEntries(order).map(function (entry) {
+        return "".concat(entry.field, ":").concat(entry.key);
+      });
+    }
+  }, {
+    key: "doOrdersShareIdentity",
+    value: function doOrdersShareIdentity(left, right) {
+      var leftKeys = new Set(this.getOrderIdentityMatchKeys(left));
+      if (leftKeys.size === 0) return false;
+      return this.getOrderIdentityMatchKeys(right).some(function (key) {
+        return leftKeys.has(key);
+      });
+    }
+  }, {
+    key: "findOrderIndexByIdentity",
+    value: function findOrderIndexByIdentity(orders, target) {
+      var _this17 = this;
+      if (this.getOrderIdentityMatchKeys(target).length === 0) return -1;
+      return orders.findIndex(function (order) {
+        return _this17.doOrdersShareIdentity(order, target);
+      });
+    }
+  }, {
+    key: "getOrderCompletenessScore",
+    value: function getOrderCompletenessScore(order) {
+      var record = order;
+      var score = this.isPendingSyncOrder(order) ? 0 : 100;
+      if (!this.isBlankIdentityValue(order.order_id) && order.order_id !== record.external_sale_number) score += 30;
+      score += this.getOrderIdentityMatchKeys(order).length * 5;
+      if (Array.isArray(order.products)) score += Math.min(order.products.length, 10);
+      if (Array.isArray(order.bookings)) score += Math.min(order.bookings.length, 10);
+      if (Array.isArray(order.payments)) score += Math.min(order.payments.length, 10);
+      if (record.updated_at) score += 1;
+      return score;
+    }
+  }, {
+    key: "pickPreferredOrder",
+    value: function pickPreferredOrder(left, right) {
+      var leftScore = this.getOrderCompletenessScore(left);
+      var rightScore = this.getOrderCompletenessScore(right);
+      if (rightScore >= leftScore) return right;
+      return left;
+    }
+  }, {
+    key: "mergeOrderRecords",
+    value: function mergeOrderRecords(existing, incoming) {
+      var preferred = this.pickPreferredOrder(existing, incoming);
+      var secondary = preferred === existing ? incoming : existing;
+      var merged = _objectSpread(_objectSpread({}, secondary), preferred);
+      var fieldsToPreserve = ['order_id', 'external_sale_number', 'order_number', 'shop_order_number', 'shop_full_order_number'];
+      var incomingPatchFields = ['payment_status', 'status', 'shipping_status', 'updated_at', 'shop_discount', 'summary', 'note', 'customer_id', 'customer_name', 'customer', 'holder', 'contacts_info', 'phone', 'email', 'relation_forms'];
+      var mergedRecord = merged;
+      var preferredRecord = preferred;
+      var secondaryRecord = secondary;
+      var existingRecord = existing;
+      var incomingRecord = incoming;
+      var childUidRemaps = [];
+      for (var _i4 = 0, _fieldsToPreserve = fieldsToPreserve; _i4 < _fieldsToPreserve.length; _i4++) {
+        var field = _fieldsToPreserve[_i4];
+        if (!this.isBlankIdentityValue(preferredRecord[field])) {
+          mergedRecord[field] = preferredRecord[field];
+          continue;
+        }
+        if (!this.isBlankIdentityValue(secondaryRecord[field])) {
+          mergedRecord[field] = secondaryRecord[field];
+        }
+      }
+      for (var _i5 = 0, _incomingPatchFields = incomingPatchFields; _i5 < _incomingPatchFields.length; _i5++) {
+        var _field = _incomingPatchFields[_i5];
+        if (!Object.prototype.hasOwnProperty.call(incomingRecord, _field)) continue;
+        if (incomingRecord[_field] === undefined || incomingRecord[_field] === null) continue;
+        if (typeof incomingRecord[_field] === 'string' && incomingRecord[_field] === '') continue;
+        mergedRecord[_field] = cloneDeep(incomingRecord[_field]);
+      }
+
+      // 子项数组遵循完整快照语义：incoming 自有且为数组（包括 []）时权威替换；
+      // 字段缺席或不是数组时视为稀疏 patch，继续保留 existing。
+      for (var _i6 = 0, _ORDER_AUTHORITATIVE_2 = ORDER_AUTHORITATIVE_COLLECTION_FIELDS; _i6 < _ORDER_AUTHORITATIVE_2.length; _i6++) {
+        var _field2 = _ORDER_AUTHORITATIVE_2[_i6];
+        if (Array.isArray(incomingRecord[_field2])) {
+          mergedRecord[_field2] = this.mergeAuthoritativeOrderCollection(_field2, existingRecord[_field2], incomingRecord[_field2], childUidRemaps);
+          continue;
+        }
+        if (Object.prototype.hasOwnProperty.call(existingRecord, _field2)) {
+          mergedRecord[_field2] = cloneDeep(existingRecord[_field2]);
+        } else {
+          delete mergedRecord[_field2];
+        }
+      }
+      if (!this.isPendingSyncOrder(preferred) || !this.isPendingSyncOrder(secondary)) {
+        merged.need_sync = 0;
+      }
+      return this.normalizeOrderCollectionsForIngress(applyOrderCollectionUidRemaps(merged, childUidRemaps), 'mergeOrderRecords');
+    }
+  }, {
+    key: "summarizeDuplicateOrders",
+    value: function summarizeDuplicateOrders(orders) {
+      var groups = new Map();
+      var _iterator16 = _createForOfIteratorHelper(orders),
+        _step16;
+      try {
+        for (_iterator16.s(); !(_step16 = _iterator16.n()).done;) {
+          var order = _step16.value;
+          var _iterator17 = _createForOfIteratorHelper(this.getOrderIdentityMatchKeys(order)),
+            _step17;
+          try {
+            for (_iterator17.s(); !(_step17 = _iterator17.n()).done;) {
+              var key = _step17.value;
+              var group = groups.get(key) || [];
+              group.push(order);
+              groups.set(key, group);
+            }
+          } catch (err) {
+            _iterator17.e(err);
+          } finally {
+            _iterator17.f();
+          }
+        }
+      } catch (err) {
+        _iterator16.e(err);
+      } finally {
+        _iterator16.f();
+      }
+      return _toConsumableArray(groups.entries()).filter(function (_ref4) {
+        var _ref5 = _slicedToArray(_ref4, 2),
+          group = _ref5[1];
+        return group.length > 1;
+      }).slice(0, 20).map(function (_ref6) {
+        var _ref7 = _slicedToArray(_ref6, 2),
+          key = _ref7[0],
+          group = _ref7[1];
+        return {
+          key: key,
+          count: group.length,
+          orders: group.map(function (order) {
+            var _order$order_id3, _external_sale_number3, _shop_order_number, _shop_full_order_numb, _order$need_sync;
+            return {
+              order_id: (_order$order_id3 = order.order_id) !== null && _order$order_id3 !== void 0 ? _order$order_id3 : null,
+              external_sale_number: (_external_sale_number3 = order.external_sale_number) !== null && _external_sale_number3 !== void 0 ? _external_sale_number3 : null,
+              shop_order_number: (_shop_order_number = order.shop_order_number) !== null && _shop_order_number !== void 0 ? _shop_order_number : null,
+              shop_full_order_number: (_shop_full_order_numb = order.shop_full_order_number) !== null && _shop_full_order_numb !== void 0 ? _shop_full_order_numb : null,
+              need_sync: (_order$need_sync = order.need_sync) !== null && _order$need_sync !== void 0 ? _order$need_sync : null
+            };
+          })
+        };
+      });
+    }
+  }, {
+    key: "logDuplicateOrders",
+    value: function logDuplicateOrders(source, orders) {
+      var duplicateGroups = this.summarizeDuplicateOrders(orders);
+      if (duplicateGroups.length === 0) return;
+      this.logWarning('检测到重复订单身份键', {
+        source: source,
+        duplicateGroupCount: duplicateGroups.length,
+        duplicateGroups: duplicateGroups
+      });
+    }
+  }, {
+    key: "compactOrderListByIdentity",
+    value: function compactOrderListByIdentity(orders, source) {
+      var list = [];
+      var removedCount = 0;
+      var _iterator18 = _createForOfIteratorHelper(orders),
+        _step18;
+      try {
+        for (_iterator18.s(); !(_step18 = _iterator18.n()).done;) {
+          var order = _step18.value;
+          var normalizedOrder = this.normalizeOrderCollectionsForIngress(order, "".concat(source, ".order"));
+          var matchIndex = this.findOrderIndexByIdentity(list, normalizedOrder);
+          if (matchIndex < 0) {
+            list.push(normalizedOrder);
+            continue;
+          }
+          list[matchIndex] = this.mergeOrderRecords(list[matchIndex], normalizedOrder);
+          removedCount += 1;
+        }
+      } catch (err) {
+        _iterator18.e(err);
+      } finally {
+        _iterator18.f();
+      }
+      if (removedCount > 0) {
+        this.logWarning('订单列表重复项已压缩', {
+          source: source,
+          beforeCount: orders.length,
+          afterCount: list.length,
+          removedCount: removedCount
+        });
+      } else {
+        this.logDuplicateOrders(source, orders);
+      }
+      return {
+        list: list,
+        removedCount: removedCount
+      };
+    }
 
     /**
      * 当前订单拉取窗口：
@@ -730,9 +2263,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "getCurrentPullWindow",
     value: function getCurrentPullWindow() {
-      var _this$store;
+      var _this$store2;
       var now = dayjs();
-      var range = (_this$store = this.store) === null || _this$store === void 0 || (_this$store = _this$store.createdAtQuery) === null || _this$store === void 0 ? void 0 : _this$store.sales_time_between;
+      var range = (_this$store2 = this.store) === null || _this$store2 === void 0 || (_this$store2 = _this$store2.createdAtQuery) === null || _this$store2 === void 0 ? void 0 : _this$store2.sales_time_between;
       if (Array.isArray(range) && range.length >= 2) {
         var _startAt = dayjs(range[0]);
         var endExclusiveAt = dayjs(range[1]);
@@ -778,7 +2311,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         if (typeof globalThis !== 'undefined' && globalThis !== null && globalThis !== void 0 && globalThis.localStorage) {
           return globalThis.localStorage.getItem(key);
         }
-      } catch (_unused5) {
+      } catch (_unused6) {
         // 忽略存储异常，避免影响主流程
       }
       return null;
@@ -795,39 +2328,42 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
         if (typeof globalThis !== 'undefined' && globalThis !== null && globalThis !== void 0 && globalThis.localStorage) {
           globalThis.localStorage.setItem(key, value);
         }
-      } catch (_unused6) {
+      } catch (_unused7) {
         // 忽略存储异常，避免影响主流程
       }
     }
   }, {
     key: "loadOrdersFromSQLite",
     value: function () {
-      var _loadOrdersFromSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7() {
+      var _loadOrdersFromSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee17() {
+        var _this18 = this;
         var orders;
-        return _regeneratorRuntime().wrap(function _callee7$(_context7) {
-          while (1) switch (_context7.prev = _context7.next) {
+        return _regeneratorRuntime().wrap(function _callee17$(_context17) {
+          while (1) switch (_context17.prev = _context17.next) {
             case 0:
               if (this.dbManager) {
-                _context7.next = 2;
+                _context17.next = 2;
                 break;
               }
-              return _context7.abrupt("return", []);
+              return _context17.abrupt("return", []);
             case 2:
-              _context7.prev = 2;
-              _context7.next = 5;
+              _context17.prev = 2;
+              _context17.next = 5;
               return this.dbManager.getAll(INDEXDB_STORE_NAME);
             case 5:
-              orders = _context7.sent;
-              return _context7.abrupt("return", orders || []);
+              orders = _context17.sent;
+              return _context17.abrupt("return", (orders || []).map(function (order) {
+                return _this18.normalizeOrderCollectionsForIngress(order, 'loadOrdersFromSQLite');
+              }));
             case 9:
-              _context7.prev = 9;
-              _context7.t0 = _context7["catch"](2);
-              return _context7.abrupt("return", []);
+              _context17.prev = 9;
+              _context17.t0 = _context17["catch"](2);
+              return _context17.abrupt("return", []);
             case 12:
             case "end":
-              return _context7.stop();
+              return _context17.stop();
           }
-        }, _callee7, this, [[2, 9]]);
+        }, _callee17, this, [[2, 9]]);
       }));
       function loadOrdersFromSQLite() {
         return _loadOrdersFromSQLite.apply(this, arguments);
@@ -835,82 +2371,493 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return loadOrdersFromSQLite;
     }()
   }, {
-    key: "saveOrdersToSQLite",
-    value: function () {
-      var _saveOrdersToSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8(orderList) {
-        return _regeneratorRuntime().wrap(function _callee8$(_context8) {
-          while (1) switch (_context8.prev = _context8.next) {
+    key: "isPendingSyncOrder",
+    value: function isPendingSyncOrder(order) {
+      return Number(order === null || order === void 0 ? void 0 : order.need_sync) === 1;
+    }
+  }, {
+    key: "normalizeRemoteSyncedOrder",
+    value: function normalizeRemoteSyncedOrder(order) {
+      var normalizedOrder = this.normalizeOrderCollectionsForIngress(order, 'normalizeRemoteSyncedOrder');
+      if (this.isPendingSyncOrder(normalizedOrder)) return normalizedOrder;
+      return _objectSpread(_objectSpread({}, normalizedOrder), {}, {
+        need_sync: 0
+      });
+    }
+  }, {
+    key: "mergeRemoteSnapshotWithPendingOrders",
+    value: function mergeRemoteSnapshotWithPendingOrders(remoteOrders, existingOrders) {
+      var _this19 = this;
+      var merged = remoteOrders.map(function (order) {
+        return _this19.normalizeRemoteSyncedOrder(order);
+      });
+      var _iterator19 = _createForOfIteratorHelper(existingOrders),
+        _step19;
+      try {
+        for (_iterator19.s(); !(_step19 = _iterator19.n()).done;) {
+          var rawOrder = _step19.value;
+          var order = this.normalizeOrderCollectionsForIngress(rawOrder, 'mergeRemoteSnapshotWithPendingOrders.existingSQLite');
+          if (!this.isPendingSyncOrder(order)) continue;
+          var matchIndex = this.findOrderIndexByIdentity(merged, order);
+          if (matchIndex >= 0) {
+            merged[matchIndex] = this.mergeOrderRecords(order, merged[matchIndex]);
+            continue;
+          }
+          if (!this.getOrderStorageKey(order)) continue;
+          merged.push(order);
+        }
+      } catch (err) {
+        _iterator19.e(err);
+      } finally {
+        _iterator19.f();
+      }
+      return this.compactOrderListByIdentity(merged, 'mergeRemoteSnapshotWithPendingOrders').list;
+    }
+
+    /**
+     * 串行执行订单 SQLite 写入任务，避免快照替换与增量 upsert 并发交错。
+     *
+     * @example
+     * await this.runInOrderSQLiteSaveQueue(async () => {
+     *   await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, orders)
+     * })
+     */
+  }, {
+    key: "runInOrderSQLiteSaveQueue",
+    value: (function () {
+      var _runInOrderSQLiteSaveQueue = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee18(task) {
+        var queuedTask;
+        return _regeneratorRuntime().wrap(function _callee18$(_context18) {
+          while (1) switch (_context18.prev = _context18.next) {
             case 0:
-              if (this.dbManager) {
-                _context8.next = 2;
+              queuedTask = this.orderSQLiteSaveQueue.then(task, task);
+              this.orderSQLiteSaveQueue = queuedTask.then(function () {
+                return undefined;
+              }, function () {
+                return undefined;
+              });
+              return _context18.abrupt("return", queuedTask);
+            case 3:
+            case "end":
+              return _context18.stop();
+          }
+        }, _callee18, this);
+      }));
+      function runInOrderSQLiteSaveQueue(_x11) {
+        return _runInOrderSQLiteSaveQueue.apply(this, arguments);
+      }
+      return runInOrderSQLiteSaveQueue;
+    }()
+    /**
+     * 批量增量 upsert 订单到 SQLite，不清空表；用于 pubsub / HTTP 增量合并。
+     *
+     * @example
+     * await this.patchOrdersInSQLite(freshOrders)
+     */
+    )
+  }, {
+    key: "patchOrdersInSQLite",
+    value: (function () {
+      var _patchOrdersInSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee20(orders, source) {
+        var _this20 = this;
+        var mergeActions,
+          ordersSnapshot,
+          _this$filterRedundant2,
+          toWrite,
+          skipped,
+          compactedToWrite,
+          _args20 = arguments;
+        return _regeneratorRuntime().wrap(function _callee20$(_context20) {
+          while (1) switch (_context20.prev = _context20.next) {
+            case 0:
+              mergeActions = _args20.length > 2 && _args20[2] !== undefined ? _args20[2] : {};
+              if (!(!this.dbManager || orders.length === 0)) {
+                _context20.next = 3;
                 break;
               }
-              return _context8.abrupt("return");
-            case 2:
-              _context8.prev = 2;
-              _context8.next = 5;
-              return this.dbManager.clear(INDEXDB_STORE_NAME);
-            case 5:
-              if (!(orderList.length === 0)) {
-                _context8.next = 7;
+              return _context20.abrupt("return");
+            case 3:
+              ordersSnapshot = cloneDeep(orders).map(function (order) {
+                return _this20.normalizeOrderCollectionsForIngress(order, "".concat(source, ".sqliteIngress"));
+              }).filter(function (order) {
+                return _this20.getOrderStorageKey(order);
+              });
+              if (!(ordersSnapshot.length === 0)) {
+                _context20.next = 6;
                 break;
               }
-              return _context8.abrupt("return");
-            case 7:
-              _context8.next = 9;
-              return this.dbManager.bulkAdd(INDEXDB_STORE_NAME, orderList);
+              return _context20.abrupt("return");
+            case 6:
+              _this$filterRedundant2 = this.filterRedundantPatchOrders(source, ordersSnapshot, mergeActions), toWrite = _this$filterRedundant2.toWrite, skipped = _this$filterRedundant2.skipped;
+              if (!(toWrite.length === 0)) {
+                _context20.next = 9;
+                break;
+              }
+              return _context20.abrupt("return");
             case 9:
-              _context8.next = 14;
+              compactedToWrite = this.compactOrderListByIdentity(toWrite, "".concat(source, ".sqlitePatch")).list;
+              if (!(compactedToWrite.length === 0)) {
+                _context20.next = 12;
+                break;
+              }
+              return _context20.abrupt("return");
+            case 12:
+              _context20.prev = 12;
+              _context20.next = 15;
+              return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee19() {
+                var writeMethod, _iterator20, _step20, order;
+                return _regeneratorRuntime().wrap(function _callee19$(_context19) {
+                  while (1) switch (_context19.prev = _context19.next) {
+                    case 0:
+                      writeMethod = 'none';
+                      _this20.logInfo('patchOrdersInSQLite-开始', {
+                        source: source,
+                        count: compactedToWrite.length,
+                        dedupedCount: skipped.length
+                      });
+                      if (!(typeof _this20.dbManager.bulkUpdate === 'function')) {
+                        _context19.next = 8;
+                        break;
+                      }
+                      writeMethod = 'bulkUpdate';
+                      _context19.next = 6;
+                      return _this20.dbManager.bulkUpdate(INDEXDB_STORE_NAME, compactedToWrite);
+                    case 6:
+                      _context19.next = 33;
+                      break;
+                    case 8:
+                      if (!(typeof _this20.dbManager.bulkAdd === 'function')) {
+                        _context19.next = 14;
+                        break;
+                      }
+                      writeMethod = 'bulkAdd';
+                      _context19.next = 12;
+                      return _this20.dbManager.bulkAdd(INDEXDB_STORE_NAME, compactedToWrite);
+                    case 12:
+                      _context19.next = 33;
+                      break;
+                    case 14:
+                      if (!(typeof _this20.dbManager.update === 'function')) {
+                        _context19.next = 33;
+                        break;
+                      }
+                      writeMethod = 'update';
+                      _iterator20 = _createForOfIteratorHelper(compactedToWrite);
+                      _context19.prev = 17;
+                      _iterator20.s();
+                    case 19:
+                      if ((_step20 = _iterator20.n()).done) {
+                        _context19.next = 25;
+                        break;
+                      }
+                      order = _step20.value;
+                      _context19.next = 23;
+                      return _this20.dbManager.update(INDEXDB_STORE_NAME, order);
+                    case 23:
+                      _context19.next = 19;
+                      break;
+                    case 25:
+                      _context19.next = 30;
+                      break;
+                    case 27:
+                      _context19.prev = 27;
+                      _context19.t0 = _context19["catch"](17);
+                      _iterator20.e(_context19.t0);
+                    case 30:
+                      _context19.prev = 30;
+                      _iterator20.f();
+                      return _context19.finish(30);
+                    case 33:
+                      _this20.recordRecentSqliteWrite(source, compactedToWrite);
+                      _this20.logInfo('patchOrdersInSQLite-完成', {
+                        source: source,
+                        count: compactedToWrite.length,
+                        writeMethod: writeMethod,
+                        dedupedCount: skipped.length
+                      });
+                    case 35:
+                    case "end":
+                      return _context19.stop();
+                  }
+                }, _callee19, null, [[17, 27, 30, 33]]);
+              })));
+            case 15:
+              _context20.next = 20;
+              break;
+            case 17:
+              _context20.prev = 17;
+              _context20.t0 = _context20["catch"](12);
+              this.logError('增量保存订单到 SQLite 失败', {
+                error: _context20.t0 instanceof Error ? _context20.t0.message : String(_context20.t0),
+                orderCount: ordersSnapshot.length
+              });
+            case 20:
+            case "end":
+              return _context20.stop();
+          }
+        }, _callee20, this, [[12, 17]]);
+      }));
+      function patchOrdersInSQLite(_x12, _x13) {
+        return _patchOrdersInSQLite.apply(this, arguments);
+      }
+      return patchOrdersInSQLite;
+    }()
+    /**
+     * 单条 upsert 订单到 SQLite；用于 overwriteExistingOrder 等单条覆盖场景。
+     *
+     * @example
+     * await this.updateOrderInSQLite(freshOrder)
+     */
+    )
+  }, {
+    key: "updateOrderInSQLite",
+    value: (function () {
+      var _updateOrderInSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee22(order, source) {
+        var _this21 = this;
+        var orderSnapshot, _orderSnapshot$order_3;
+        return _regeneratorRuntime().wrap(function _callee22$(_context22) {
+          while (1) switch (_context22.prev = _context22.next) {
+            case 0:
+              if (!(!this.dbManager || !this.getOrderStorageKey(order))) {
+                _context22.next = 2;
+                break;
+              }
+              return _context22.abrupt("return");
+            case 2:
+              orderSnapshot = this.normalizeOrderCollectionsForIngress(cloneDeep(order), "".concat(source, ".sqliteIngress"));
+              _context22.prev = 3;
+              _context22.next = 6;
+              return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee21() {
+                var _orderSnapshot$order_, _orderSnapshot$order_2;
+                var writeMethod;
+                return _regeneratorRuntime().wrap(function _callee21$(_context21) {
+                  while (1) switch (_context21.prev = _context21.next) {
+                    case 0:
+                      writeMethod = 'none';
+                      _this21.logInfo('updateOrderInSQLite-开始', {
+                        source: source,
+                        orderId: (_orderSnapshot$order_ = orderSnapshot.order_id) !== null && _orderSnapshot$order_ !== void 0 ? _orderSnapshot$order_ : null,
+                        storageKey: _this21.getOrderStorageKey(orderSnapshot)
+                      });
+                      if (!(typeof _this21.dbManager.update === 'function')) {
+                        _context21.next = 8;
+                        break;
+                      }
+                      writeMethod = 'update';
+                      _context21.next = 6;
+                      return _this21.dbManager.update(INDEXDB_STORE_NAME, orderSnapshot);
+                    case 6:
+                      _context21.next = 18;
+                      break;
+                    case 8:
+                      if (!(typeof _this21.dbManager.bulkUpdate === 'function')) {
+                        _context21.next = 14;
+                        break;
+                      }
+                      writeMethod = 'bulkUpdate';
+                      _context21.next = 12;
+                      return _this21.dbManager.bulkUpdate(INDEXDB_STORE_NAME, [orderSnapshot]);
+                    case 12:
+                      _context21.next = 18;
+                      break;
+                    case 14:
+                      if (!(typeof _this21.dbManager.bulkAdd === 'function')) {
+                        _context21.next = 18;
+                        break;
+                      }
+                      writeMethod = 'bulkAdd';
+                      _context21.next = 18;
+                      return _this21.dbManager.bulkAdd(INDEXDB_STORE_NAME, [orderSnapshot]);
+                    case 18:
+                      _this21.recordRecentSqliteWrite(source, [orderSnapshot]);
+                      _this21.logInfo('updateOrderInSQLite-完成', {
+                        source: source,
+                        orderId: (_orderSnapshot$order_2 = orderSnapshot.order_id) !== null && _orderSnapshot$order_2 !== void 0 ? _orderSnapshot$order_2 : null,
+                        writeMethod: writeMethod
+                      });
+                    case 20:
+                    case "end":
+                      return _context21.stop();
+                  }
+                }, _callee21);
+              })));
+            case 6:
+              _context22.next = 11;
               break;
+            case 8:
+              _context22.prev = 8;
+              _context22.t0 = _context22["catch"](3);
+              this.logError('单条保存订单到 SQLite 失败', {
+                error: _context22.t0 instanceof Error ? _context22.t0.message : String(_context22.t0),
+                orderId: (_orderSnapshot$order_3 = orderSnapshot.order_id) !== null && _orderSnapshot$order_3 !== void 0 ? _orderSnapshot$order_3 : null
+              });
             case 11:
-              _context8.prev = 11;
-              _context8.t0 = _context8["catch"](2);
-              // SQLite 异常，避免影响主流程
-              this.logError('保存订单到 SQLite 失败', {
-                error: _context8.t0 instanceof Error ? _context8.t0.message : String(_context8.t0),
-                orderList: orderList.length
+            case "end":
+              return _context22.stop();
+          }
+        }, _callee22, this, [[3, 8]]);
+      }));
+      function updateOrderInSQLite(_x14, _x15) {
+        return _updateOrderInSQLite.apply(this, arguments);
+      }
+      return updateOrderInSQLite;
+    }()
+    /**
+     * 全量快照替换 orders 表（clear + bulkAdd），用于 SSE 全量拉取与营业日窗口裁剪。
+     *
+     * @example
+     * await this.replaceOrdersSnapshotInSQLite(orderList)
+     */
+    )
+  }, {
+    key: "replaceOrdersSnapshotInSQLite",
+    value: (function () {
+      var _replaceOrdersSnapshotInSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee24(orderList, source) {
+        var _this22 = this;
+        var remoteSnapshot, mergedSnapshot;
+        return _regeneratorRuntime().wrap(function _callee24$(_context24) {
+          while (1) switch (_context24.prev = _context24.next) {
+            case 0:
+              if (this.dbManager) {
+                _context24.next = 2;
+                break;
+              }
+              return _context24.abrupt("return", this.compactOrderListByIdentity(orderList.map(function (order) {
+                return _this22.normalizeRemoteSyncedOrder(order);
+              }), "".concat(source, ".snapshotNoDb")).list);
+            case 2:
+              remoteSnapshot = cloneDeep(orderList).map(function (order) {
+                return _this22.normalizeOrderCollectionsForIngress(order, "".concat(source, ".remoteIngress"));
               });
-            case 14:
+              mergedSnapshot = this.compactOrderListByIdentity(remoteSnapshot.map(function (order) {
+                return _this22.normalizeRemoteSyncedOrder(order);
+              }), "".concat(source, ".remoteSnapshot")).list;
+              _context24.prev = 4;
+              _context24.next = 7;
+              return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee23() {
+                var existingOrders, orderListSnapshot;
+                return _regeneratorRuntime().wrap(function _callee23$(_context23) {
+                  while (1) switch (_context23.prev = _context23.next) {
+                    case 0:
+                      if (!(typeof _this22.dbManager.getAll === 'function')) {
+                        _context23.next = 6;
+                        break;
+                      }
+                      _context23.next = 3;
+                      return _this22.dbManager.getAll(INDEXDB_STORE_NAME);
+                    case 3:
+                      _context23.t0 = _context23.sent;
+                      _context23.next = 7;
+                      break;
+                    case 6:
+                      _context23.t0 = [];
+                    case 7:
+                      existingOrders = _context23.t0;
+                      orderListSnapshot = _this22.mergeRemoteSnapshotWithPendingOrders(remoteSnapshot, existingOrders || []);
+                      mergedSnapshot = _this22.compactOrderListByIdentity(orderListSnapshot, "".concat(source, ".sqliteSnapshot")).list;
+                      _this22.logInfo('replaceOrdersSnapshotInSQLite-开始', {
+                        source: source,
+                        count: mergedSnapshot.length,
+                        remoteCount: remoteSnapshot.length,
+                        preservedPendingCount: mergedSnapshot.length - remoteSnapshot.length
+                      });
+                      _context23.next = 13;
+                      return _this22.dbManager.clear(INDEXDB_STORE_NAME);
+                    case 13:
+                      _this22.logInfo('replaceOrdersSnapshotInSQLite-clear完成', {
+                        count: mergedSnapshot.length
+                      });
+                      if (!(mergedSnapshot.length === 0)) {
+                        _context23.next = 16;
+                        break;
+                      }
+                      return _context23.abrupt("return");
+                    case 16:
+                      _context23.next = 18;
+                      return _this22.dbManager.bulkAdd(INDEXDB_STORE_NAME, mergedSnapshot);
+                    case 18:
+                      _this22.recordRecentSqliteWrite(source, mergedSnapshot);
+                      _this22.logInfo('replaceOrdersSnapshotInSQLite-bulkAdd完成', {
+                        source: source,
+                        count: mergedSnapshot.length
+                      });
+                    case 20:
+                    case "end":
+                      return _context23.stop();
+                  }
+                }, _callee23);
+              })));
+            case 7:
+              _context24.next = 12;
+              break;
+            case 9:
+              _context24.prev = 9;
+              _context24.t0 = _context24["catch"](4);
+              this.logError('全量保存订单到 SQLite 失败', {
+                error: _context24.t0 instanceof Error ? _context24.t0.message : String(_context24.t0),
+                orderList: remoteSnapshot.length
+              });
+            case 12:
+              return _context24.abrupt("return", mergedSnapshot);
+            case 13:
             case "end":
-              return _context8.stop();
+              return _context24.stop();
           }
-        }, _callee8, this, [[2, 11]]);
+        }, _callee24, this, [[4, 9]]);
       }));
-      function saveOrdersToSQLite(_x5) {
-        return _saveOrdersToSQLite.apply(this, arguments);
+      function replaceOrdersSnapshotInSQLite(_x16, _x17) {
+        return _replaceOrdersSnapshotInSQLite.apply(this, arguments);
       }
-      return saveOrdersToSQLite;
+      return replaceOrdersSnapshotInSQLite;
     }()
+    /**
+     * 清空订单模块的内存数据和本地 SQLite 订单表。
+     *
+     * @example
+     * await orderModule.clear()
+     */
+    )
   }, {
     key: "clear",
-    value: function () {
-      var _clear = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9() {
-        return _regeneratorRuntime().wrap(function _callee9$(_context9) {
-          while (1) switch (_context9.prev = _context9.next) {
+    value: (function () {
+      var _clear = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee26() {
+        var _this23 = this;
+        return _regeneratorRuntime().wrap(function _callee26$(_context26) {
+          while (1) switch (_context26.prev = _context26.next) {
             case 0:
               this.store.list = [];
               this.store.map = new Map();
-              this.resourceIdIndex.clear();
               if (!this.dbManager) {
-                _context9.next = 6;
+                _context26.next = 5;
                 break;
               }
-              _context9.next = 6;
-              return this.dbManager.clear(INDEXDB_STORE_NAME);
-            case 6:
+              _context26.next = 5;
+              return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee25() {
+                return _regeneratorRuntime().wrap(function _callee25$(_context25) {
+                  while (1) switch (_context25.prev = _context25.next) {
+                    case 0:
+                      _context25.next = 2;
+                      return _this23.dbManager.clear(INDEXDB_STORE_NAME);
+                    case 2:
+                    case "end":
+                      return _context25.stop();
+                  }
+                }, _callee25);
+              })));
+            case 5:
               this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, '');
-              this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
-            case 8:
+              this.emitOrdersChanged([], 'clear');
+            case 7:
             case "end":
-              return _context9.stop();
+              return _context26.stop();
           }
-        }, _callee9, this);
+        }, _callee26, this);
       }));
       function clear() {
         return _clear.apply(this, arguments);
       }
       return clear;
-    }()
+    }())
   }]);
   return OrderModule;
 }(BaseModule);