@pisell/pisellos 2.2.190 → 2.2.191

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

@@ -1,13 +1,17 @@
+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 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 _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 _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 _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 _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 _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; }
+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 _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
@@ -38,6 +42,21 @@ 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;
+/** window 上挂载的订单流程调试日志 key */
+var ORDER_FLOW_LOG_WINDOW_KEY = '__orderModuleFlowLogs';
+/** window 上按订单聚合的 SQLite 写入统计 key */
+var ORDER_WRITE_STATS_WINDOW_KEY = '__orderModuleWriteStats';
+var ORDER_FLOW_LOG_MAX_LENGTH = 1000;
+/** 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', 'overwriteExistingOrder']);
+
+/** 订单模块流程调试日志条目 */
+
+/** 单笔订单 SQLite 写入记录 */
 
 /**
  * Order 模块 - 基础框架
@@ -64,6 +83,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     // LoggerManager 实例
     _defineProperty(_assertThisInitialized(_this), "storage", void 0);
     _defineProperty(_assertThisInitialized(_this), "orderSQLiteSaveQueue", Promise.resolve());
+    /** 全局递增的 SQLite 写入序号，便于日志关联同一次操作 */
+    _defineProperty(_assertThisInitialized(_this), "orderFlowWriteSeq", 0);
+    /** 按 storageKey 记录最近一次 SQLite 写入来源与时间，用于去重 */
+    _defineProperty(_assertThisInitialized(_this), "recentSqliteWriteByStorageKey", new Map());
+    /** 最近一次 SSE 全量拉取完成时间 */
+    _defineProperty(_assertThisInitialized(_this), "lastServerFullFetchAtMs", 0);
     return _this;
   }
   _createClass(OrderModule, [{
@@ -126,14 +151,21 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 this.store.list = [];
                 this.store.map = new Map();
               }
+              this.initOrderFlowLogs();
               this.initOrderDataSource();
               this.setupOrderSync();
+              this.pushOrderFlowLog('initialize.complete', {
+                hasDbManager: !!this.dbManager,
+                hasLogger: !!this.logger,
+                initialOrderCount: this.store.list.length,
+                createdAtQuery: this.store.createdAtQuery || null
+              });
               this.logInfo('OrderServer模块初始化完成', {
                 hasDbManager: !!this.dbManager,
                 hasLogger: !!this.logger,
                 initialOrderCount: this.store.list.length
               });
-            case 10:
+            case 12:
             case "end":
               return _context.stop();
           }
@@ -184,6 +216,381 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       } catch (_unused2) {
         // 日志记录失败不影响主流程
       }
