@pisell/pisellos 2.2.244 → 2.2.245

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; }
@@ -38,6 +42,12 @@ 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']);
 
 /**
  * Order 模块 - 基础框架
@@ -63,16 +73,64 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     _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: "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;
+              console.log('触发emitOrdersChanged');
+              payload = {
+                list: this.store.list,
+                changedOrders: changedOrders.map(function (order) {
+                  return _this2.normalizeOrderForMemoryList(order);
+                }),
+                source: source
+              };
+              _context.next = 6;
+              return this.core.effects.emit(OrderHooks.onOrdersChanged, payload);
+            case 6:
+            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 _callee(core, options) {
-        var _options$initialState;
+      var _initialize = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(core, options) {
+        var _options$initialState,
+          _this3 = this;
         var appPlugin, app;
-        return _regeneratorRuntime().wrap(function _callee$(_context) {
-          while (1) switch (_context.prev = _context.next) {
+        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;
@@ -86,9 +144,11 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 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();
@@ -102,9 +162,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);
@@ -152,6 +212,231 @@ 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 写入，供 pubsub 回声去重使用。
+     *
+     * @example
+     * this.recordRecentSqliteWrite('upsertOrdersFromRemote', orders)
+     */
+  }, {
+    key: "recordRecentSqliteWrite",
+    value: function recordRecentSqliteWrite(source, orders) {
+      var now = Date.now();
+      var _iterator = _createForOfIteratorHelper(orders),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var order = _step.value;
+          var storageKey = this.getOrderStorageKey(order);
+          if (!storageKey) continue;
+          this.recentSqliteWriteByStorageKey.set(storageKey, {
+            source: source,
+            ts: now
+          });
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.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 _iterator2 = _createForOfIteratorHelper(orders),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var order = _step2.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_id;
+            skipped.push({
+              orderId: (_order$order_id = order.order_id) !== null && _order$order_id !== void 0 ? _order$order_id : null,
+              storageKey: storageKey,
+              reason: 'skip_pubsub_echo_after_business_write',
+              lastSource: recent.source,
+              elapsedMs: now - recent.ts
+            });
+            continue;
+          }
+          toWrite.push(order);
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.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 _iterator3 = _createForOfIteratorHelper(ids),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var id = _step3.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) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.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() {
@@ -207,13 +492,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "preload",
     value: function () {
-      var _preload = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
-        var _this2 = this;
+      var _preload = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+        var _this4 = this;
         var getData;
-        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
-          while (1) switch (_context3.prev = _context3.next) {
+        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
             case 0:
-              // const cachedOrders = await this.loadOrdersFromSQLite()
               // const hasPulledInCurrentWindow = this.hasPulledOrdersToday()
               // // 仅当缓存属于当前统计窗口时才直接复用，避免跨天/跨营业日窗口继续使用旧数据
               // if (cachedOrders.length > 0 && hasPulledInCurrentWindow) {
@@ -229,30 +513,30 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               //   return
               // }
               getData = /*#__PURE__*/function () {
-                var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+                var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
                   var orders;
-                  return _regeneratorRuntime().wrap(function _callee2$(_context2) {
-                    while (1) switch (_context2.prev = _context2.next) {
+                  return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+                    while (1) switch (_context3.prev = _context3.next) {
                       case 0:
-                        _context2.next = 2;
-                        return _this2.loadOrdersByServer();
+                        _context3.next = 2;
+                        return _this4.loadOrdersByServer();
                       case 2:
-                        orders = _context2.sent;
+                        orders = _context3.sent;
                         if (!(orders.length === 0)) {
-                          _context2.next = 5;
+                          _context3.next = 5;
                           break;
                         }
-                        return _context2.abrupt("return");
+                        return _context3.abrupt("return");
                       case 5:
-                        _this2.store.list = cloneDeep(orders);
-                        _this2.syncOrdersMap();
-                        _this2.core.effects.emit(OrderHooks.onOrdersChanged, _this2.store.list);
-                        _this2.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
+                        _this4.store.list = cloneDeep(orders);
+                        _this4.syncOrdersMap();
+                        _this4.emitOrdersChanged([], 'preload');
+                        _this4.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
                       case 9:
                       case "end":
-                        return _context2.stop();
+                        return _context3.stop();
                     }
-                  }, _callee2);
+                  }, _callee3);
                 }));
                 return function getData() {
                   return _ref.apply(this, arguments);
@@ -261,9 +545,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               getData();
             case 2:
             case "end":
-              return _context3.stop();
+              return _context4.stop();
           }
-        }, _callee3);
+        }, _callee4);
       }));
       function preload() {
         return _preload.apply(this, arguments);
@@ -281,68 +565,88 @@ 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: "getLocalOrderByOrderId",
+    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 _getLocalOrderByOrderId = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(orderId) {
-        var _this3 = this;
-        var key, memoryOrder, orders, localOrder;
-        return _regeneratorRuntime().wrap(function _callee4$(_context4) {
-          while (1) switch (_context4.prev = _context4.next) {
+      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(orderId);
-              memoryOrder = this.store.map.get(key);
-              if (!memoryOrder) {
-                _context4.next = 4;
+              key = this.getIdKey(lookup);
+              memoryOrderById = this.store.map.get(key);
+              if (!memoryOrderById) {
+                _context5.next = 4;
                 break;
               }
-              return _context4.abrupt("return", memoryOrder);
+              return _context5.abrupt("return", memoryOrderById);
             case 4:
-              _context4.next = 6;
+              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 6:
-              orders = _context4.sent;
+            case 9:
+              orders = _context5.sent;
               localOrder = orders.find(function (order) {
-                var shopOrderNumber = order === null || order === void 0 ? void 0 : order.shop_order_number;
-                if (shopOrderNumber && _this3.getIdKey(shopOrderNumber) === key) return true;
-                var id = order === null || order === void 0 ? void 0 : order.order_id;
-                if (id === undefined || id === null) return false;
-                return _this3.getIdKey(id) === key;
+                return _this6.isOrderLookupMatch(order, key);
               });
               if (localOrder) {
-                _context4.next = 10;
+                _context5.next = 13;
                 break;
               }
-              return _context4.abrupt("return", null);
-            case 10:
-              this.store.list = orders;
-              this.syncOrdersMap();
-              return _context4.abrupt("return", localOrder);
+              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 _context4.stop();
+              return _context5.stop();
           }
-        }, _callee4, this);
+        }, _callee5, this);
       }));
-      function getLocalOrderByOrderId(_x3) {
-        return _getLocalOrderByOrderId.apply(this, arguments);
+      function getLocalOrderByLookup(_x3) {
+        return _getLocalOrderByLookup.apply(this, arguments);
       }
-      return getLocalOrderByOrderId;
+      return getLocalOrderByLookup;
     }()
   }, {
     key: "loadOrdersByServer",
     value: function () {
-      var _loadOrdersByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
-        var _this$store;
-        var orderList, data;
-        return _regeneratorRuntime().wrap(function _callee5$(_context5) {
-          while (1) switch (_context5.prev = _context5.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-开始', {
@@ -350,46 +654,51 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 query: ((_this$store = this.store) === null || _this$store === void 0 ? void 0 : _this$store.createdAtQuery) || null
               });
               if (!this.orderDataSource) {
-                _context5.next = 16;
+                _context6.next = 17;
                 break;
               }
-              _context5.prev = 3;
-              _context5.next = 6;
+              _context6.prev = 3;
+              _context6.next = 6;
               return this.orderDataSource.run({
                 sse: {
                   query: this.store.createdAtQuery
                 }
               });
             case 6:
-              data = _context5.sent;
+              data = _context6.sent;
               orderList = data || [];
               this.logInfo('loadOrdersByServer-SSE拉取成功', {
                 count: orderList.length
               });
               this.markOrderPulledAtNow();
-              _context5.next = 16;
+              this.lastServerFullFetchAtMs = Date.now();
+              _context6.next = 17;
               break;
-            case 12:
-              _context5.prev = 12;
-              _context5.t0 = _context5["catch"](3);
-              orderList = [];
-              this.logInfo('loadOrdersByServer-SSE拉取失败，回退为空数组');
-            case 16:
-              _context5.next = 18;
-              return this.saveOrdersToSQLite(orderList);
-            case 18:
+            case 13:
+              _context6.prev = 13;
+              _context6.t0 = _context6["catch"](3);
+              this.logInfo('loadOrdersByServer-SSE拉取失败，保持当前内存订单');
+              return _context6.abrupt("return", this.store.list);
+            case 17:
+              _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: orderList.length
+                count: memoryOrders.length
               });
-              _context5.next = 21;
-              return this.core.effects.emit(OrderHooks.onOrdersLoaded, orderList);
-            case 21:
-              return _context5.abrupt("return", orderList);
-            case 22:
+              _context6.next = 24;
+              return this.core.effects.emit(OrderHooks.onOrdersLoaded, memoryOrders);
+            case 24:
+              return _context6.abrupt("return", memoryOrders);
+            case 25:
             case "end":
-              return _context5.stop();
+              return _context6.stop();
           }