+      this.pushOrderFlowLog("error.".concat(title), metadata);
+    }
+
+    /**
+     * 初始化 window 上的订单流程调试日志数组及辅助方法。
+     *
+     * @example
+     * window.clearOrderModuleFlowLogs()
+     * // 操作完成后：
+     * copy(window.exportOrderModuleFlowLogs?.() || '[]')
+     */
+  }, {
+    key: "initOrderFlowLogs",
+    value: function initOrderFlowLogs() {
+      var _this2 = this;
+      try {
+        var win = typeof globalThis !== 'undefined' ? globalThis.window : undefined;
+        if (!win) return;
+        win[ORDER_FLOW_LOG_WINDOW_KEY] = [];
+        win[ORDER_WRITE_STATS_WINDOW_KEY] = {};
+        win.clearOrderModuleFlowLogs = function () {
+          win[ORDER_FLOW_LOG_WINDOW_KEY] = [];
+          win[ORDER_WRITE_STATS_WINDOW_KEY] = {};
+          _this2.orderFlowWriteSeq = 0;
+          _this2.recentSqliteWriteByStorageKey.clear();
+          _this2.lastServerFullFetchAtMs = 0;
+          _this2.pushOrderFlowLog('debug.clear', {});
+        };
+        win.exportOrderModuleFlowLogs = function () {
+          var logs = win[ORDER_FLOW_LOG_WINDOW_KEY] || [];
+          return JSON.stringify(logs, null, 2);
+        };
+        win.exportOrderModuleWriteStats = function () {
+          var stats = win[ORDER_WRITE_STATS_WINDOW_KEY] || {};
+          return JSON.stringify(stats, null, 2);
+        };
+        win.summarizeOrderModuleWrites = function () {
+          var topN = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 20;
+          var stats = win[ORDER_WRITE_STATS_WINDOW_KEY] || {};
+          return Object.entries(stats).map(function (_ref) {
+            var _last$orderId;
+            var _ref2 = _slicedToArray(_ref, 2),
+              storageKey = _ref2[0],
+              entries = _ref2[1];
+            var list = entries || [];
+            var sources = _toConsumableArray(new Set(list.map(function (item) {
+              return item.source;
+            })));
+            var last = list[list.length - 1];
+            return {
+              storageKey: storageKey,
+              orderId: (_last$orderId = last === null || last === void 0 ? void 0 : last.orderId) !== null && _last$orderId !== void 0 ? _last$orderId : null,
+              writeCount: list.length,
+              sources: sources,
+              lastWriteAt: (last === null || last === void 0 ? void 0 : last.ts) || ''
+            };
+          }).sort(function (a, b) {
+            return b.writeCount - a.writeCount;
+          }).slice(0, topN);
+        };
+        this.pushOrderFlowLog('debug.init', {
+          logKey: ORDER_FLOW_LOG_WINDOW_KEY,
+          writeStatsKey: ORDER_WRITE_STATS_WINDOW_KEY,
+          helpers: ['clearOrderModuleFlowLogs', 'exportOrderModuleFlowLogs', 'exportOrderModuleWriteStats', 'summarizeOrderModuleWrites']
+        });
+      } catch (_unused3) {
+        // window 不可用时忽略
+      }
+    }
+
+    /**
+     * 写入 window 订单流程调试日志。
+     *
+     * @example
+     * this.pushOrderFlowLog('mergeOrdersToStore.start', { count: 3 })
+     */
+  }, {
+    key: "pushOrderFlowLog",
+    value: function pushOrderFlowLog(step, metadata) {
+      try {
+        var win = typeof globalThis !== 'undefined' ? globalThis.window : undefined;
+        if (!win) return;
+        if (!Array.isArray(win[ORDER_FLOW_LOG_WINDOW_KEY])) {
+          win[ORDER_FLOW_LOG_WINDOW_KEY] = [];
+        }
+        var entry = {
+          ts: new Date().toISOString(),
+          step: step,
+          metadata: metadata || {}
+        };
+        win[ORDER_FLOW_LOG_WINDOW_KEY].push(entry);
+        var logs = win[ORDER_FLOW_LOG_WINDOW_KEY];
+        if (logs.length > ORDER_FLOW_LOG_MAX_LENGTH) {
+          logs.splice(0, logs.length - ORDER_FLOW_LOG_MAX_LENGTH);
+        }
+        console.log("[OrderFlow] ".concat(step), metadata || {});
+      } catch (_unused4) {
+        // 调试日志失败不影响主流程
+      }
+    }
+
+    /** 当前内存 store 快照信息，供流程日志使用 */
+  }, {
+    key: "getOrderStoreSnapshot",
+    value: function getOrderStoreSnapshot() {
+      return {
+        storeListCount: this.store.list.length,
+        storeMapCount: this.store.map.size,
+        pendingSyncCount: this.pendingSyncMessages.length,
+        isProcessingSyncBatch: this.isProcessingSyncBatch,
+        isIdlePhase: this.isIdlePhase
+      };
+    }
+
+    /**
+     * 记录一次 SQLite 写入到 window 统计，用于排查同一订单被多次写入的原因。
+     *
+     * @example
+     * this.trackOrderWrite('upsertOrdersFromRemote', 'bulkUpdate', orders, 'insert')
+     */
+  }, {
+    key: "trackOrderWrite",
+    value: function trackOrderWrite(source, writeMethod, orders) {
+      var mergeActions = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
+      var defaultMergeAction = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : 'update';
+      this.orderFlowWriteSeq += 1;
+      var writeSeq = this.orderFlowWriteSeq;
+      try {
+        var win = typeof globalThis !== 'undefined' ? globalThis.window : undefined;
+        if (!win) return writeSeq;
+        if (!win[ORDER_WRITE_STATS_WINDOW_KEY]) {
+          win[ORDER_WRITE_STATS_WINDOW_KEY] = {};
+        }
+        var stats = win[ORDER_WRITE_STATS_WINDOW_KEY];
+        var _iterator = _createForOfIteratorHelper(orders),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var _order$order_id;
+            var order = _step.value;
+            var storageKey = this.getOrderStorageKey(order);
+            if (!storageKey) continue;
+            var orderKey = order.order_id !== undefined && order.order_id !== null ? this.getIdKey(order.order_id) : '';
+            var mergeAction = orderKey && mergeActions[orderKey] || defaultMergeAction;
+            var entry = {
+              ts: new Date().toISOString(),
+              writeSeq: writeSeq,
+              source: source,
+              writeMethod: writeMethod,
+              orderId: (_order$order_id = order.order_id) !== null && _order$order_id !== void 0 ? _order$order_id : null,
+              storageKey: storageKey,
+              mergeAction: mergeAction
+            };
+            if (!stats[storageKey]) stats[storageKey] = [];
+            stats[storageKey].push(entry);
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+      } catch (_unused5) {
+        // 统计失败不影响主流程
+      }
+      return writeSeq;
+    }
+
+    /**
+     * 记录订单最近一次 SQLite 写入，供 pubsub 回声去重使用。
+     *
+     * @example
+     * this.recordRecentSqliteWrite('upsertOrdersFromRemote', orders)
+     */
+  }, {
+    key: "recordRecentSqliteWrite",
+    value: function recordRecentSqliteWrite(source, orders) {
+      var now = Date.now();
+      var _iterator2 = _createForOfIteratorHelper(orders),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var order = _step2.value;
+          var storageKey = this.getOrderStorageKey(order);
+          if (!storageKey) continue;
+          this.recentSqliteWriteByStorageKey.set(storageKey, {
+            source: source,
+            ts: now
+          });
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+    }
+
+    /**
+     * 过滤 pubsub 触发的冗余 SQLite patch（业务 API 刚写入过的 update 回声）。
+     *
+     * @example
+     * const { toWrite, skipped } = this.filterRedundantPatchOrders('pubsub.bodyUpsert', orders, mergeActions)
+     */
+  }, {
+    key: "filterRedundantPatchOrders",
+    value: function filterRedundantPatchOrders(source, orders, mergeActions) {
+      var eligibleSkipSources = new Set(['pubsub.bodyUpsert', 'pubsub.httpRefresh']);
+      if (!eligibleSkipSources.has(source)) {
+        return {
+          toWrite: orders,
+          skipped: []
+        };
+      }
+      var now = Date.now();
+      var toWrite = [];
+      var skipped = [];
+      var _iterator3 = _createForOfIteratorHelper(orders),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var order = _step3.value;
+          var storageKey = this.getOrderStorageKey(order);
+          if (!storageKey) {
+            toWrite.push(order);
+            continue;
+          }
+          var orderKey = order.order_id !== undefined && order.order_id !== null ? this.getIdKey(order.order_id) : '';
+          var mergeAction = orderKey ? mergeActions[orderKey] : undefined;
+
+          // 新增单必须落库，不参与去重
+          if (mergeAction === 'insert') {
+            toWrite.push(order);
+            continue;
+          }
+          var recent = this.recentSqliteWriteByStorageKey.get(storageKey);
+          if (recent && ORDER_BUSINESS_WRITE_SOURCES.has(recent.source) && now - recent.ts < ORDER_SQLITE_DEDUPE_MS) {
+            var _order$order_id2;
+            skipped.push({
+              orderId: (_order$order_id2 = order.order_id) !== null && _order$order_id2 !== void 0 ? _order$order_id2 : null,
+              storageKey: storageKey,
+              reason: 'skip_pubsub_echo_after_business_write',
+              lastSource: recent.source,
+              elapsedMs: now - recent.ts
+            });
+            continue;
+          }
+          toWrite.push(order);
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+      return {
+        toWrite: toWrite,
+        skipped: skipped
+      };
+    }
+
+    /**
+     * 过滤 pubsub HTTP 增量拉取 ids：本地刚由业务 API 写入的单可跳过 HTTP。
+     *
+     * @example
+     * const ids = this.filterRedundantHttpRefreshIds([99331, 99332])
+     */
+  }, {
+    key: "filterRedundantHttpRefreshIds",
+    value: function filterRedundantHttpRefreshIds(ids) {
+      var now = Date.now();
+      var toFetch = [];
+      var skipped = [];
+      var _iterator4 = _createForOfIteratorHelper(ids),
+        _step4;
+      try {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var id = _step4.value;
+          var existing = this.getOrderByOrderId(id);
+          if (!existing) {
+            toFetch.push(id);
+            continue;
+          }
+          var storageKey = this.getOrderStorageKey(existing);
+          var recent = storageKey ? this.recentSqliteWriteByStorageKey.get(storageKey) : undefined;
+          if (recent && recent.source === 'upsertOrdersFromRemote' && now - recent.ts < ORDER_SQLITE_DEDUPE_MS) {
+            skipped.push({
+              orderId: id,
+              lastSource: recent.source,
+              elapsedMs: now - recent.ts
+            });
+            continue;
+          }
+          toFetch.push(id);
+        }
+      } catch (err) {
+        _iterator4.e(err);
+      } finally {
+        _iterator4.f();
+      }
+      return {
+        toFetch: toFetch,
+        skipped: skipped
+      };
+    }
+
+    /**
+     * 解析 pubsub 消息会走哪条同步分支，便于对照为何触发 HTTP 重拉或 body 直写。
+     *
+     * @example
+     * this.resolveSyncMessageRoute(msg)
+     * // => { route: 'httpRefresh.batchIds', ... }
+     */
+  }, {
+    key: "resolveSyncMessageRoute",
+    value: function resolveSyncMessageRoute(msg) {
+      var _msg$id, _msg$relation_order_i, _normalizedBody$order5;
+      var hasBatchIds = Array.isArray(msg.ids) && msg.ids.length > 0;
+      var singleIdRaw = (_msg$id = msg.id) !== null && _msg$id !== void 0 ? _msg$id : msg.order_id;
+      var hasSingleId = !hasBatchIds && singleIdRaw !== undefined && singleIdRaw !== null;
+      var normalizedBody = this.normalizeOrderSyncPayload(msg.body || msg.data);
+      if (hasBatchIds) {
+        var _normalizedBody$order;
+        return {
+          route: 'httpRefresh.batchIds',
+          hasBatchIds: true,
+          hasSingleId: false,
+          hasNormalizedBody: !!normalizedBody,
+          singleId: null,
+          batchIds: msg.ids || [],
+          bodyOrderId: (_normalizedBody$order = normalizedBody === null || normalizedBody === void 0 ? void 0 : normalizedBody.order_id) !== null && _normalizedBody$order !== void 0 ? _normalizedBody$order : null
+        };
+      }
+      if (hasSingleId && normalizedBody) {
+        var _normalizedBody$order2;
+        return {
+          route: 'bodyUpsert',
+          hasBatchIds: false,
+          hasSingleId: true,
+          hasNormalizedBody: true,
+          singleId: singleIdRaw,
+          batchIds: [],
+          bodyOrderId: (_normalizedBody$order2 = normalizedBody.order_id) !== null && _normalizedBody$order2 !== void 0 ? _normalizedBody$order2 : null
+        };
+      }
+      if (hasSingleId) {
+        var _normalizedBody$order3;
+        return {
+          route: 'httpRefresh.singleId',
+          hasBatchIds: false,
+          hasSingleId: true,
+          hasNormalizedBody: !!normalizedBody,
+          singleId: singleIdRaw,
+          batchIds: [],
+          bodyOrderId: (_normalizedBody$order3 = normalizedBody === null || normalizedBody === void 0 ? void 0 : normalizedBody.order_id) !== null && _normalizedBody$order3 !== void 0 ? _normalizedBody$order3 : null
+        };
+      }
+      if ((_msg$relation_order_i = msg.relation_order_ids) !== null && _msg$relation_order_i !== void 0 && _msg$relation_order_i.length) {
+        var _normalizedBody$order4;
+        return {
+          route: 'httpRefresh.relationIds',
+          hasBatchIds: false,
+          hasSingleId: false,
+          hasNormalizedBody: !!normalizedBody,
+          singleId: null,
+          batchIds: msg.relation_order_ids,
+          bodyOrderId: (_normalizedBody$order4 = normalizedBody === null || normalizedBody === void 0 ? void 0 : normalizedBody.order_id) !== null && _normalizedBody$order4 !== void 0 ? _normalizedBody$order4 : null
+        };
+      }
+      return {
+        route: 'noop',
+        hasBatchIds: false,
+        hasSingleId: false,
+        hasNormalizedBody: !!normalizedBody,
+        singleId: null,
+        batchIds: [],
+        bodyOrderId: (_normalizedBody$order5 = normalizedBody === null || normalizedBody === void 0 ? void 0 : normalizedBody.order_id) !== null && _normalizedBody$order5 !== void 0 ? _normalizedBody$order5 : null
+      };
     }
   }, {
     key: "getOrderSyncThrottleMs",
@@ -199,12 +606,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "preload",
     value: function () {
       var _preload = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
-        var _this2 = this;
+        var _this3 = this;
         var getData;
         return _regeneratorRuntime().wrap(function _callee3$(_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
-              // const cachedOrders = await this.loadOrdersFromSQLite()
+              this.pushOrderFlowLog('preload.start', this.getOrderStoreSnapshot());
               // const hasPulledInCurrentWindow = this.hasPulledOrdersToday()
               // // 仅当缓存属于当前统计窗口时才直接复用，避免跨天/跨营业日窗口继续使用旧数据
               // if (cachedOrders.length > 0 && hasPulledInCurrentWindow) {
@@ -213,6 +620,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               //   this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list)
               //   return
               // }
+
               // if (hasPulledInCurrentWindow) {
               //   this.logInfo('当天已完成全量订单拉取，跳过本次全量拉取', {
               //     lastFullFetchAt: this.getStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY),
@@ -220,41 +628,45 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               //   return
               // }
               getData = /*#__PURE__*/function () {
-                var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+                var _ref3 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
                   var orders;
                   return _regeneratorRuntime().wrap(function _callee2$(_context2) {
                     while (1) switch (_context2.prev = _context2.next) {
                       case 0:
                         _context2.next = 2;
-                        return _this2.loadOrdersByServer();
+                        return _this3.loadOrdersByServer();
                       case 2:
                         orders = _context2.sent;
                         if (!(orders.length === 0)) {
-                          _context2.next = 5;
+                          _context2.next = 6;
                           break;
                         }
+                        _this3.pushOrderFlowLog('preload.empty', _this3.getOrderStoreSnapshot());
                         return _context2.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);
-                      case 9:
+                      case 6:
+                        _this3.store.list = cloneDeep(orders);
+                        _this3.syncOrdersMap();
+                        _this3.core.effects.emit(OrderHooks.onOrdersChanged, _this3.store.list);
+                        _this3.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
+                        _this3.pushOrderFlowLog('preload.done', _objectSpread(_objectSpread({}, _this3.getOrderStoreSnapshot()), {}, {
+                          loadedCount: orders.length
+                        }));
+                      case 11:
                       case "end":
                         return _context2.stop();
                     }
                   }, _callee2);
                 }));
                 return function getData() {
-                  return _ref.apply(this, arguments);
+                  return _ref3.apply(this, arguments);
                 };
               }();
               getData();
-            case 2:
+            case 3:
             case "end":
               return _context3.stop();
           }
-        }, _callee3);
+        }, _callee3, this);
       }));
       function preload() {
         return _preload.apply(this, arguments);
@@ -282,7 +694,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "getLocalOrderByOrderId",
     value: function () {
       var _getLocalOrderByOrderId = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(orderId) {
-        var _this3 = this;
+        var _this4 = this;
         var key, memoryOrder, orders, localOrder;
         return _regeneratorRuntime().wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
@@ -290,32 +702,40 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               key = this.getIdKey(orderId);
               memoryOrder = this.store.map.get(key);
               if (!memoryOrder) {
-                _context4.next = 4;
+                _context4.next = 5;
                 break;
               }
+              this.pushOrderFlowLog('getLocalOrderByOrderId.hitMemory', {
+                orderId: orderId,
+                key: key
+              });
               return _context4.abrupt("return", memoryOrder);
-            case 4:
-              _context4.next = 6;
+            case 5:
+              this.pushOrderFlowLog('getLocalOrderByOrderId.missMemory', {
+                orderId: orderId,
+                key: key
+              });
+              _context4.next = 8;
               return this.loadOrdersFromSQLite();
-            case 6:
+            case 8:
               orders = _context4.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;
+                if (shopOrderNumber && _this4.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 _this4.getIdKey(id) === key;
               });
               if (localOrder) {
-                _context4.next = 10;
+                _context4.next = 12;
                 break;
               }
               return _context4.abrupt("return", null);
-            case 10:
+            case 12:
               this.store.list = orders;
               this.syncOrdersMap();
               return _context4.abrupt("return", localOrder);
-            case 13:
+            case 15:
             case "end":
               return _context4.stop();
           }
@@ -330,57 +750,69 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "loadOrdersByServer",
     value: function () {
       var _loadOrdersByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
-        var _this$store;
+        var _this$store, _this$store2;
         var orderList, data;
         return _regeneratorRuntime().wrap(function _callee5$(_context5) {
           while (1) switch (_context5.prev = _context5.next) {
             case 0:
               orderList = [];
+              this.pushOrderFlowLog('loadOrdersByServer.start', _objectSpread(_objectSpread({}, this.getOrderStoreSnapshot()), {}, {
+                query: ((_this$store = this.store) === null || _this$store === void 0 ? void 0 : _this$store.createdAtQuery) || null,
+                hasOrderDataSource: !!this.orderDataSource
+              }));
               this.logInfo('loadOrdersByServer-开始', {
                 hasOrderDataSource: !!this.orderDataSource,
-                query: ((_this$store = this.store) === null || _this$store === void 0 ? void 0 : _this$store.createdAtQuery) || null
+                query: ((_this$store2 = this.store) === null || _this$store2 === void 0 ? void 0 : _this$store2.createdAtQuery) || null
               });
               if (!this.orderDataSource) {
-                _context5.next = 16;
+                _context5.next = 20;
                 break;
               }
-              _context5.prev = 3;
-              _context5.next = 6;
+              _context5.prev = 4;
+              _context5.next = 7;
               return this.orderDataSource.run({
                 sse: {
                   query: this.store.createdAtQuery
                 }
               });
-            case 6:
+            case 7:
               data = _context5.sent;
               orderList = data || [];
+              this.pushOrderFlowLog('loadOrdersByServer.sseSuccess', {
+                count: orderList.length
+              });
               this.logInfo('loadOrdersByServer-SSE拉取成功', {
                 count: orderList.length
               });
               this.markOrderPulledAtNow();
-              _context5.next = 16;
+              this.lastServerFullFetchAtMs = Date.now();
+              _context5.next = 20;
               break;
-            case 12:
-              _context5.prev = 12;
-              _context5.t0 = _context5["catch"](3);
+            case 15:
+              _context5.prev = 15;
+              _context5.t0 = _context5["catch"](4);
               orderList = [];
+              this.pushOrderFlowLog('loadOrdersByServer.sseFailed', {});
               this.logInfo('loadOrdersByServer-SSE拉取失败，回退为空数组');
-            case 16:
-              _context5.next = 18;
-              return this.saveOrdersToSQLite(orderList);
-            case 18:
+            case 20:
+              _context5.next = 22;
+              return this.replaceOrdersSnapshotInSQLite(orderList, 'loadOrdersByServer');
+            case 22:
+              this.pushOrderFlowLog('loadOrdersByServer.done', _objectSpread({
+                count: orderList.length
+              }, this.getOrderStoreSnapshot()));
               this.logInfo('loadOrdersByServer-结束', {
                 count: orderList.length
               });
-              _context5.next = 21;
+              _context5.next = 26;
               return this.core.effects.emit(OrderHooks.onOrdersLoaded, orderList);
-            case 21:
+            case 26:
               return _context5.abrupt("return", orderList);
-            case 22:
+            case 27:
             case "end":
               return _context5.stop();
           }
-        }, _callee5, this, [[3, 12]]);
+        }, _callee5, this, [[4, 15]]);
       }));
       function loadOrdersByServer() {
         return _loadOrdersByServer.apply(this, arguments);
@@ -396,51 +828,72 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "silentRefresh",
     value: (function () {
       var _silentRefresh = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6() {
-        var startTime, orders, errorMessage;
+        var startTime, elapsedSinceFullFetch, orders, errorMessage;
         return _regeneratorRuntime().wrap(function _callee6$(_context6) {
           while (1) switch (_context6.prev = _context6.next) {
             case 0:
               startTime = Date.now();
+              elapsedSinceFullFetch = Date.now() - this.lastServerFullFetchAtMs;
+              if (!(this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < ORDER_SILENT_REFRESH_MIN_INTERVAL_MS)) {
+                _context6.next = 5;
+                break;
+              }
+              this.pushOrderFlowLog('silentRefresh.skipped', _objectSpread({
+                elapsedMs: elapsedSinceFullFetch,
+                minIntervalMs: ORDER_SILENT_REFRESH_MIN_INTERVAL_MS
+              }, this.getOrderStoreSnapshot()));
+              return _context6.abrupt("return", this.store.list);
+            case 5:
+              this.pushOrderFlowLog('silentRefresh.start', _objectSpread(_objectSpread({}, this.getOrderStoreSnapshot()), {}, {
+                callerHint: 'Server.refreshOrdersInBackground 或其他调用方'
+              }));
               this.logInfo('silentRefresh 开始');
-              _context6.prev = 2;
-              _context6.next = 5;
+              _context6.prev = 7;
+              _context6.next = 10;
               return this.loadOrdersByServer();
-            case 5:
+            case 10:
               orders = _context6.sent;
               if (!(orders.length > 0)) {
-                _context6.next = 15;
+                _context6.next = 21;
                 break;
               }
               this.store.list = cloneDeep(orders);
               this.syncOrdersMap();
               this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
-              _context6.next = 12;
+              _context6.next = 17;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 12:
+            case 17:
+              this.pushOrderFlowLog('silentRefresh.done', _objectSpread({
+                orderCount: orders.length,
+                durationMs: Date.now() - startTime
+              }, this.getOrderStoreSnapshot()));
               this.logInfo('silentRefresh 完成', {
                 orderCount: orders.length,
                 duration: "".concat(Date.now() - startTime, "ms")
               });
-              _context6.next = 16;
+              _context6.next = 23;
               break;
-            case 15:
+            case 21:
+              this.pushOrderFlowLog('silentRefresh.empty', {
+                durationMs: Date.now() - startTime
+              });
               this.logInfo('silentRefresh: 服务器未返回数据');
-            case 16:
+            case 23:
               return _context6.abrupt("return", this.store.list);
-            case 19:
-              _context6.prev = 19;
-              _context6.t0 = _context6["catch"](2);
+            case 26:
+              _context6.prev = 26;
+              _context6.t0 = _context6["catch"](7);
               errorMessage = _context6.t0 instanceof Error ? _context6.t0.message : String(_context6.t0);
               this.logError('silentRefresh 失败', {
                 duration: "".concat(Date.now() - startTime, "ms"),
                 error: errorMessage
               });
               return _context6.abrupt("return", this.store.list);
-            case 24:
+            case 31:
             case "end":
               return _context6.stop();
           }
-        }, _callee6, this, [[2, 19]]);
+        }, _callee6, this, [[7, 26]]);
       }));
       function silentRefresh() {
         return _silentRefresh.apply(this, arguments);
@@ -450,10 +903,10 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "getOrdersByResourceId",
     value: function getOrdersByResourceId(resourceId) {
-      var _this4 = this;
+      var _this5 = this;
       var ids = this.resourceIdIndex.get(String(resourceId)) || [];
       return ids.map(function (id) {
-        return _this4.store.map.get(id);
+        return _this5.store.map.get(id);
       }).filter(function (order) {
         return !!order;
       });
@@ -467,7 +920,7 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "overwriteExistingOrder",
     value: (function () {
       var _overwriteExistingOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7(fresh) {
-        var _this5 = this;
+        var _this6 = this;
         var orderId, key;
         return _regeneratorRuntime().wrap(function _callee7$(_context7) {
           while (1) switch (_context7.prev = _context7.next) {
@@ -494,6 +947,12 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 overwritten: false
               });
             case 8:
+              this.pushOrderFlowLog('overwriteExistingOrder.start', _objectSpread(_objectSpread({
+                orderId: orderId,
+                storageKey: this.getOrderStorageKey(fresh)
+              }, this.getOrderStoreSnapshot()), {}, {
+                callerHint: 'Server.handleUpdateLocalOrder 本地已存在时'
+              }));
               this.logInfo('overwriteExistingOrder-开始覆盖', {
                 orderId: orderId,
                 storeOrderCountBefore: this.store.list.length
@@ -501,23 +960,26 @@ 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 _this6.getIdKey(id) === key ? fresh : order;
               });
               this.syncOrdersMap();
-              _context7.next = 13;
-              return this.saveOrdersToSQLite(this.store.list);
-            case 13:
+              _context7.next = 14;
+              return this.updateOrderInSQLite(fresh, 'overwriteExistingOrder');
+            case 14:
+              this.pushOrderFlowLog('overwriteExistingOrder.done', _objectSpread({
+                orderId: orderId
+              }, this.getOrderStoreSnapshot()));
               this.logInfo('overwriteExistingOrder-结束', {
                 orderId: orderId,
                 storeOrderCountAfter: this.store.list.length
               });
-              _context7.next = 16;
+              _context7.next = 18;
               return this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
-            case 16:
+            case 18:
               return _context7.abrupt("return", {
                 overwritten: true
               });
-            case 17:
+            case 19:
             case "end":
               return _context7.stop();
           }
@@ -547,12 +1009,21 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               this.logInfo('upsertOrdersFromRemote-订单列表为空', {});
               return _context8.abrupt("return");
             case 3:
+              this.pushOrderFlowLog('upsertOrdersFromRemote.start', {
+                count: freshOrders.length,
+                orderIds: freshOrders.map(function (o) {
+                  return o.order_id;
+                }).filter(function (id) {
+                  return id !== undefined && id !== null;
+                }),
+                callerHint: 'Server.handleUpdateLocalOrder / handleOrderSalesDetail / handleUpdateLocalOrdersBatch'
+              });
               this.logInfo('upsertOrdersFromRemote-开始', {
                 count: freshOrders.length
               });
-              _context8.next = 6;
-              return this.mergeOrdersToStore(freshOrders);
-            case 6:
+              _context8.next = 7;
+              return this.mergeOrdersToStore(freshOrders, 'upsertOrdersFromRemote');
+            case 7:
             case "end":
               return _context8.stop();
           }
@@ -633,44 +1104,44 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "syncOrdersMap",
     value: function syncOrdersMap() {
-      var _this6 = this;
+      var _this7 = this;
       this.store.map.clear();
       this.resourceIdIndex.clear();
-      var _iterator = _createForOfIteratorHelper(this.store.list),
-        _step;
+      var _iterator5 = _createForOfIteratorHelper(this.store.list),
+        _step5;
       try {
         var _loop = function _loop() {
-          var order = _step.value;
+          var order = _step5.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;
+          _this7.store.map.set(_this7.getIdKey(id), order);
+          var resourceIds = _this7.extractResourceIds(order);
+          var _iterator6 = _createForOfIteratorHelper(resourceIds),
+            _step6;
           try {
-            for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-              var resourceId = _step2.value;
+            for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
+              var resourceId = _step6.value;
               var key = String(resourceId);
-              var existing = _this6.resourceIdIndex.get(key) || [];
+              var existing = _this7.resourceIdIndex.get(key) || [];
               if (existing.some(function (eid) {
-                return _this6.getIdKey(eid) === _this6.getIdKey(id);
+                return _this7.getIdKey(eid) === _this7.getIdKey(id);
               })) continue;
               existing.push(id);
-              _this6.resourceIdIndex.set(key, existing);
+              _this7.resourceIdIndex.set(key, existing);
             }
           } catch (err) {
-            _iterator2.e(err);
+            _iterator6.e(err);
           } finally {
-            _iterator2.f();
+            _iterator6.f();
           }
         };
-        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
           if (_loop()) continue;
         }
       } catch (err) {
-        _iterator.e(err);
+        _iterator5.e(err);
       } finally {
-        _iterator.f();
+        _iterator5.f();
       }
     }
   }, {
@@ -725,28 +1196,38 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "setupOrderSync",
     value: function setupOrderSync() {
-      var _this7 = this;
+      var _this8 = this;
       if (!this.orderDataSource) return;
       this.orderDataSource.run({
         pubsub: {
           callback: function callback(res) {
-            var _message$id, _message$order_id, _message$type;
-            console.log('orderDataSource');
+            var _message$id, _message$order_id, _message$type, _message$id2, _message$order_id2, _message$type2;
+            console.log('orderDataSource', res);
             var pubsubReceivedAt = Date.now();
-            var message = _this7.normalizeOrderSyncMessage(res);
+            var message = _this8.normalizeOrderSyncMessage(res);
             if (!message) return;
             message._pubsubReceivedAt = pubsubReceivedAt;
-            _this7.pendingSyncMessages.push(message);
-            var throttleMs = _this7.getOrderSyncThrottleMs();
-            _this7.logInfo('orderSync-收到消息并入队', {
+            _this8.pendingSyncMessages.push(message);
+            var throttleMs = _this8.getOrderSyncThrottleMs();
+            var routeInfo = _this8.resolveSyncMessageRoute(message);
+            _this8.pushOrderFlowLog('orderSync.received', _objectSpread(_objectSpread({
               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: _this8.pendingSyncMessages.length,
+              throttleMs: throttleMs
+            }, routeInfo), {}, {
+              duplicateRiskHint: routeInfo.route === 'httpRefresh.batchIds' && routeInfo.hasNormalizedBody ? '有 body 但被 ids 优先，会走 HTTP 重拉' : routeInfo.route === 'bodyUpsert' ? 'body 直写，可能与 upsertOrdersFromRemote 重复' : null
+            }));
+            _this8.logInfo('orderSync-收到消息并入队', {
+              id: (_message$id2 = message.id) !== null && _message$id2 !== void 0 ? _message$id2 : null,
+              order_id: (_message$order_id2 = message.order_id) !== null && _message$order_id2 !== void 0 ? _message$order_id2 : null,
+              type: (_message$type2 = message.type) !== null && _message$type2 !== void 0 ? _message$type2 : null,
+              pendingCount: _this8.pendingSyncMessages.length,
               throttleMs: throttleMs,
               pubsubReceivedAt: new Date(pubsubReceivedAt).toISOString()
             });
-            _this7.scheduleOrderSyncThrottle();
+            _this8.scheduleOrderSyncThrottle();
           }
         }
       }).catch(function () {
@@ -763,19 +1244,26 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "scheduleOrderSyncThrottle",
     value: function scheduleOrderSyncThrottle() {
-      var _this8 = this;
+      var _this9 = this;
       if (this.isProcessingSyncBatch) return;
       if (this.isIdlePhase) {
         this.isIdlePhase = false;
+        this.pushOrderFlowLog('orderSync.flushImmediate', {
+          pendingCount: this.pendingSyncMessages.length
+        });
         this.logInfo('orderSync-首条消息立即触发处理');
         void this.flushOrderSyncMessagesByThrottle();
         return;
       }
       if (this.syncTimer) return;
       var throttleMs = this.getOrderSyncThrottleMs();
+      this.pushOrderFlowLog('orderSync.flushScheduled', {
+        pendingCount: this.pendingSyncMessages.length,
+        throttleMs: throttleMs
+      });
       this.syncTimer = setTimeout(function () {
-        _this8.syncTimer = undefined;
-        void _this8.flushOrderSyncMessagesByThrottle();
+        _this9.syncTimer = undefined;
+        void _this9.flushOrderSyncMessagesByThrottle();
       }, throttleMs);
     }
 
@@ -804,23 +1292,26 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               return _context10.abrupt("return");
             case 5:
               this.isProcessingSyncBatch = true;
-              _context10.prev = 6;
-              _context10.next = 9;
+              this.pushOrderFlowLog('orderSync.flushStart', {
+                pendingCount: this.pendingSyncMessages.length
+              });
+              _context10.prev = 7;
+              _context10.next = 10;
               return this.processOrderSyncMessages();
-            case 9:
-              _context10.prev = 9;
+            case 10:
+              _context10.prev = 10;
               this.isProcessingSyncBatch = false;
               if (this.pendingSyncMessages.length > 0) {
                 this.scheduleOrderSyncThrottle();
               } else {
                 this.isIdlePhase = true;
               }
-              return _context10.finish(9);
-            case 13:
+              return _context10.finish(10);
+            case 14:
             case "end":
               return _context10.stop();
           }
-        }, _callee10, this, [[6,, 9, 13]]);
+        }, _callee10, this, [[7,, 10, 14]]);
       }));
       function flushOrderSyncMessagesByThrottle() {
         return _flushOrderSyncMessagesByThrottle.apply(this, arguments);
@@ -843,7 +1334,8 @@ 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;
+        var _this10 = this;
+        var messages, batchProcessStartAt, earliestReceivedAt, upsertOrders, refreshIds, uniqueRefreshIds, upsertList, _this$filterRedundant, toFetch, skipped, freshOrders, batchProcessEndAt;
         return _regeneratorRuntime().wrap(function _callee11$(_context11) {
           while (1) switch (_context11.prev = _context11.next) {
             case 0:
@@ -856,6 +1348,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               return _context11.abrupt("return");
             case 4:
               batchProcessStartAt = Date.now();
+              this.pushOrderFlowLog('processOrderSyncMessages.start', _objectSpread({
+                messageCount: messages.length
+              }, this.getOrderStoreSnapshot()));
               earliestReceivedAt = Math.min.apply(Math, _toConsumableArray(messages.map(function (m) {
                 var _m$_pubsubReceivedAt;
                 return (_m$_pubsubReceivedAt = m._pubsubReceivedAt) !== null && _m$_pubsubReceivedAt !== void 0 ? _m$_pubsubReceivedAt : batchProcessStartAt;
@@ -868,91 +1363,105 @@ 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 = _this10.resolveSyncMessageRoute(msg);
+                _this10.pushOrderFlowLog('processOrderSyncMessages.messageRoute', _objectSpread({
+                  msgIndex: msgIndex
+                }, routeInfo));
+                var hasBatchIds = routeInfo.hasBatchIds;
+                var singleId = routeInfo.singleId;
+                var hasSingleId = routeInfo.hasSingleId;
+                var normalizedBody = _this10.normalizeOrderSyncPayload(msg.body || msg.data);
+                if (routeInfo.route === 'bodyUpsert' && normalizedBody) {
+                  upsertOrders.set(_this10.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.pushOrderFlowLog('processOrderSyncMessages.deduped', {
+                upsertCount: upsertList.length,
+                upsertOrderIds: upsertList.map(function (o) {
+                  return o.order_id;
+                }),
+                refreshIdCount: uniqueRefreshIds.length,
+                refreshIds: uniqueRefreshIds,
+                willCallMergeTimes: (upsertList.length > 0 ? 1 : 0) + (uniqueRefreshIds.length > 0 ? 1 : 0)
+              });
               this.logInfo('processOrderSyncMessages-去重完成', {
                 upsertCount: upsertList.length,
                 refreshIdCount: uniqueRefreshIds.length
               });
               if (!(upsertList.length > 0)) {
-                _context11.next = 39;
+                _context11.next = 18;
                 break;
               }
-              _context11.next = 39;
-              return this.mergeOrdersToStore(upsertList);
-            case 39:
+              _context11.next = 18;
+              return this.mergeOrdersToStore(upsertList, 'pubsub.bodyUpsert');
+            case 18:
               if (!(uniqueRefreshIds.length > 0)) {
-                _context11.next = 46;
+                _context11.next = 31;
                 break;
               }
-              _context11.next = 42;
-              return this.fetchOrdersByHttp(uniqueRefreshIds);
-            case 42:
+              _this$filterRedundant = this.filterRedundantHttpRefreshIds(uniqueRefreshIds), toFetch = _this$filterRedundant.toFetch, skipped = _this$filterRedundant.skipped;
+              if (skipped.length > 0) {
+                this.pushOrderFlowLog('processOrderSyncMessages.httpRefreshFiltered', {
+                  requestedIds: uniqueRefreshIds,
+                  skippedIds: skipped.map(function (item) {
+                    return item.orderId;
+                  }),
+                  skipped: skipped
+                });
+              }
+              if (!(toFetch.length > 0)) {
+                _context11.next = 31;
+                break;
+              }
+              _context11.next = 24;
+              return this.fetchOrdersByHttp(toFetch);
+            case 24:
               freshOrders = _context11.sent;
               if (!(freshOrders.length > 0)) {
-                _context11.next = 46;
+                _context11.next = 30;
                 break;
               }
-              _context11.next = 46;
-              return this.mergeOrdersToStore(freshOrders);
-            case 46:
+              _context11.next = 28;
+              return this.mergeOrdersToStore(freshOrders, 'pubsub.httpRefresh');
+            case 28:
+              _context11.next = 31;
+              break;
+            case 30:
+              this.pushOrderFlowLog('processOrderSyncMessages.httpRefreshEmpty', {
+                refreshIds: toFetch
+              });
+            case 31:
               if (!(upsertList.length === 0 && uniqueRefreshIds.length === 0)) {
-                _context11.next = 48;
+                _context11.next = 34;
                 break;
               }
+              this.pushOrderFlowLog('processOrderSyncMessages.noop', {});
               return _context11.abrupt("return");
-            case 48:
+            case 34:
               batchProcessEndAt = Date.now();
+              this.pushOrderFlowLog('processOrderSyncMessages.done', _objectSpread({
+                upsertCount: upsertList.length,
+                refreshIdCount: uniqueRefreshIds.length,
+                batchProcessDurationMs: batchProcessEndAt - batchProcessStartAt
+              }, this.getOrderStoreSnapshot()));
               this.logInfo('processOrderSyncMessages-结束', {
                 upsertCount: upsertList.length,
                 refreshIdCount: uniqueRefreshIds.length,
                 batchProcessDurationMs: batchProcessEndAt - batchProcessStartAt,
                 totalFromPubsubToProcessedMs: batchProcessEndAt - earliestReceivedAt
               });
-              _context11.next = 52;
+              _context11.next = 39;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 52:
+            case 39:
             case "end":
               return _context11.stop();
           }
-        }, _callee11, this, [[10, 27, 30, 33]]);
+        }, _callee11, this);
       }));
       function processOrderSyncMessages() {
         return _processOrderSyncMessages.apply(this, arguments);
@@ -984,18 +1493,27 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               }
               return _context12.abrupt("return", []);
             case 2:
-              _context12.prev = 2;
+              this.pushOrderFlowLog('fetchOrdersByHttp.start', {
+                ids: ids,
+                count: ids.length
+              });
+              _context12.prev = 3;
               if (!(typeof this.orderDataSource.fetchOrdersByIds === 'function')) {
-                _context12.next = 8;
+                _context12.next = 10;
                 break;
               }
-              _context12.next = 6;
+              _context12.next = 7;
               return this.orderDataSource.fetchOrdersByIds(ids);
-            case 6:
+            case 7:
               _orderList = _context12.sent;
+              this.pushOrderFlowLog('fetchOrdersByHttp.done', {
+                ids: ids,
+                count: (_orderList === null || _orderList === void 0 ? void 0 : _orderList.length) || 0,
+                via: 'fetchOrdersByIds'
+              });
               return _context12.abrupt("return", _orderList || []);
-            case 8:
-              _context12.next = 10;
+            case 10:
+              _context12.next = 12;
               return this.orderDataSource.run({
                 http: {
                   query: {
@@ -1003,18 +1521,26 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                   }
                 }
               });
-            case 10:
+            case 12:
               orderList = _context12.sent;
+              this.pushOrderFlowLog('fetchOrdersByHttp.done', {
+                ids: ids,
+                count: (orderList === null || orderList === void 0 ? void 0 : orderList.length) || 0,
+                via: 'run.http'
+              });
               return _context12.abrupt("return", orderList || []);
-            case 14:
-              _context12.prev = 14;
-              _context12.t0 = _context12["catch"](2);
-              return _context12.abrupt("return", []);
             case 17:
+              _context12.prev = 17;
+              _context12.t0 = _context12["catch"](3);
+              this.pushOrderFlowLog('fetchOrdersByHttp.failed', {
+                ids: ids
+              });
+              return _context12.abrupt("return", []);
+            case 21:
             case "end":
               return _context12.stop();
           }
-        }, _callee12, this, [[2, 14]]);
+        }, _callee12, this, [[3, 17]]);
       }));
       function fetchOrdersByHttp(_x6) {
         return _fetchOrdersByHttp.apply(this, arguments);
@@ -1028,87 +1554,123 @@ 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;
+      var _mergeOrdersToStore = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee13(freshOrders, source) {
+        var _this11 = this;
+        var freshMap, _iterator7, _step7, order, id, uniqueFreshCount, patchedOrders, mergeActions, updatedList, _iterator8, _step8, _order, _id, insertCount, updateCount;
         return _regeneratorRuntime().wrap(function _callee13$(_context13) {
           while (1) switch (_context13.prev = _context13.next) {
             case 0:
+              this.pushOrderFlowLog('mergeOrdersToStore.start', _objectSpread({
+                source: source,
+                freshOrderCount: freshOrders.length,
+                freshOrderIds: freshOrders.map(function (o) {
+                  return o.order_id;
+                }).filter(function (id) {
+                  return id !== undefined && id !== null;
+                })
+              }, this.getOrderStoreSnapshot()));
               this.logInfo('mergeOrdersToStore-开始', {
                 freshOrderCount: freshOrders.length,
                 storeOrderCountBefore: this.store.list.length
               });
               freshMap = new Map();
-              _iterator4 = _createForOfIteratorHelper(freshOrders);
-              _context13.prev = 3;
-              _iterator4.s();
-            case 5:
-              if ((_step4 = _iterator4.n()).done) {
-                _context13.next = 13;
+              _iterator7 = _createForOfIteratorHelper(freshOrders);
+              _context13.prev = 4;
+              _iterator7.s();
+            case 6:
+              if ((_step7 = _iterator7.n()).done) {
+                _context13.next = 14;
                 break;
               }
-              order = _step4.value;
+              order = _step7.value;
               id = order === null || order === void 0 ? void 0 : order.order_id;
               if (!(id === undefined || id === null)) {
-                _context13.next = 10;
+                _context13.next = 11;
                 break;
               }
-              return _context13.abrupt("continue", 11);
-            case 10:
-              freshMap.set(this.getIdKey(id), order);
+              return _context13.abrupt("continue", 12);
             case 11:
-              _context13.next = 5;
+              freshMap.set(this.getIdKey(id), order);
+            case 12:
+              _context13.next = 6;
               break;
-            case 13:
-              _context13.next = 18;
+            case 14:
+              _context13.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:
+            case 16:
+              _context13.prev = 16;
+              _context13.t0 = _context13["catch"](4);
+              _iterator7.e(_context13.t0);
+            case 19:
+              _context13.prev = 19;
+              _iterator7.f();
+              return _context13.finish(19);
+            case 22:
               uniqueFreshCount = freshMap.size;
+              patchedOrders = _toConsumableArray(freshMap.values());
+              mergeActions = {};
               updatedList = this.store.list.map(function (order) {
                 var id = order.order_id;
                 if (id === undefined || id === null) return order;
-                var key = _this9.getIdKey(id);
+                var key = _this11.getIdKey(id);
                 if (!freshMap.has(key)) return order;
                 var fresh = freshMap.get(key);
                 freshMap.delete(key);
+                mergeActions[key] = 'update';
                 return fresh;
               });
-              _iterator5 = _createForOfIteratorHelper(freshMap.values());
+              _iterator8 = _createForOfIteratorHelper(freshMap.values());
               try {
-                for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-                  _order = _step5.value;
+                for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
+                  _order = _step8.value;
+                  _id = _order.order_id;
+                  if (_id !== undefined && _id !== null) {
+                    mergeActions[this.getIdKey(_id)] = 'insert';
+                  }
                   updatedList.push(_order);
                 }
               } catch (err) {
-                _iterator5.e(err);
+                _iterator8.e(err);
               } finally {
-                _iterator5.f();
+                _iterator8.f();
               }
+              insertCount = Object.values(mergeActions).filter(function (v) {
+                return v === 'insert';
+              }).length;
+              updateCount = Object.values(mergeActions).filter(function (v) {
+                return v === 'update';
+              }).length;
               this.store.list = updatedList;
               this.syncOrdersMap();
-              _context13.next = 29;
-              return this.saveOrdersToSQLite(this.store.list);
-            case 29:
+              _context13.next = 34;
+              return this.patchOrdersInSQLite(patchedOrders, source, mergeActions);
+            case 34:
+              this.pushOrderFlowLog('mergeOrdersToStore.done', _objectSpread({
+                source: source,
+                uniqueFreshCount: uniqueFreshCount,
+                insertCount: insertCount,
+                updateCount: updateCount,
+                patchedCount: patchedOrders.length,
+                patchedOrderIds: patchedOrders.map(function (o) {
+                  return o.order_id;
+                }),
+                patchedStorageKeys: patchedOrders.map(function (o) {
+                  return _this11.getOrderStorageKey(o);
+                }),
+                mergeActions: mergeActions
+              }, this.getOrderStoreSnapshot()));
               this.logInfo('mergeOrdersToStore-结束', {
                 uniqueFreshCount: uniqueFreshCount,
                 storeOrderCountAfter: this.store.list.length
               });
               this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
-            case 31:
+            case 37:
             case "end":
               return _context13.stop();
           }
-        }, _callee13, this, [[3, 15, 18, 21]]);
+        }, _callee13, this, [[4, 16, 19, 22]]);
       }));