-        }, _callee5, this, [[3, 12]]);
+        }, _callee6, this, [[3, 13]]);
       }));
       function loadOrdersByServer() {
         return _loadOrdersByServer.apply(this, arguments);
@@ -404,54 +713,61 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "silentRefresh",
     value: (function () {
-      var _silentRefresh = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
-        var startTime, orders, errorMessage;
-        return _regeneratorRuntime().wrap(function _callee6$(_context6) {
-          while (1) switch (_context6.prev = _context6.next) {
+      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 开始');
-              _context6.prev = 2;
+              _context7.prev = 5;
               // 刷新前，需要更新当前营业日边界（store.createdAtQuery）
               this.updateCreateStore();
-              _context6.next = 6;
+              _context7.next = 9;
               return this.loadOrdersByServer();
-            case 6:
-              orders = _context6.sent;
+            case 9:
+              orders = _context7.sent;
               if (!(orders.length > 0)) {
-                _context6.next = 16;
+                _context7.next = 19;
                 break;
               }
               this.store.list = cloneDeep(orders);
               this.syncOrdersMap();
-              this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
-              _context6.next = 13;
+              this.emitOrdersChanged([], 'silentRefresh');
+              _context7.next = 16;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 13:
+            case 16:
               this.logInfo('silentRefresh 完成', {
                 orderCount: orders.length,
                 duration: "".concat(Date.now() - startTime, "ms")
               });
-              _context6.next = 17;
+              _context7.next = 20;
               break;
-            case 16:
+            case 19:
               this.logInfo('silentRefresh: 服务器未返回数据');
-            case 17:
-              return _context6.abrupt("return", this.store.list);
             case 20:
-              _context6.prev = 20;
-              _context6.t0 = _context6["catch"](2);
-              errorMessage = _context6.t0 instanceof Error ? _context6.t0.message : String(_context6.t0);
+              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 _context6.abrupt("return", this.store.list);
-            case 25:
+              return _context7.abrupt("return", this.store.list);
+            case 28:
             case "end":
-              return _context6.stop();
+              return _context7.stop();
           }
-        }, _callee6, this, [[2, 20]]);
+        }, _callee7, this, [[5, 23]]);
       }));
       function silentRefresh() {
         return _silentRefresh.apply(this, arguments);
@@ -461,14 +777,28 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "getOrdersByResourceId",
     value: function getOrdersByResourceId(resourceId) {
-      var _this4 = this;
+      var _this8 = this;
       var ids = this.resourceIdIndex.get(String(resourceId)) || [];
       return ids.map(function (id) {
-        return _this4.store.map.get(id);
+        return _this8.store.map.get(id);
       }).filter(function (order) {
         return !!order;
       });
     }
+  }, {
+    key: "normalizeOrderForMemoryList",
+    value: function normalizeOrderForMemoryList(order) {
+      var externalSaleNumber = order === null || order === void 0 ? void 0 : order.external_sale_number;
+      if ((order === null || order === void 0 ? void 0 : order.order_id) !== undefined && (order === null || order === void 0 ? void 0 : order.order_id) !== null && (order === null || order === void 0 ? void 0 : order.order_id) !== '') {
+        return order;
+      }
+      if (externalSaleNumber === undefined || externalSaleNumber === null || externalSaleNumber === '') {
+        return order;
+      }
+      return _objectSpread(_objectSpread({}, order), {}, {
+        order_id: externalSaleNumber
+      });
+    }
 
     /**
      * 仅覆盖本地已存在的订单；不存在则直接跳过，不落库、不 emit。
@@ -477,31 +807,31 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "overwriteExistingOrder",
     value: (function () {
-      var _overwriteExistingOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7(fresh) {
-        var _this5 = this;
+      var _overwriteExistingOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8(fresh) {
+        var _this9 = this;
         var orderId, key;
-        return _regeneratorRuntime().wrap(function _callee7$(_context7) {
-          while (1) switch (_context7.prev = _context7.next) {
+        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)) {
-                _context7.next = 4;
+                _context8.next = 4;
                 break;
               }
               this.logError('overwriteExistingOrder-入参缺少 order_id');
-              return _context7.abrupt("return", {
+              return _context8.abrupt("return", {
                 overwritten: false
               });
             case 4:
               key = this.getIdKey(orderId);
               if (this.store.map.has(key)) {
-                _context7.next = 8;
+                _context8.next = 8;
                 break;
               }
               this.logInfo('overwriteExistingOrder-本地不存在该订单，跳过', {
                 orderId: orderId
               });
-              return _context7.abrupt("return", {
+              return _context8.abrupt("return", {
                 overwritten: false
               });
             case 8:
@@ -512,27 +842,27 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               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 order;
-                return _this5.getIdKey(id) === key ? fresh : order;
+                return _this9.getIdKey(id) === key ? fresh : order;
               });
               this.syncOrdersMap();
-              _context7.next = 13;
-              return this.saveOrdersToSQLite(this.store.list);
+              _context8.next = 13;
+              return this.updateOrderInSQLite(fresh, 'overwriteExistingOrder');
             case 13:
               this.logInfo('overwriteExistingOrder-结束', {
                 orderId: orderId,
                 storeOrderCountAfter: this.store.list.length
               });
-              _context7.next = 16;
-              return this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
+              _context8.next = 16;
+              return this.emitOrdersChanged([fresh], 'overwriteExistingOrder');
             case 16:
-              return _context7.abrupt("return", {
+              return _context8.abrupt("return", {
                 overwritten: true
               });
             case 17:
             case "end":
-              return _context7.stop();
+              return _context8.stop();
           }
-        }, _callee7, this);
+        }, _callee8, this);
       }));
       function overwriteExistingOrder(_x4) {
         return _overwriteExistingOrder.apply(this, arguments);
@@ -547,90 +877,302 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "upsertOrdersFromRemote",
     value: (function () {
-      var _upsertOrdersFromRemote = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8(freshOrders) {
-        return _regeneratorRuntime().wrap(function _callee8$(_context8) {
-          while (1) switch (_context8.prev = _context8.next) {
+      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) {
-                _context8.next = 3;
+                _context9.next = 3;
                 break;
               }
               this.logInfo('upsertOrdersFromRemote-订单列表为空', {});
-              return _context8.abrupt("return");
+              return _context9.abrupt("return");
             case 3:
               this.logInfo('upsertOrdersFromRemote-开始', {
                 count: freshOrders.length
               });
-              _context8.next = 6;
-              return this.mergeOrdersToStore(freshOrders);
+              _context9.next = 6;
+              return this.mergeOrdersToStore(freshOrders, 'upsertOrdersFromRemote');
             case 6:
             case "end":
-              return _context8.stop();
+              return _context9.stop();
           }
-        }, _callee8, this);
+        }, _callee9, this);
       }));
       function upsertOrdersFromRemote(_x5) {
         return _upsertOrdersFromRemote.apply(this, arguments);
       }
       return upsertOrdersFromRemote;
-    }()
-    /**
-     * 通过 SSE 按自定义 query 拉取订单（支持 select/with 精简字段）
-     */
-    )
+    }())
   }, {
-    key: "fetchOrdersBySSE",
-    value: (function () {
-      var _fetchOrdersBySSE = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9() {
-        var query,
-          data,
-          _args9 = arguments;
-        return _regeneratorRuntime().wrap(function _callee9$(_context9) {
-          while (1) switch (_context9.prev = _context9.next) {
+    key: "markOrderSyncedByExternalSaleNumber",
+    value: function () {
+      var _markOrderSyncedByExternalSaleNumber = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10(params) {
+        var _this10 = 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:
-              query = _args9.length > 0 && _args9[0] !== undefined ? _args9[0] : {};
-              if (this.orderDataSource) {
-                _context9.next = 3;
+              externalSaleNumber = params.externalSaleNumber;
+              if (!(externalSaleNumber === undefined || externalSaleNumber === null || externalSaleNumber === '')) {
+                _context10.next = 4;
                 break;
               }
-              return _context9.abrupt("return", []);
-            case 3:
-              _context9.prev = 3;
-              _context9.next = 6;
-              return this.orderDataSource.run({
-                sse: {
-                  query: query
-                }
+              this.logError('markOrderSyncedByExternalSaleNumber-缺少 external_sale_number');
+              return _context10.abrupt("return", {
+                updated: false
               });
-            case 6:
-              data = _context9.sent;
-              return _context9.abrupt("return", data || []);
-            case 10:
-              _context9.prev = 10;
-              _context9.t0 = _context9["catch"](3);
-              this.logError('fetchOrdersBySSE-失败', {
-                error: _context9.t0 instanceof Error ? _context9.t0.message : String(_context9.t0)
+            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 _this10.getIdKey(value) === key;
               });
-              return _context9.abrupt("return", []);
-            case 14:
+              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 _context9.stop();
+              return _context10.stop();
           }
-        }, _callee9, this, [[3, 10]]);
+        }, _callee10, this);
       }));
-      function fetchOrdersBySSE() {
-        return _fetchOrdersBySSE.apply(this, arguments);
+      function markOrderSyncedByExternalSaleNumber(_x6) {
+        return _markOrderSyncedByExternalSaleNumber.apply(this, arguments);
       }
-      return fetchOrdersBySSE;
-    }())
-  }, {
-    key: "getRoutes",
-    value: function getRoutes() {
-      return [];
-    }
+      return markOrderSyncedByExternalSaleNumber;
+    }()
+    /**
+     * 将本地待同步订单按 SQLite storage key 合并进 store 并落库。
+     * checkout 离线兜底可能没有 order_id，但通常会有 external_sale_number。
+     */
   }, {
-    key: "destroy",
-    value: function destroy() {
+    key: "upsertPendingSyncOrders",
+    value: (function () {
+      var _upsertPendingSyncOrders = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11(pendingOrders) {
+        var pendingMap, memoryPendingMap, _iterator4, _step4, order, storageKey, patchedOrders, mergeActions, updatedList, _iterator5, _step5, _step5$value, _storageKey, pendingOrder, matchIndex, _iterator6, _step6, _step6$value, _storageKey2, _order;
+        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();
+              _iterator4 = _createForOfIteratorHelper(pendingOrders);
+              _context11.prev = 6;
+              _iterator4.s();
+            case 8:
+              if ((_step4 = _iterator4.n()).done) {
+                _context11.next = 17;
+                break;
+              }
+              order = _step4.value;
+              storageKey = this.getOrderStorageKey(order);
+              if (storageKey) {
+                _context11.next = 13;
+                break;
+              }
+              return _context11.abrupt("continue", 15);
+            case 13:
+              pendingMap.set(storageKey, order);
+              memoryPendingMap.set(storageKey, this.normalizeOrderForMemoryList(order));
+            case 15:
+              _context11.next = 8;
+              break;
+            case 17:
+              _context11.next = 22;
+              break;
+            case 19:
+              _context11.prev = 19;
+              _context11.t0 = _context11["catch"](6);
+              _iterator4.e(_context11.t0);
+            case 22:
+              _context11.prev = 22;
+              _iterator4.f();
+              return _context11.finish(22);
+            case 25:
+              if (!(pendingMap.size === 0)) {
+                _context11.next = 28;
+                break;
+              }
+              this.logError('upsertPendingSyncOrders-订单缺少可落库标识', {
+                count: pendingOrders.length
+              });
+              return _context11.abrupt("return");
+            case 28:
+              this.logInfo('upsertPendingSyncOrders-开始', {
+                count: pendingMap.size
+              });
+              patchedOrders = _toConsumableArray(pendingMap.values());
+              mergeActions = {};
+              updatedList = _toConsumableArray(this.store.list);
+              _iterator5 = _createForOfIteratorHelper(memoryPendingMap.entries());
+              _context11.prev = 33;
+              _iterator5.s();
+            case 35:
+              if ((_step5 = _iterator5.n()).done) {
+                _context11.next = 46;
+                break;
+              }
+              _step5$value = _slicedToArray(_step5.value, 2), _storageKey = _step5$value[0], pendingOrder = _step5$value[1];
+              matchIndex = this.findOrderIndexByIdentity(updatedList, pendingOrder);
+              if (!(matchIndex < 0)) {
+                _context11.next = 40;
+                break;
+              }
+              return _context11.abrupt("continue", 44);
+            case 40:
+              updatedList[matchIndex] = this.mergeOrderRecords(updatedList[matchIndex], pendingOrder);
+              pendingMap.delete(_storageKey);
+              memoryPendingMap.delete(_storageKey);
+              mergeActions[_storageKey] = 'update';
+            case 44:
+              _context11.next = 35;
+              break;
+            case 46:
+              _context11.next = 51;
+              break;
+            case 48:
+              _context11.prev = 48;
+              _context11.t1 = _context11["catch"](33);
+              _iterator5.e(_context11.t1);
+            case 51:
+              _context11.prev = 51;
+              _iterator5.f();
+              return _context11.finish(51);
+            case 54:
+              _iterator6 = _createForOfIteratorHelper(memoryPendingMap.entries());
+              try {
+                for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
+                  _step6$value = _slicedToArray(_step6.value, 2), _storageKey2 = _step6$value[0], _order = _step6$value[1];
+                  mergeActions[_storageKey2] = 'insert';
+                  updatedList.push(_order);
+                }
+              } catch (err) {
+                _iterator6.e(err);
+              } finally {
+                _iterator6.f();
+              }
+              this.store.list = this.compactOrderListByIdentity(updatedList, 'upsertPendingSyncOrders.store').list;
+              this.syncOrdersMap();
+              _context11.next = 60;
+              return this.patchOrdersInSQLite(patchedOrders, 'upsertPendingSyncOrders', mergeActions);
+            case 60:
+              this.logInfo('upsertPendingSyncOrders-结束', {
+                count: patchedOrders.length,
+                storeOrderCountAfter: this.store.list.length
+              });
+              _context11.next = 63;
+              return this.emitOrdersChanged(patchedOrders, 'upsertPendingSyncOrders');
+            case 63:
+            case "end":
+              return _context11.stop();
+          }
+        }, _callee11, this, [[6, 19, 22, 25], [33, 48, 51, 54]]);
+      }));
+      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() {
+      return [];
+    }
+  }, {
+    key: "destroy",
+    value: function destroy() {
       var _this$orderDataSource;
       if (this.syncTimer) {
         clearTimeout(this.syncTimer);
@@ -644,45 +1186,120 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "syncOrdersMap",
     value: function syncOrdersMap() {
-      var _this6 = this;
+      var _this11 = this;
       this.store.map.clear();
       this.resourceIdIndex.clear();
-      var _iterator = _createForOfIteratorHelper(this.store.list),
-        _step;
+      var _iterator7 = _createForOfIteratorHelper(this.store.list),
+        _step7;
       try {
         var _loop = function _loop() {
-          var order = _step.value;
-          var id = order.order_id;
-          if (id === undefined || id === null) return 1; // continue
-          _this6.store.map.set(_this6.getIdKey(id), order);
-          var resourceIds = _this6.extractResourceIds(order);
-          var _iterator2 = _createForOfIteratorHelper(resourceIds),
-            _step2;
+          var order = _step7.value;
+          var primaryIdentity = _this11.getOrderMapKey(order);
+          if (!primaryIdentity) return 1; // continue
+          _this11.store.map.set(primaryIdentity, order);
+          var resourceIds = _this11.extractResourceIds(order);
+          var _iterator8 = _createForOfIteratorHelper(resourceIds),
+            _step8;
           try {
-            for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-              var resourceId = _step2.value;
+            for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
+              var resourceId = _step8.value;
               var key = String(resourceId);
-              var existing = _this6.resourceIdIndex.get(key) || [];
+              var existing = _this11.resourceIdIndex.get(key) || [];
               if (existing.some(function (eid) {
-                return _this6.getIdKey(eid) === _this6.getIdKey(id);
+                return _this11.getIdKey(eid) === primaryIdentity;
               })) continue;
-              existing.push(id);
-              _this6.resourceIdIndex.set(key, existing);
+              existing.push(primaryIdentity);
+              _this11.resourceIdIndex.set(key, existing);
             }
           } catch (err) {
-            _iterator2.e(err);
+            _iterator8.e(err);
           } finally {
-            _iterator2.f();
+            _iterator8.f();
           }
         };
-        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
           if (_loop()) continue;
         }
       } catch (err) {
-        _iterator.e(err);
+        _iterator7.e(err);
       } finally {
-        _iterator.f();
+        _iterator7.f();
+      }
+    }
+  }, {
+    key: "getOrderMapKey",
+    value: function getOrderMapKey(order) {
+      if (!order) return '';
+      if (!this.isBlankIdentityValue(order.order_id)) {
+        return this.getIdKey(order.order_id);
+      }
+      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 _this12 = 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 _loop2 = function _loop2() {
+          var candidate = _candidates[_i];
+          if (_this12.isBlankIdentityValue(candidate.value)) return 0; // continue
+          var key = _this12.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 _i = 0, _candidates = candidates; _i < _candidates.length; _i++) {
+        _ret = _loop2();
+        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: "extractResourceIds",
@@ -708,8 +1325,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     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 _i2 = 0, _candidates2 = candidates; _i2 < _candidates2.length; _i2++) {
+        var v = _candidates2[_i2];
         if (!v) continue;
         var text = String(v);
         if (!text) continue;
@@ -736,28 +1353,30 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "setupOrderSync",
     value: function setupOrderSync() {
-      var _this7 = this;
+      var _this13 = this;
       if (!this.orderDataSource) return;
       this.orderDataSource.run({
         pubsub: {
           callback: function callback(res) {
             var _message$id, _message$order_id, _message$type;
-            console.log('orderDataSource');
+            console.log('orderDataSource', res);
             var pubsubReceivedAt = Date.now();
-            var message = _this7.normalizeOrderSyncMessage(res);
+            var message = _this13.normalizeOrderSyncMessage(res);
             if (!message) return;
             message._pubsubReceivedAt = pubsubReceivedAt;
-            _this7.pendingSyncMessages.push(message);
-            var throttleMs = _this7.getOrderSyncThrottleMs();
-            _this7.logInfo('orderSync-收到消息并入队', {
+            _this13.pendingSyncMessages.push(message);
+            var throttleMs = _this13.getOrderSyncThrottleMs();
+            var routeInfo = _this13.resolveSyncMessageRoute(message);
+            _this13.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: _this7.pendingSyncMessages.length,
+              pendingCount: _this13.pendingSyncMessages.length,
               throttleMs: throttleMs,
-              pubsubReceivedAt: new Date(pubsubReceivedAt).toISOString()
+              pubsubReceivedAt: new Date(pubsubReceivedAt).toISOString(),
+              fullMessage: JSON.stringify(message)
             });
-            _this7.scheduleOrderSyncThrottle();
+            _this13.scheduleOrderSyncThrottle();
           }
         }
       }).catch(function () {
@@ -774,7 +1393,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "scheduleOrderSyncThrottle",
     value: function scheduleOrderSyncThrottle() {
-      var _this8 = this;
+      var _this14 = this;
       if (this.isProcessingSyncBatch) return;
       if (this.isIdlePhase) {
         this.isIdlePhase = false;
@@ -785,8 +1404,8 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       if (this.syncTimer) return;
       var throttleMs = this.getOrderSyncThrottleMs();
       this.syncTimer = setTimeout(function () {
-        _this8.syncTimer = undefined;
-        void _this8.flushOrderSyncMessagesByThrottle();
+        _this14.syncTimer = undefined;
+        void _this14.flushOrderSyncMessagesByThrottle();
       }, throttleMs);
     }
 
@@ -797,41 +1416,41 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "flushOrderSyncMessagesByThrottle",
     value: (function () {
-      var _flushOrderSyncMessagesByThrottle = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10() {
-        return _regeneratorRuntime().wrap(function _callee10$(_context10) {
-          while (1) switch (_context10.prev = _context10.next) {
+      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) {
-                _context10.next = 2;
+                _context13.next = 2;
                 break;
               }
-              return _context10.abrupt("return");
+              return _context13.abrupt("return");
             case 2:
               if (!(this.pendingSyncMessages.length === 0)) {
-                _context10.next = 5;
+                _context13.next = 5;
                 break;
               }
               this.isIdlePhase = true;
-              return _context10.abrupt("return");
+              return _context13.abrupt("return");
             case 5:
               this.isProcessingSyncBatch = true;
-              _context10.prev = 6;
-              _context10.next = 9;
+              _context13.prev = 6;
+              _context13.next = 9;
               return this.processOrderSyncMessages();
             case 9:
-              _context10.prev = 9;
+              _context13.prev = 9;
               this.isProcessingSyncBatch = false;
               if (this.pendingSyncMessages.length > 0) {
                 this.scheduleOrderSyncThrottle();
               } else {
                 this.isIdlePhase = true;
               }
-              return _context10.finish(9);
+              return _context13.finish(9);
             case 13:
             case "end":
-              return _context10.stop();
+              return _context13.stop();
           }
-        }, _callee10, this, [[6,, 9, 13]]);
+        }, _callee13, this, [[6,, 9, 13]]);
       }));
       function flushOrderSyncMessagesByThrottle() {
         return _flushOrderSyncMessagesByThrottle.apply(this, arguments);
@@ -853,18 +1472,19 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "processOrderSyncMessages",
     value: (function () {
-      var _processOrderSyncMessages = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11() {
-        var messages, batchProcessStartAt, earliestReceivedAt, upsertOrders, refreshIds, _iterator3, _step3, _msg$id, _msg$relation_order_i, msg, hasBatchIds, singleId, hasSingleId, rawBody, normalizedBody, uniqueRefreshIds, upsertList, freshOrders, batchProcessEndAt;
-        return _regeneratorRuntime().wrap(function _callee11$(_context11) {
-          while (1) switch (_context11.prev = _context11.next) {
+      var _processOrderSyncMessages = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee14() {
+        var _this15 = 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)) {
-                _context11.next = 4;
+                _context14.next = 4;
                 break;
               }
-              return _context11.abrupt("return");
+              return _context14.abrupt("return");
             case 4:
               batchProcessStartAt = Date.now();
               earliestReceivedAt = Math.min.apply(Math, _toConsumableArray(messages.map(function (m) {
@@ -879,43 +1499,18 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               });
               upsertOrders = new Map();
               refreshIds = [];
-              _iterator3 = _createForOfIteratorHelper(messages);
-              _context11.prev = 10;
-              _iterator3.s();
-            case 12:
-              if ((_step3 = _iterator3.n()).done) {
-                _context11.next = 25;
-                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)) {
-                _context11.next = 22;
-                break;
-              }
-              upsertOrders.set(this.getIdKey(normalizedBody.order_id), normalizedBody);
-              return _context11.abrupt("continue", 23);
-            case 22:
-              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 23:
-              _context11.next = 12;
-              break;
-            case 25:
-              _context11.next = 30;
-              break;
-            case 27:
-              _context11.prev = 27;
-              _context11.t0 = _context11["catch"](10);
-              _iterator3.e(_context11.t0);
-            case 30:
-              _context11.prev = 30;
-              _iterator3.f();
-              return _context11.finish(30);
-            case 33:
+              messages.forEach(function (msg, msgIndex) {
+                var routeInfo = _this15.resolveSyncMessageRoute(msg);
+                var hasBatchIds = routeInfo.hasBatchIds;
+                var singleId = routeInfo.singleId;
+                var hasSingleId = routeInfo.hasSingleId;
+                var normalizedBody = _this15.normalizeOrderSyncPayload(msg.body || msg.data);
+                if (routeInfo.route === 'bodyUpsert' && normalizedBody) {
+                  upsertOrders.set(_this15.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-去重完成', {
@@ -923,33 +1518,42 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 refreshIdCount: uniqueRefreshIds.length
               });
               if (!(upsertList.length > 0)) {
-                _context11.next = 39;
+                _context14.next = 16;
                 break;
               }
-              _context11.next = 39;
-              return this.mergeOrdersToStore(upsertList);
-            case 39:
+              _context14.next = 16;
+              return this.mergeOrdersToStore(upsertList, 'pubsub.bodyUpsert');
+            case 16:
               if (!(uniqueRefreshIds.length > 0)) {
-                _context11.next = 46;
+                _context14.next = 28;
                 break;
               }
-              _context11.next = 42;
-              return this.fetchOrdersByHttp(uniqueRefreshIds);
-            case 42:
-              freshOrders = _context11.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)) {
-                _context11.next = 46;
+                _context14.next = 28;
                 break;
               }
-              _context11.next = 46;
-              return this.mergeOrdersToStore(freshOrders);
-            case 46:
+              _context14.next = 26;
+              return this.mergeOrdersToStore(freshOrders, 'pubsub.httpRefresh');
+            case 26:
+              _context14.next = 28;
+              break;
+            case 28:
               if (!(upsertList.length === 0 && uniqueRefreshIds.length === 0)) {
-                _context11.next = 48;
+                _context14.next = 30;
                 break;
               }
-              return _context11.abrupt("return");
-            case 48:
+              return _context14.abrupt("return");
+            case 30:
               batchProcessEndAt = Date.now();
               this.logInfo('processOrderSyncMessages-结束', {
                 upsertCount: upsertList.length,
@@ -957,13 +1561,13 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 batchProcessDurationMs: batchProcessEndAt - batchProcessStartAt,
                 totalFromPubsubToProcessedMs: batchProcessEndAt - earliestReceivedAt
               });
-              _context11.next = 52;
+              _context14.next = 34;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 52:
+            case 34:
             case "end":
-              return _context11.stop();
+              return _context14.stop();
           }
-        }, _callee11, this, [[10, 27, 30, 33]]);
+        }, _callee14, this);
       }));
       function processOrderSyncMessages() {
         return _processOrderSyncMessages.apply(this, arguments);
@@ -984,29 +1588,29 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "fetchOrdersByHttp",
     value: (function () {
-      var _fetchOrdersByHttp = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee12(ids) {
+      var _fetchOrdersByHttp = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee15(ids) {
         var _orderList, orderList;
-        return _regeneratorRuntime().wrap(function _callee12$(_context12) {
-          while (1) switch (_context12.prev = _context12.next) {
+        return _regeneratorRuntime().wrap(function _callee15$(_context15) {
+          while (1) switch (_context15.prev = _context15.next) {
             case 0:
               if (!(!this.orderDataSource || ids.length === 0)) {
-                _context12.next = 2;
+                _context15.next = 2;
                 break;
               }
-              return _context12.abrupt("return", []);
+              return _context15.abrupt("return", []);
             case 2:
-              _context12.prev = 2;
+              _context15.prev = 2;
               if (!(typeof this.orderDataSource.fetchOrdersByIds === 'function')) {
-                _context12.next = 8;
+                _context15.next = 8;
                 break;
               }
-              _context12.next = 6;
+              _context15.next = 6;
               return this.orderDataSource.fetchOrdersByIds(ids);
             case 6:
-              _orderList = _context12.sent;
-              return _context12.abrupt("return", _orderList || []);
+              _orderList = _context15.sent;
+              return _context15.abrupt("return", _orderList || []);
             case 8:
-              _context12.next = 10;
+              _context15.next = 10;
               return this.orderDataSource.run({
                 http: {
                   query: {
@@ -1015,19 +1619,19 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 }
               });
             case 10:
-              orderList = _context12.sent;
-              return _context12.abrupt("return", orderList || []);
+              orderList = _context15.sent;
+              return _context15.abrupt("return", orderList || []);
             case 14:
-              _context12.prev = 14;
-              _context12.t0 = _context12["catch"](2);
-              return _context12.abrupt("return", []);
+              _context15.prev = 14;
+              _context15.t0 = _context15["catch"](2);
+              return _context15.abrupt("return", []);
             case 17:
             case "end":
-              return _context12.stop();
+              return _context15.stop();
           }
-        }, _callee12, this, [[2, 14]]);
+        }, _callee15, this, [[2, 14]]);
       }));
-      function fetchOrdersByHttp(_x6) {
+      function fetchOrdersByHttp(_x8) {
         return _fetchOrdersByHttp.apply(this, arguments);
       }
       return fetchOrdersByHttp;
@@ -1039,87 +1643,126 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "mergeOrdersToStore",
     value: (function () {
-      var _mergeOrdersToStore = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee13(freshOrders) {
-        var _this9 = this;
-        var freshMap, _iterator4, _step4, order, id, uniqueFreshCount, updatedList, _iterator5, _step5, _order;
-        return _regeneratorRuntime().wrap(function _callee13$(_context13) {
-          while (1) switch (_context13.prev = _context13.next) {
+      var _mergeOrdersToStore = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee16(freshOrders, source) {
+        var normalizedFreshOrders, _iterator10, _step10, order, id, uniqueFreshOrders, uniqueFreshCount, patchedOrders, mergeActions, updatedList, _iterator11, _step11, fresh, matchIndex, storageKey, mergeKey, mergedOrder, insertCount, updateCount;
+        return _regeneratorRuntime().wrap(function _callee16$(_context16) {
+          while (1) switch (_context16.prev = _context16.next) {
             case 0:
               this.logInfo('mergeOrdersToStore-开始', {
                 freshOrderCount: freshOrders.length,
-                storeOrderCountBefore: this.store.list.length
+                storeOrderCountBefore: this.store.list.length,
+                source: source
               });
-              freshMap = new Map();
-              _iterator4 = _createForOfIteratorHelper(freshOrders);
-              _context13.prev = 3;
-              _iterator4.s();
-            case 5:
-              if ((_step4 = _iterator4.n()).done) {
-                _context13.next = 13;
+              this.logDuplicateOrders("".concat(source, ".beforeMerge"), this.store.list);
+              normalizedFreshOrders = [];
+              _iterator10 = _createForOfIteratorHelper(freshOrders);
+              _context16.prev = 4;
+              _iterator10.s();
+            case 6:
+              if ((_step10 = _iterator10.n()).done) {
+                _context16.next = 14;
                 break;
               }
-              order = _step4.value;
+              order = _step10.value;
               id = order === null || order === void 0 ? void 0 : order.order_id;
               if (!(id === undefined || id === null)) {
-                _context13.next = 10;
+                _context16.next = 11;
                 break;
               }
-              return _context13.abrupt("continue", 11);
-            case 10:
-              freshMap.set(this.getIdKey(id), order);
+              return _context16.abrupt("continue", 12);
             case 11:
-              _context13.next = 5;
+              normalizedFreshOrders.push(this.normalizeRemoteSyncedOrder(order));
+            case 12:
+              _context16.next = 6;
               break;
-            case 13:
-              _context13.next = 18;
+            case 14:
+              _context16.next = 19;
               break;
-            case 15:
-              _context13.prev = 15;
-              _context13.t0 = _context13["catch"](3);
-              _iterator4.e(_context13.t0);
-            case 18:
-              _context13.prev = 18;
-              _iterator4.f();
-              return _context13.finish(18);
-            case 21:
-              uniqueFreshCount = freshMap.size;
-              updatedList = this.store.list.map(function (order) {
-                var id = order.order_id;
-                if (id === undefined || id === null) return order;
-                var key = _this9.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);
-                }
-              } catch (err) {
-                _iterator5.e(err);
-              } finally {
-                _iterator5.f();
+            case 16:
+              _context16.prev = 16;
+              _context16.t0 = _context16["catch"](4);
+              _iterator10.e(_context16.t0);
+            case 19:
+              _context16.prev = 19;
+              _iterator10.f();
+              return _context16.finish(19);
+            case 22:
+              uniqueFreshOrders = this.compactOrderListByIdentity(normalizedFreshOrders, "".concat(source, ".incoming")).list;
+              uniqueFreshCount = uniqueFreshOrders.length;
+              patchedOrders = [];
+              mergeActions = {};
+              updatedList = _toConsumableArray(this.store.list);
+              _iterator11 = _createForOfIteratorHelper(uniqueFreshOrders);
+              _context16.prev = 28;
+              _iterator11.s();
+            case 30:
+              if ((_step11 = _iterator11.n()).done) {
+                _context16.next = 46;
+                break;
               }
-              this.store.list = updatedList;
+              fresh = _step11.value;
+              matchIndex = this.findOrderIndexByIdentity(updatedList, fresh);
+              storageKey = this.getOrderStorageKey(fresh);
+              mergeKey = storageKey || (fresh.order_id !== undefined && fresh.order_id !== null ? this.getIdKey(fresh.order_id) : '');
+              if (!(matchIndex >= 0)) {
+                _context16.next = 41;
+                break;
+              }
+              mergedOrder = this.mergeOrderRecords(updatedList[matchIndex], fresh);
+              updatedList[matchIndex] = mergedOrder;
+              patchedOrders.push(mergedOrder);
+              if (mergeKey) mergeActions[mergeKey] = 'update';
+              return _context16.abrupt("continue", 44);
+            case 41:
+              updatedList.push(fresh);
+              patchedOrders.push(fresh);
+              if (mergeKey) mergeActions[mergeKey] = 'insert';
+            case 44:
+              _context16.next = 30;
+              break;
+            case 46:
+              _context16.next = 51;
+              break;
+            case 48:
+              _context16.prev = 48;
+              _context16.t1 = _context16["catch"](28);
+              _iterator11.e(_context16.t1);
+            case 51:
+              _context16.prev = 51;
+              _iterator11.f();
+              return _context16.finish(51);
+            case 54:
+              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
+              });
+              this.store.list = this.compactOrderListByIdentity(updatedList, "".concat(source, ".store")).list;
               this.syncOrdersMap();
-              _context13.next = 29;
-              return this.saveOrdersToSQLite(this.store.list);
-            case 29:
+              _context16.next = 61;
+              return this.patchOrdersInSQLite(patchedOrders, source, mergeActions);
+            case 61:
               this.logInfo('mergeOrdersToStore-结束', {
                 uniqueFreshCount: uniqueFreshCount,
-                storeOrderCountAfter: this.store.list.length
+                storeOrderCountAfter: this.store.list.length,
+                insertCount: insertCount,
+                updateCount: updateCount
               });
-              this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
-            case 31:
+              _context16.next = 64;
+              return this.emitOrdersChanged(patchedOrders, source);
+            case 64:
             case "end":
-              return _context13.stop();
+              return _context16.stop();
           }
-        }, _callee13, this, [[3, 15, 18, 21]]);
+        }, _callee16, this, [[4, 16, 19, 22], [28, 48, 51, 54]]);
       }));
-      function mergeOrdersToStore(_x7) {
+      function mergeOrdersToStore(_x9, _x10) {
         return _mergeOrdersToStore.apply(this, arguments);
       }
       return mergeOrdersToStore;
@@ -1156,17 +1799,17 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "uniqueOrderIds",
     value: function uniqueOrderIds(ids) {
       var idMap = new Map();
-      var _iterator6 = _createForOfIteratorHelper(ids),
-        _step6;
+      var _iterator12 = _createForOfIteratorHelper(ids),
+        _step12;
       try {
-        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-          var id = _step6.value;
+        for (_iterator12.s(); !(_step12 = _iterator12.n()).done;) {
+          var id = _step12.value;
           idMap.set(this.getIdKey(id), id);
         }
       } catch (err) {
-        _iterator6.e(err);
+        _iterator12.e(err);
       } finally {
-        _iterator6.f();
+        _iterator12.f();
       }
       return _toConsumableArray(idMap.values());
     }
@@ -1175,6 +1818,276 @@ 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: "getProductMergeKey",
+    value: function getProductMergeKey(product) {
+      var _record$metadata;
+      var record = product;
+      if (!record) return '';
+      var metadataUid = (_record$metadata = record.metadata) === null || _record$metadata === void 0 ? void 0 : _record$metadata.unique_identification_number;
+      if (!this.isBlankIdentityValue(metadataUid)) return "uid:".concat(String(metadataUid));
+      var topLevelUid = record.unique_identification_number;
+      if (!this.isBlankIdentityValue(topLevelUid)) return "uid:".concat(String(topLevelUid));
+      var orderDetailId = record.order_detail_id;
+      if (!this.isBlankIdentityValue(orderDetailId)) return "detail:".concat(String(orderDetailId));
+      var bookingUid = record.booking_uid;
+      if (!this.isBlankIdentityValue(bookingUid)) return "booking:".concat(String(bookingUid));
+      return '';
+    }
+  }, {
+    key: "mergeOrderProductLists",
+    value: function mergeOrderProductLists(preferred, secondary) {
+      var preferredList = Array.isArray(preferred) ? preferred : [];
+      var secondaryList = Array.isArray(secondary) ? secondary : [];
+      if (secondaryList.length === 0) return preferredList;
+      if (preferredList.length === 0) return secondaryList;
+      var seenKeys = new Set();
+      var _iterator13 = _createForOfIteratorHelper(preferredList),
+        _step13;
+      try {
+        for (_iterator13.s(); !(_step13 = _iterator13.n()).done;) {
+          var item = _step13.value;
+          var key = this.getProductMergeKey(item);
+          if (key) seenKeys.add(key);
+        }
+      } catch (err) {
+        _iterator13.e(err);
+      } finally {
+        _iterator13.f();
+      }
+      var result = _toConsumableArray(preferredList);
+      var _iterator14 = _createForOfIteratorHelper(secondaryList),
+        _step14;
+      try {
+        for (_iterator14.s(); !(_step14 = _iterator14.n()).done;) {
+          var _item = _step14.value;
+          var _key = this.getProductMergeKey(_item);
+          if (!_key || seenKeys.has(_key)) continue;
+          seenKeys.add(_key);
+          result.push(cloneDeep(_item));
+        }
+      } catch (err) {
+        _iterator14.e(err);
+      } finally {
+        _iterator14.f();
+      }
+      return result;
+    }
+  }, {
+    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', 'payments', 'products', 'bookings'];
+      var mergedRecord = merged;
+      var preferredRecord = preferred;
+      var secondaryRecord = secondary;
+      var incomingRecord = incoming;
+      for (var _i3 = 0, _fieldsToPreserve = fieldsToPreserve; _i3 < _fieldsToPreserve.length; _i3++) {
+        var field = _fieldsToPreserve[_i3];
+        if (!this.isBlankIdentityValue(preferredRecord[field])) {
+          mergedRecord[field] = preferredRecord[field];
+          continue;
+        }
+        if (!this.isBlankIdentityValue(secondaryRecord[field])) {
+          mergedRecord[field] = secondaryRecord[field];
+        }
+      }
+      for (var _i4 = 0, _incomingPatchFields = incomingPatchFields; _i4 < _incomingPatchFields.length; _i4++) {
+        var _field = _incomingPatchFields[_i4];
+        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]);
+      }
+      mergedRecord.products = this.mergeOrderProductLists(preferredRecord.products, secondaryRecord.products);
+      if (!this.isPendingSyncOrder(preferred) || !this.isPendingSyncOrder(secondary)) {
+        merged.need_sync = 0;
+      }
+      return merged;
+    }
+  }, {
+    key: "summarizeDuplicateOrders",
+    value: function summarizeDuplicateOrders(orders) {
+      var groups = new Map();
+      var _iterator15 = _createForOfIteratorHelper(orders),
+        _step15;
+      try {
+        for (_iterator15.s(); !(_step15 = _iterator15.n()).done;) {
+          var order = _step15.value;
+          var _iterator16 = _createForOfIteratorHelper(this.getOrderIdentityMatchKeys(order)),
+            _step16;
+          try {
+            for (_iterator16.s(); !(_step16 = _iterator16.n()).done;) {
+              var key = _step16.value;
+              var group = groups.get(key) || [];
+              group.push(order);
+              groups.set(key, group);
+            }
+          } catch (err) {
+            _iterator16.e(err);
+          } finally {
+            _iterator16.f();
+          }
+        }
+      } catch (err) {
+        _iterator15.e(err);
+      } finally {
+        _iterator15.f();
+      }
+      return _toConsumableArray(groups.entries()).filter(function (_ref2) {
+        var _ref3 = _slicedToArray(_ref2, 2),
+          group = _ref3[1];
+        return group.length > 1;
+      }).slice(0, 20).map(function (_ref4) {
+        var _ref5 = _slicedToArray(_ref4, 2),
+          key = _ref5[0],
+          group = _ref5[1];
+        return {
+          key: key,
+          count: group.length,
+          orders: group.map(function (order) {
+            var _order$order_id2, _external_sale_number, _shop_order_number, _shop_full_order_numb, _order$need_sync;
+            return {
+              order_id: (_order$order_id2 = order.order_id) !== null && _order$order_id2 !== void 0 ? _order$order_id2 : null,
+              external_sale_number: (_external_sale_number = order.external_sale_number) !== null && _external_sale_number !== void 0 ? _external_sale_number : 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 _iterator17 = _createForOfIteratorHelper(orders),
+        _step17;
+      try {
+        for (_iterator17.s(); !(_step17 = _iterator17.n()).done;) {
+          var order = _step17.value;
+          var matchIndex = this.findOrderIndexByIdentity(list, order);
+          if (matchIndex < 0) {
+            list.push(order);
+            continue;
+          }
+          list[matchIndex] = this.mergeOrderRecords(list[matchIndex], order);
+          removedCount += 1;
+        }
+      } catch (err) {
+        _iterator17.e(err);
+      } finally {
+        _iterator17.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
+      };
+    }
 
     /**
      * 当前订单拉取窗口：
@@ -1232,7 +2145,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;
@@ -1249,39 +2162,39 @@ 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 _callee14() {
+      var _loadOrdersFromSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee17() {
         var orders;
-        return _regeneratorRuntime().wrap(function _callee14$(_context14) {
-          while (1) switch (_context14.prev = _context14.next) {
+        return _regeneratorRuntime().wrap(function _callee17$(_context17) {
+          while (1) switch (_context17.prev = _context17.next) {
             case 0:
               if (this.dbManager) {
-                _context14.next = 2;
+                _context17.next = 2;
                 break;
               }
-              return _context14.abrupt("return", []);
+              return _context17.abrupt("return", []);
             case 2:
-              _context14.prev = 2;
-              _context14.next = 5;
+              _context17.prev = 2;
+              _context17.next = 5;
               return this.dbManager.getAll(INDEXDB_STORE_NAME);
             case 5:
-              orders = _context14.sent;
-              return _context14.abrupt("return", orders || []);
+              orders = _context17.sent;
+              return _context17.abrupt("return", orders || []);
             case 9:
-              _context14.prev = 9;
-              _context14.t0 = _context14["catch"](2);
-              return _context14.abrupt("return", []);
+              _context17.prev = 9;
+              _context17.t0 = _context17["catch"](2);
+              return _context17.abrupt("return", []);
             case 12:
             case "end":
-              return _context14.stop();
+              return _context17.stop();
           }
-        }, _callee14, this, [[2, 9]]);
+        }, _callee17, this, [[2, 9]]);
       }));
       function loadOrdersFromSQLite() {
         return _loadOrdersFromSQLite.apply(this, arguments);
@@ -1289,91 +2202,488 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return loadOrdersFromSQLite;
     }()
   }, {
-    key: "saveOrdersToSQLite",
-    value: function () {
-      var _saveOrdersToSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee15(orderList) {
-        return _regeneratorRuntime().wrap(function _callee15$(_context15) {
-          while (1) switch (_context15.prev = _context15.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) {
+      if (this.isPendingSyncOrder(order)) return order;
+      return _objectSpread(_objectSpread({}, order), {}, {
+        need_sync: 0
+      });
+    }
+  }, {
+    key: "mergeRemoteSnapshotWithPendingOrders",
+    value: function mergeRemoteSnapshotWithPendingOrders(remoteOrders, existingOrders) {
+      var _this18 = this;
+      var merged = remoteOrders.map(function (order) {
+        return _this18.normalizeRemoteSyncedOrder(order);
+      });
+      var _iterator18 = _createForOfIteratorHelper(existingOrders),
+        _step18;
+      try {
+        for (_iterator18.s(); !(_step18 = _iterator18.n()).done;) {
+          var order = _step18.value;
+          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) {
+        _iterator18.e(err);
+      } finally {
+        _iterator18.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) {
-                _context15.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 _this19 = 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 _context15.abrupt("return");
-            case 2:
-              _context15.prev = 2;
-              this.logInfo('saveOrdersToSQLite-开始', {
-                count: orderList.length
+              return _context20.abrupt("return");
+            case 3:
+              ordersSnapshot = cloneDeep(orders).filter(function (order) {
+                return _this19.getOrderStorageKey(order);
               });
-              _context15.next = 6;
-              return this.dbManager.clear(INDEXDB_STORE_NAME);
+              if (!(ordersSnapshot.length === 0)) {
+                _context20.next = 6;
+                break;
+              }
+              return _context20.abrupt("return");
             case 6:
-              this.logInfo('saveOrdersToSQLite-clear完成', {
-                count: orderList.length
-              });
-              if (!(orderList.length === 0)) {
-                _context15.next = 9;
+              _this$filterRedundant2 = this.filterRedundantPatchOrders(source, ordersSnapshot, mergeActions), toWrite = _this$filterRedundant2.toWrite, skipped = _this$filterRedundant2.skipped;
+              if (!(toWrite.length === 0)) {
+                _context20.next = 9;
                 break;
               }
-              return _context15.abrupt("return");
+              return _context20.abrupt("return");
             case 9:
-              _context15.next = 11;
-              return this.dbManager.bulkAdd(INDEXDB_STORE_NAME, orderList);
-            case 11:
-              this.logInfo('saveOrdersToSQLite-bulkAdd完成', {
-                count: orderList.length
+              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, _iterator19, _step19, order;
+                return _regeneratorRuntime().wrap(function _callee19$(_context19) {
+                  while (1) switch (_context19.prev = _context19.next) {
+                    case 0:
+                      writeMethod = 'none';
+                      _this19.logInfo('patchOrdersInSQLite-开始', {
+                        source: source,
+                        count: compactedToWrite.length,
+                        dedupedCount: skipped.length
+                      });
+                      if (!(typeof _this19.dbManager.bulkUpdate === 'function')) {
+                        _context19.next = 8;
+                        break;
+                      }
+                      writeMethod = 'bulkUpdate';
+                      _context19.next = 6;
+                      return _this19.dbManager.bulkUpdate(INDEXDB_STORE_NAME, compactedToWrite);
+                    case 6:
+                      _context19.next = 33;
+                      break;
+                    case 8:
+                      if (!(typeof _this19.dbManager.bulkAdd === 'function')) {
+                        _context19.next = 14;
+                        break;
+                      }
+                      writeMethod = 'bulkAdd';
+                      _context19.next = 12;
+                      return _this19.dbManager.bulkAdd(INDEXDB_STORE_NAME, compactedToWrite);
+                    case 12:
+                      _context19.next = 33;
+                      break;
+                    case 14:
+                      if (!(typeof _this19.dbManager.update === 'function')) {
+                        _context19.next = 33;
+                        break;
+                      }
+                      writeMethod = 'update';
+                      _iterator19 = _createForOfIteratorHelper(compactedToWrite);
+                      _context19.prev = 17;
+                      _iterator19.s();
+                    case 19:
+                      if ((_step19 = _iterator19.n()).done) {
+                        _context19.next = 25;
+                        break;
+                      }
+                      order = _step19.value;
+                      _context19.next = 23;
+                      return _this19.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);
+                      _iterator19.e(_context19.t0);
+                    case 30:
+                      _context19.prev = 30;
+                      _iterator19.f();
+                      return _context19.finish(30);
+                    case 33:
+                      _this19.recordRecentSqliteWrite(source, compactedToWrite);
+                      _this19.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
               });
-              _context15.next = 17;
+            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 _this20 = 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 = cloneDeep(order);
+              _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';
+                      _this20.logInfo('updateOrderInSQLite-开始', {
+                        source: source,
+                        orderId: (_orderSnapshot$order_ = orderSnapshot.order_id) !== null && _orderSnapshot$order_ !== void 0 ? _orderSnapshot$order_ : null,
+                        storageKey: _this20.getOrderStorageKey(orderSnapshot)
+                      });
+                      if (!(typeof _this20.dbManager.update === 'function')) {
+                        _context21.next = 8;
+                        break;
+                      }
+                      writeMethod = 'update';
+                      _context21.next = 6;
+                      return _this20.dbManager.update(INDEXDB_STORE_NAME, orderSnapshot);
+                    case 6:
+                      _context21.next = 18;
+                      break;
+                    case 8:
+                      if (!(typeof _this20.dbManager.bulkUpdate === 'function')) {
+                        _context21.next = 14;
+                        break;
+                      }
+                      writeMethod = 'bulkUpdate';
+                      _context21.next = 12;
+                      return _this20.dbManager.bulkUpdate(INDEXDB_STORE_NAME, [orderSnapshot]);
+                    case 12:
+                      _context21.next = 18;
+                      break;
+                    case 14:
+                      if (!(typeof _this20.dbManager.bulkAdd === 'function')) {
+                        _context21.next = 18;
+                        break;
+                      }
+                      writeMethod = 'bulkAdd';
+                      _context21.next = 18;
+                      return _this20.dbManager.bulkAdd(INDEXDB_STORE_NAME, [orderSnapshot]);
+                    case 18:
+                      _this20.recordRecentSqliteWrite(source, [orderSnapshot]);
+                      _this20.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 14:
-              _context15.prev = 14;
-              _context15.t0 = _context15["catch"](2);
-              // SQLite 异常，避免影响主流程
-              this.logError('保存订单到 SQLite 失败', {
-                error: _context15.t0 instanceof Error ? _context15.t0.message : String(_context15.t0),
-                orderList: orderList.length
+            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 17:
+            case 11:
             case "end":
-              return _context15.stop();
+              return _context22.stop();
           }
-        }, _callee15, this, [[2, 14]]);
+        }, _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 _this21 = 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 _this21.normalizeRemoteSyncedOrder(order);
+              }), "".concat(source, ".snapshotNoDb")).list);
+            case 2:
+              remoteSnapshot = cloneDeep(orderList);
+              mergedSnapshot = this.compactOrderListByIdentity(remoteSnapshot.map(function (order) {
+                return _this21.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 _this21.dbManager.getAll === 'function')) {
+                        _context23.next = 6;
+                        break;
+                      }
+                      _context23.next = 3;
+                      return _this21.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 = _this21.mergeRemoteSnapshotWithPendingOrders(remoteSnapshot, existingOrders || []);
+                      mergedSnapshot = _this21.compactOrderListByIdentity(orderListSnapshot, "".concat(source, ".sqliteSnapshot")).list;
+                      _this21.logInfo('replaceOrdersSnapshotInSQLite-开始', {
+                        source: source,
+                        count: mergedSnapshot.length,
+                        remoteCount: remoteSnapshot.length,
+                        preservedPendingCount: mergedSnapshot.length - remoteSnapshot.length
+                      });
+                      _context23.next = 13;
+                      return _this21.dbManager.clear(INDEXDB_STORE_NAME);
+                    case 13:
+                      _this21.logInfo('replaceOrdersSnapshotInSQLite-clear完成', {
+                        count: mergedSnapshot.length
+                      });
+                      if (!(mergedSnapshot.length === 0)) {
+                        _context23.next = 16;
+                        break;
+                      }
+                      return _context23.abrupt("return");
+                    case 16:
+                      _context23.next = 18;
+                      return _this21.dbManager.bulkAdd(INDEXDB_STORE_NAME, mergedSnapshot);
+                    case 18:
+                      _this21.recordRecentSqliteWrite(source, mergedSnapshot);
+                      _this21.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 _context24.stop();
+          }
+        }, _callee24, this, [[4, 9]]);
       }));
-      function saveOrdersToSQLite(_x8) {
-        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 _callee16() {
-        return _regeneratorRuntime().wrap(function _callee16$(_context16) {
-          while (1) switch (_context16.prev = _context16.next) {
+    value: (function () {
+      var _clear = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee26() {
+        var _this22 = 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) {
-                _context16.next = 6;
+                _context26.next = 6;
                 break;
               }
-              _context16.next = 6;
-              return this.dbManager.clear(INDEXDB_STORE_NAME);
+              _context26.next = 6;
+              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 _this22.dbManager.clear(INDEXDB_STORE_NAME);
+                    case 2:
+                    case "end":
+                      return _context25.stop();
+                  }
+                }, _callee25);
+              })));
             case 6:
               this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, '');
-              this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
+              this.emitOrdersChanged([], 'clear');
             case 8:
             case "end":
-              return _context16.stop();
+              return _context26.stop();
           }
-        }, _callee16, this);
+        }, _callee26, this);
       }));
       function clear() {
         return _clear.apply(this, arguments);
       }
       return clear;
-    }()
+    }())
   }]);
   return OrderModule;
 }(BaseModule);