-      function mergeOrdersToStore(_x7) {
+      function mergeOrdersToStore(_x7, _x8) {
         return _mergeOrdersToStore.apply(this, arguments);
       }
       return mergeOrdersToStore;
@@ -1145,17 +1707,17 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "uniqueOrderIds",
     value: function uniqueOrderIds(ids) {
       var idMap = new Map();
-      var _iterator6 = _createForOfIteratorHelper(ids),
-        _step6;
+      var _iterator9 = _createForOfIteratorHelper(ids),
+        _step9;
       try {
-        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-          var id = _step6.value;
+        for (_iterator9.s(); !(_step9 = _iterator9.n()).done;) {
+          var id = _step9.value;
           idMap.set(this.getIdKey(id), id);
         }
       } catch (err) {
-        _iterator6.e(err);
+        _iterator9.e(err);
       } finally {
-        _iterator6.f();
+        _iterator9.f();
       }
       return _toConsumableArray(idMap.values());
     }
@@ -1165,6 +1727,27 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return String(id);
     }
 
+    /**
+     * 解析订单 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 '';
+    }
+
     /**
      * 当前订单拉取窗口：
      * - 优先使用 createdAtQuery.sales_time_between（已按营业日边界初始化）
@@ -1173,9 +1756,9 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "getCurrentPullWindow",
     value: function getCurrentPullWindow() {
-      var _this$store2;
+      var _this$store3;
       var now = dayjs();
-      var range = (_this$store2 = this.store) === null || _this$store2 === void 0 || (_this$store2 = _this$store2.createdAtQuery) === null || _this$store2 === void 0 ? void 0 : _this$store2.sales_time_between;
+      var range = (_this$store3 = this.store) === null || _this$store3 === void 0 || (_this$store3 = _this$store3.createdAtQuery) === null || _this$store3 === void 0 ? void 0 : _this$store3.sales_time_between;
       if (Array.isArray(range) && range.length >= 2) {
         var _startAt = dayjs(range[0]);
         var endExclusiveAt = dayjs(range[1]);
@@ -1221,7 +1804,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 (_unused8) {
         // 忽略存储异常，避免影响主流程
       }
       return null;
@@ -1238,7 +1821,7 @@ 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 (_unused9) {
         // 忽略存储异常，避免影响主流程
       }
     }
@@ -1278,12 +1861,11 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       return loadOrdersFromSQLite;
     }()
     /**
-     * 串行执行订单 SQLite 保存任务，保证 clear + bulkAdd 组合不会被其它订单保存插入。
+     * 串行执行订单 SQLite 写入任务，避免快照替换与增量 upsert 并发交错。
      *
      * @example
      * await this.runInOrderSQLiteSaveQueue(async () => {
-     *   await this.dbManager.clear(INDEXDB_STORE_NAME)
-     *   await this.dbManager.bulkAdd(INDEXDB_STORE_NAME, orders)
+     *   await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, orders)
      * })
      */
   }, {
@@ -1307,88 +1889,425 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
           }
         }, _callee15, this);
       }));
-      function runInOrderSQLiteSaveQueue(_x8) {
+      function runInOrderSQLiteSaveQueue(_x9) {
         return _runInOrderSQLiteSaveQueue.apply(this, arguments);
       }
       return runInOrderSQLiteSaveQueue;
     }()
     /**
-     * 保存订单列表到 SQLite，内部会先清空 orders 表再批量写入当前快照。
+     * 批量增量 upsert 订单到 SQLite，不清空表；用于 pubsub / HTTP 增量合并。
      *
      * @example
-     * await this.saveOrdersToSQLite(this.store.list)
+     * await this.patchOrdersInSQLite(freshOrders)
      */
     )
   }, {
-    key: "saveOrdersToSQLite",
+    key: "patchOrdersInSQLite",
     value: (function () {
-      var _saveOrdersToSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee17(orderList) {
-        var _this10 = this;
-        var orderListSnapshot;
+      var _patchOrdersInSQLite = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee17(orders, source) {
+        var _this12 = this;
+        var mergeActions,
+          ordersSnapshot,
+          _this$filterRedundant2,
+          toWrite,
+          skipped,
+          _args17 = arguments;
         return _regeneratorRuntime().wrap(function _callee17$(_context17) {
           while (1) switch (_context17.prev = _context17.next) {
             case 0:
-              if (this.dbManager) {
-                _context17.next = 2;
+              mergeActions = _args17.length > 2 && _args17[2] !== undefined ? _args17[2] : {};
+              if (!(!this.dbManager || orders.length === 0)) {
+                _context17.next = 4;
                 break;
               }
+              this.pushOrderFlowLog('patchOrdersInSQLite.skip', {
+                source: source,
+                hasDbManager: !!this.dbManager,
+                inputCount: orders.length
+              });
               return _context17.abrupt("return");
-            case 2:
-              orderListSnapshot = cloneDeep(orderList);
-              _context17.prev = 3;
-              _context17.next = 6;
+            case 4:
+              ordersSnapshot = cloneDeep(orders).filter(function (order) {
+                return _this12.getOrderStorageKey(order);
+              });
+              if (!(ordersSnapshot.length === 0)) {
+                _context17.next = 8;
+                break;
+              }
+              this.pushOrderFlowLog('patchOrdersInSQLite.skipNoStorageKey', {
+                source: source,
+                inputCount: orders.length
+              });
+              return _context17.abrupt("return");
+            case 8:
+              _this$filterRedundant2 = this.filterRedundantPatchOrders(source, ordersSnapshot, mergeActions), toWrite = _this$filterRedundant2.toWrite, skipped = _this$filterRedundant2.skipped;
+              if (skipped.length > 0) {
+                this.pushOrderFlowLog('patchOrdersInSQLite.dedupeSkipped', {
+                  source: source,
+                  skippedCount: skipped.length,
+                  skipped: skipped
+                });
+              }
+              if (!(toWrite.length === 0)) {
+                _context17.next = 13;
+                break;
+              }
+              this.pushOrderFlowLog('patchOrdersInSQLite.skipAllDeduped', {
+                source: source,
+                inputCount: ordersSnapshot.length,
+                skipped: skipped
+              });
+              return _context17.abrupt("return");
+            case 13:
+              _context17.prev = 13;
+              _context17.next = 16;
               return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee16() {
+                var writeMethod, _iterator10, _step10, order, writeSeq;
                 return _regeneratorRuntime().wrap(function _callee16$(_context16) {
                   while (1) switch (_context16.prev = _context16.next) {
                     case 0:
-                      _this10.logInfo('saveOrdersToSQLite-开始', {
+                      writeMethod = 'none';
+                      _this12.pushOrderFlowLog('patchOrdersInSQLite.start', {
+                        source: source,
+                        count: toWrite.length,
+                        orderIds: toWrite.map(function (o) {
+                          return o.order_id;
+                        }),
+                        storageKeys: toWrite.map(function (o) {
+                          return _this12.getOrderStorageKey(o);
+                        }),
+                        dedupedCount: skipped.length
+                      });
+                      _this12.logInfo('patchOrdersInSQLite-开始', {
+                        source: source,
+                        count: toWrite.length
+                      });
+                      if (!(typeof _this12.dbManager.bulkUpdate === 'function')) {
+                        _context16.next = 9;
+                        break;
+                      }
+                      writeMethod = 'bulkUpdate';
+                      _context16.next = 7;
+                      return _this12.dbManager.bulkUpdate(INDEXDB_STORE_NAME, toWrite);
+                    case 7:
+                      _context16.next = 34;
+                      break;
+                    case 9:
+                      if (!(typeof _this12.dbManager.bulkAdd === 'function')) {
+                        _context16.next = 15;
+                        break;
+                      }
+                      writeMethod = 'bulkAdd';
+                      _context16.next = 13;
+                      return _this12.dbManager.bulkAdd(INDEXDB_STORE_NAME, toWrite);
+                    case 13:
+                      _context16.next = 34;
+                      break;
+                    case 15:
+                      if (!(typeof _this12.dbManager.update === 'function')) {
+                        _context16.next = 34;
+                        break;
+                      }
+                      writeMethod = 'update';
+                      _iterator10 = _createForOfIteratorHelper(toWrite);
+                      _context16.prev = 18;
+                      _iterator10.s();
+                    case 20:
+                      if ((_step10 = _iterator10.n()).done) {
+                        _context16.next = 26;
+                        break;
+                      }
+                      order = _step10.value;
+                      _context16.next = 24;
+                      return _this12.dbManager.update(INDEXDB_STORE_NAME, order);
+                    case 24:
+                      _context16.next = 20;
+                      break;
+                    case 26:
+                      _context16.next = 31;
+                      break;
+                    case 28:
+                      _context16.prev = 28;
+                      _context16.t0 = _context16["catch"](18);
+                      _iterator10.e(_context16.t0);
+                    case 31:
+                      _context16.prev = 31;
+                      _iterator10.f();
+                      return _context16.finish(31);
+                    case 34:
+                      writeSeq = _this12.trackOrderWrite(source, writeMethod, toWrite, mergeActions);
+                      _this12.recordRecentSqliteWrite(source, toWrite);
+                      _this12.pushOrderFlowLog('patchOrdersInSQLite.done', {
+                        source: source,
+                        writeSeq: writeSeq,
+                        count: toWrite.length,
+                        writeMethod: writeMethod,
+                        dedupedCount: skipped.length
+                      });
+                      _this12.logInfo('patchOrdersInSQLite-完成', {
+                        source: source,
+                        count: toWrite.length,
+                        dedupedCount: skipped.length
+                      });
+                    case 38:
+                    case "end":
+                      return _context16.stop();
+                  }
+                }, _callee16, null, [[18, 28, 31, 34]]);
+              })));
+            case 16:
+              _context17.next = 22;
+              break;
+            case 18:
+              _context17.prev = 18;
+              _context17.t0 = _context17["catch"](13);
+              this.pushOrderFlowLog('patchOrdersInSQLite.error', {
+                source: source,
+                error: _context17.t0 instanceof Error ? _context17.t0.message : String(_context17.t0),
+                orderCount: ordersSnapshot.length
+              });
+              this.logError('增量保存订单到 SQLite 失败', {
+                error: _context17.t0 instanceof Error ? _context17.t0.message : String(_context17.t0),
+                orderCount: ordersSnapshot.length
+              });
+            case 22:
+            case "end":
+              return _context17.stop();
+          }
+        }, _callee17, this, [[13, 18]]);
+      }));
+      function patchOrdersInSQLite(_x10, _x11) {
+        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 _callee19(order, source) {
+        var _this13 = this;
+        var _order$order_id3, orderSnapshot, _orderSnapshot$order_5, _orderSnapshot$order_6;
+        return _regeneratorRuntime().wrap(function _callee19$(_context19) {
+          while (1) switch (_context19.prev = _context19.next) {
+            case 0:
+              if (!(!this.dbManager || !this.getOrderStorageKey(order))) {
+                _context19.next = 3;
+                break;
+              }
+              this.pushOrderFlowLog('updateOrderInSQLite.skip', {
+                source: source,
+                hasDbManager: !!this.dbManager,
+                orderId: (_order$order_id3 = order === null || order === void 0 ? void 0 : order.order_id) !== null && _order$order_id3 !== void 0 ? _order$order_id3 : null
+              });
+              return _context19.abrupt("return");
+            case 3:
+              orderSnapshot = cloneDeep(order);
+              _context19.prev = 4;
+              _context19.next = 7;
+              return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee18() {
+                var _orderSnapshot$order_, _orderSnapshot$order_2, _orderSnapshot$order_3, _orderSnapshot$order_4;
+                var writeMethod, writeSeq;
+                return _regeneratorRuntime().wrap(function _callee18$(_context18) {
+                  while (1) switch (_context18.prev = _context18.next) {
+                    case 0:
+                      writeMethod = 'none';
+                      _this13.pushOrderFlowLog('updateOrderInSQLite.start', {
+                        source: source,
+                        orderId: (_orderSnapshot$order_ = orderSnapshot.order_id) !== null && _orderSnapshot$order_ !== void 0 ? _orderSnapshot$order_ : null,
+                        storageKey: _this13.getOrderStorageKey(orderSnapshot)
+                      });
+                      _this13.logInfo('updateOrderInSQLite-开始', {
+                        source: source,
+                        orderId: (_orderSnapshot$order_2 = orderSnapshot.order_id) !== null && _orderSnapshot$order_2 !== void 0 ? _orderSnapshot$order_2 : null,
+                        storageKey: _this13.getOrderStorageKey(orderSnapshot)
+                      });
+                      if (!(typeof _this13.dbManager.update === 'function')) {
+                        _context18.next = 9;
+                        break;
+                      }
+                      writeMethod = 'update';
+                      _context18.next = 7;
+                      return _this13.dbManager.update(INDEXDB_STORE_NAME, orderSnapshot);
+                    case 7:
+                      _context18.next = 19;
+                      break;
+                    case 9:
+                      if (!(typeof _this13.dbManager.bulkUpdate === 'function')) {
+                        _context18.next = 15;
+                        break;
+                      }
+                      writeMethod = 'bulkUpdate';
+                      _context18.next = 13;
+                      return _this13.dbManager.bulkUpdate(INDEXDB_STORE_NAME, [orderSnapshot]);
+                    case 13:
+                      _context18.next = 19;
+                      break;
+                    case 15:
+                      if (!(typeof _this13.dbManager.bulkAdd === 'function')) {
+                        _context18.next = 19;
+                        break;
+                      }
+                      writeMethod = 'bulkAdd';
+                      _context18.next = 19;
+                      return _this13.dbManager.bulkAdd(INDEXDB_STORE_NAME, [orderSnapshot]);
+                    case 19:
+                      writeSeq = _this13.trackOrderWrite(source, writeMethod, [orderSnapshot], {}, 'singleUpdate');
+                      _this13.recordRecentSqliteWrite(source, [orderSnapshot]);
+                      _this13.pushOrderFlowLog('updateOrderInSQLite.done', {
+                        source: source,
+                        writeSeq: writeSeq,
+                        orderId: (_orderSnapshot$order_3 = orderSnapshot.order_id) !== null && _orderSnapshot$order_3 !== void 0 ? _orderSnapshot$order_3 : null,
+                        storageKey: _this13.getOrderStorageKey(orderSnapshot),
+                        writeMethod: writeMethod
+                      });
+                      _this13.logInfo('updateOrderInSQLite-完成', {
+                        orderId: (_orderSnapshot$order_4 = orderSnapshot.order_id) !== null && _orderSnapshot$order_4 !== void 0 ? _orderSnapshot$order_4 : null
+                      });
+                    case 23:
+                    case "end":
+                      return _context18.stop();
+                  }
+                }, _callee18);
+              })));
+            case 7:
+              _context19.next = 13;
+              break;
+            case 9:
+              _context19.prev = 9;
+              _context19.t0 = _context19["catch"](4);
+              this.pushOrderFlowLog('updateOrderInSQLite.error', {
+                source: source,
+                error: _context19.t0 instanceof Error ? _context19.t0.message : String(_context19.t0),
+                orderId: (_orderSnapshot$order_5 = orderSnapshot.order_id) !== null && _orderSnapshot$order_5 !== void 0 ? _orderSnapshot$order_5 : null
+              });
+              this.logError('单条保存订单到 SQLite 失败', {
+                error: _context19.t0 instanceof Error ? _context19.t0.message : String(_context19.t0),
+                orderId: (_orderSnapshot$order_6 = orderSnapshot.order_id) !== null && _orderSnapshot$order_6 !== void 0 ? _orderSnapshot$order_6 : null
+              });
+            case 13:
+            case "end":
+              return _context19.stop();
+          }
+        }, _callee19, this, [[4, 9]]);
+      }));
+      function updateOrderInSQLite(_x12, _x13) {
+        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 _callee21(orderList, source) {
+        var _this14 = this;
+        var orderListSnapshot;
+        return _regeneratorRuntime().wrap(function _callee21$(_context21) {
+          while (1) switch (_context21.prev = _context21.next) {
+            case 0:
+              if (this.dbManager) {
+                _context21.next = 3;
+                break;
+              }
+              this.pushOrderFlowLog('replaceOrdersSnapshotInSQLite.skip', {
+                source: source,
+                count: orderList.length
+              });
+              return _context21.abrupt("return");
+            case 3:
+              orderListSnapshot = cloneDeep(orderList);
+              _context21.prev = 4;
+              _context21.next = 7;
+              return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee20() {
+                var writeSeq;
+                return _regeneratorRuntime().wrap(function _callee20$(_context20) {
+                  while (1) switch (_context20.prev = _context20.next) {
+                    case 0:
+                      _this14.pushOrderFlowLog('replaceOrdersSnapshotInSQLite.start', {
+                        source: source,
+                        count: orderListSnapshot.length
+                      });
+                      _this14.logInfo('replaceOrdersSnapshotInSQLite-开始', {
+                        source: source,
                         count: orderListSnapshot.length
                       });
-                      _context16.next = 3;
-                      return _this10.dbManager.clear(INDEXDB_STORE_NAME);
-                    case 3:
-                      _this10.logInfo('saveOrdersToSQLite-clear完成', {
+                      _context20.next = 4;
+                      return _this14.dbManager.clear(INDEXDB_STORE_NAME);
+                    case 4:
+                      _this14.pushOrderFlowLog('replaceOrdersSnapshotInSQLite.cleared', {
+                        source: source,
+                        count: orderListSnapshot.length
+                      });
+                      _this14.logInfo('replaceOrdersSnapshotInSQLite-clear完成', {
                         count: orderListSnapshot.length
                       });
                       if (!(orderListSnapshot.length === 0)) {
-                        _context16.next = 6;
+                        _context20.next = 9;
                         break;
                       }
-                      return _context16.abrupt("return");
-                    case 6:
-                      _context16.next = 8;
-                      return _this10.dbManager.bulkAdd(INDEXDB_STORE_NAME, orderListSnapshot);
-                    case 8:
-                      _this10.logInfo('saveOrdersToSQLite-bulkAdd完成', {
-                        count: orderListSnapshot.length
+                      _this14.pushOrderFlowLog('replaceOrdersSnapshotInSQLite.doneEmpty', {
+                        source: source
                       });
+                      return _context20.abrupt("return");
                     case 9:
+                      _context20.next = 11;
+                      return _this14.dbManager.bulkAdd(INDEXDB_STORE_NAME, orderListSnapshot);
+                    case 11:
+                      writeSeq = _this14.trackOrderWrite(source, 'clear+bulkAdd', orderListSnapshot, {}, 'snapshot');
+                      _this14.recordRecentSqliteWrite(source, orderListSnapshot);
+                      _this14.pushOrderFlowLog('replaceOrdersSnapshotInSQLite.done', {
+                        source: source,
+                        writeSeq: writeSeq,
+                        count: orderListSnapshot.length,
+                        writeMethod: 'clear+bulkAdd'
+                      });
+                      _this14.logInfo('replaceOrdersSnapshotInSQLite-bulkAdd完成', {
+                        count: orderListSnapshot.length
+                      });
+                    case 15:
                     case "end":
-                      return _context16.stop();
+                      return _context20.stop();
                   }
-                }, _callee16);
+                }, _callee20);
               })));
-            case 6:
-              _context17.next = 11;
+            case 7:
+              _context21.next = 13;
               break;
-            case 8:
-              _context17.prev = 8;
-              _context17.t0 = _context17["catch"](3);
-              // SQLite 异常，避免影响主流程
-              this.logError('保存订单到 SQLite 失败', {
-                error: _context17.t0 instanceof Error ? _context17.t0.message : String(_context17.t0),
+            case 9:
+              _context21.prev = 9;
+              _context21.t0 = _context21["catch"](4);
+              this.pushOrderFlowLog('replaceOrdersSnapshotInSQLite.error', {
+                source: source,
+                error: _context21.t0 instanceof Error ? _context21.t0.message : String(_context21.t0),
                 orderList: orderListSnapshot.length
               });
-            case 11:
+              this.logError('全量保存订单到 SQLite 失败', {
+                error: _context21.t0 instanceof Error ? _context21.t0.message : String(_context21.t0),
+                orderList: orderListSnapshot.length
+              });
+            case 13:
             case "end":
-              return _context17.stop();
+              return _context21.stop();
           }
-        }, _callee17, this, [[3, 8]]);
+        }, _callee21, this, [[4, 9]]);
       }));
-      function saveOrdersToSQLite(_x9) {
-        return _saveOrdersToSQLite.apply(this, arguments);
+      function replaceOrdersSnapshotInSQLite(_x14, _x15) {
+        return _replaceOrdersSnapshotInSQLite.apply(this, arguments);
       }
-      return saveOrdersToSQLite;
+      return replaceOrdersSnapshotInSQLite;
     }()
     /**
      * 清空订单模块的内存数据和本地 SQLite 订单表。
@@ -1400,39 +2319,39 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "clear",
     value: (function () {
-      var _clear = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee19() {
-        var _this11 = this;
-        return _regeneratorRuntime().wrap(function _callee19$(_context19) {
-          while (1) switch (_context19.prev = _context19.next) {
+      var _clear = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee23() {
+        var _this15 = this;
+        return _regeneratorRuntime().wrap(function _callee23$(_context23) {
+          while (1) switch (_context23.prev = _context23.next) {
             case 0:
               this.store.list = [];
               this.store.map = new Map();
               this.resourceIdIndex.clear();
               if (!this.dbManager) {
-                _context19.next = 6;
+                _context23.next = 6;
                 break;
               }
-              _context19.next = 6;
-              return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee18() {
-                return _regeneratorRuntime().wrap(function _callee18$(_context18) {
-                  while (1) switch (_context18.prev = _context18.next) {
+              _context23.next = 6;
+              return this.runInOrderSQLiteSaveQueue( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee22() {
+                return _regeneratorRuntime().wrap(function _callee22$(_context22) {
+                  while (1) switch (_context22.prev = _context22.next) {
                     case 0:
-                      _context18.next = 2;
-                      return _this11.dbManager.clear(INDEXDB_STORE_NAME);
+                      _context22.next = 2;
+                      return _this15.dbManager.clear(INDEXDB_STORE_NAME);
                     case 2:
                     case "end":
-                      return _context18.stop();
+                      return _context22.stop();
                   }
-                }, _callee18);
+                }, _callee22);
               })));
             case 6:
               this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, '');
               this.core.effects.emit(OrderHooks.onOrdersChanged, this.store.list);
             case 8:
             case "end":
-              return _context19.stop();
+              return _context23.stop();
           }
-        }, _callee19, this);
+        }, _callee23, this);
       }));
       function clear() {
         return _clear.apply(this, arguments);