@pisell/pisellos 2.3.59 → 2.3.60

package/dist/model/strategy/adapter/promotion/index.js

@@ -0,0 +1,9 @@
+// 导出评估器
+export { PromotionEvaluator } from "./evaluator";
+
+// 导出适配器
+export { PromotionAdapter } from "./adapter";
+export { default } from "./adapter";
+
+// 导出策略配置示例常量
+export { X_ITEMS_FOR_Y_PRICE_STRATEGY, BUY_X_GET_Y_FREE_STRATEGY, ITEM_REWARD_STRATEGY } from "./examples";

package/dist/server/index.d.ts

@@ -157,13 +157,17 @@ declare class Server {
      * 重新拉取全量 SSE 接口，更新本地数据后触发 onProductsSyncCompleted
      * 不影响当前界面展示，适用于切回前台、定时刷新等场景
      */
-    refreshProductsInBackground(): Promise<void>;
+    refreshProductsInBackground(options?: {
+        trigger?: string;
+    }): Promise<void>;
     /**
      * 后台静默刷新订单数据
      * 重新拉取全量 SSE 接口，更新本地数据后触发 onOrdersSyncCompleted
      * 不影响当前界面展示，适用于切回前台、定时刷新等场景
      */
-    refreshOrdersInBackground(): Promise<void>;
+    refreshOrdersInBackground(options?: {
+        trigger?: string;
+    }): Promise<void>;
     /**
      * 编辑正式订单时强制查询 Server 最新快照并覆盖本地缓存。
      * 商品成员增删由 OrderModule 在 SQLite/Store 更新完成后广播，

package/dist/server/index.js

@@ -2842,44 +2842,58 @@ var Server = /*#__PURE__*/function () {
     key: "refreshProductsInBackground",
     value: (function () {
       var _refreshProductsInBackground = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee34() {
-        var startTime, duration, _duration2, errorMessage;
+        var options,
+          trigger,
+          startTime,
+          duration,
+          _duration2,
+          errorMessage,
+          _args34 = arguments;
         return _regeneratorRuntime().wrap(function _callee34$(_context34) {
           while (1) switch (_context34.prev = _context34.next) {
             case 0:
+              options = _args34.length > 0 && _args34[0] !== undefined ? _args34[0] : {};
               if (this.products) {
-                _context34.next = 3;
+                _context34.next = 4;
                 break;
               }
               this.logWarning('refreshProductsInBackground: Products 模块未注册');
               return _context34.abrupt("return");
-            case 3:
-              this.logInfo('refreshProductsInBackground 开始');
+            case 4:
+              trigger = options.trigger || 'background';
+              this.logInfo('refreshProductsInBackground 开始', {
+                trigger: trigger
+              });
               startTime = Date.now();
-              _context34.prev = 5;
-              _context34.next = 8;
-              return this.products.silentRefresh();
-            case 8:
+              _context34.prev = 7;
+              _context34.next = 10;
+              return this.products.silentRefresh({
+                trigger: trigger
+              });
+            case 10:
               duration = Date.now() - startTime;
               this.logInfo('refreshProductsInBackground 完成', {
+                trigger: trigger,
                 duration: "".concat(duration, "ms")
               });
-              _context34.next = 18;
+              _context34.next = 20;
               break;
-            case 12:
-              _context34.prev = 12;
-              _context34.t0 = _context34["catch"](5);
+            case 14:
+              _context34.prev = 14;
+              _context34.t0 = _context34["catch"](7);
               _duration2 = Date.now() - startTime;
               errorMessage = _context34.t0 instanceof Error ? _context34.t0.message : String(_context34.t0);
               console.error('[Server] refreshProductsInBackground 失败:', _context34.t0);
               this.logError('refreshProductsInBackground 失败', {
+                trigger: trigger,
                 duration: "".concat(_duration2, "ms"),
                 error: errorMessage
               });
-            case 18:
+            case 20:
             case "end":
               return _context34.stop();
           }
-        }, _callee34, this, [[5, 12]]);
+        }, _callee34, this, [[7, 14]]);
       }));
       function refreshProductsInBackground() {
         return _refreshProductsInBackground.apply(this, arguments);
@@ -2896,44 +2910,58 @@ var Server = /*#__PURE__*/function () {
     key: "refreshOrdersInBackground",
     value: (function () {
       var _refreshOrdersInBackground = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee35() {
-        var startTime, duration, _duration3, errorMessage;
+        var options,
+          trigger,
+          startTime,
+          duration,
+          _duration3,
+          errorMessage,
+          _args35 = arguments;
         return _regeneratorRuntime().wrap(function _callee35$(_context35) {
           while (1) switch (_context35.prev = _context35.next) {
             case 0:
+              options = _args35.length > 0 && _args35[0] !== undefined ? _args35[0] : {};
               if (this.order) {
-                _context35.next = 3;
+                _context35.next = 4;
                 break;
               }
               this.logWarning('refreshOrdersInBackground: Order 模块未注册');
               return _context35.abrupt("return");
-            case 3:
-              this.logInfo('refreshOrdersInBackground 开始');
+            case 4:
+              trigger = options.trigger || 'background';
+              this.logInfo('refreshOrdersInBackground 开始', {
+                trigger: trigger
+              });
               startTime = Date.now();
-              _context35.prev = 5;
-              _context35.next = 8;
-              return this.order.silentRefresh();
-            case 8:
+              _context35.prev = 7;
+              _context35.next = 10;
+              return this.order.silentRefresh({
+                trigger: trigger
+              });
+            case 10:
               duration = Date.now() - startTime;
               this.logInfo('refreshOrdersInBackground 完成', {
+                trigger: trigger,
                 duration: "".concat(duration, "ms")
               });
-              _context35.next = 18;
+              _context35.next = 20;
               break;
-            case 12:
-              _context35.prev = 12;
-              _context35.t0 = _context35["catch"](5);
+            case 14:
+              _context35.prev = 14;
+              _context35.t0 = _context35["catch"](7);
               _duration3 = Date.now() - startTime;
               errorMessage = _context35.t0 instanceof Error ? _context35.t0.message : String(_context35.t0);
               console.error('[Server] refreshOrdersInBackground 失败:', _context35.t0);
               this.logError('refreshOrdersInBackground 失败', {
+                trigger: trigger,
                 duration: "".concat(_duration3, "ms"),
                 error: errorMessage
               });
-            case 18:
+            case 20:
             case "end":
               return _context35.stop();
           }
-        }, _callee35, this, [[5, 12]]);
+        }, _callee35, this, [[7, 14]]);
       }));
       function refreshOrdersInBackground() {
         return _refreshOrdersInBackground.apply(this, arguments);

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

@@ -327,7 +327,7 @@ export var MenuModule = /*#__PURE__*/function (_BaseModule) {
     key: "loadMenuFromIndexDB",
     value: (function () {
       var _loadMenuFromIndexDB = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
-        var _menuList$length, menuList, errorMessage;
+        var startedAt, _menuList$length, menuList, errorMessage;
         return _regeneratorRuntime().wrap(function _callee5$(_context5) {
           while (1) switch (_context5.prev = _context5.next) {
             case 0:
@@ -338,29 +338,32 @@ export var MenuModule = /*#__PURE__*/function (_BaseModule) {
               this.logWarning('loadMenuFromIndexDB: dbManager 不可用');
               return _context5.abrupt("return", []);
             case 3:
-              _context5.prev = 3;
-              _context5.next = 6;
+              startedAt = performance.now();
+              _context5.prev = 4;
+              _context5.next = 7;
               return this.dbManager.getAll(INDEXDB_STORE_NAME);
-            case 6:
+            case 7:
               menuList = _context5.sent;
               this.logInfo('从 IndexDB 加载餐牌数据', {
-                menuCount: (_menuList$length = menuList === null || menuList === void 0 ? void 0 : menuList.length) !== null && _menuList$length !== void 0 ? _menuList$length : 0
+                menuCount: (_menuList$length = menuList === null || menuList === void 0 ? void 0 : menuList.length) !== null && _menuList$length !== void 0 ? _menuList$length : 0,
+                durationMs: +(performance.now() - startedAt).toFixed(2)
               });
               return _context5.abrupt("return", menuList || []);
-            case 11:
-              _context5.prev = 11;
-              _context5.t0 = _context5["catch"](3);
+            case 12:
+              _context5.prev = 12;
+              _context5.t0 = _context5["catch"](4);
               errorMessage = _context5.t0 instanceof Error ? _context5.t0.message : String(_context5.t0);
               console.error('[Menu] 从 IndexDB 读取数据失败:', _context5.t0);
               this.logError('从 IndexDB 读取数据失败', {
+                durationMs: +(performance.now() - startedAt).toFixed(2),
                 error: errorMessage
               });
               return _context5.abrupt("return", []);
-            case 17:
+            case 18:
             case "end":
               return _context5.stop();
           }
-        }, _callee5, this, [[3, 11]]);
+        }, _callee5, this, [[4, 12]]);
       }));
       function loadMenuFromIndexDB() {
         return _loadMenuFromIndexDB.apply(this, arguments);
@@ -377,7 +380,7 @@ export var MenuModule = /*#__PURE__*/function (_BaseModule) {
     value: (function () {
       var _saveMenuToIndexDB = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee6(menuList) {
         var _this2 = this;
-        var savePromises, errorMessage;
+        var startedAt, clearDurationMs, writeDurationMs, clearStartedAt, writeStartedAt, savePromises, errorMessage;
         return _regeneratorRuntime().wrap(function _callee6$(_context6) {
           while (1) switch (_context6.prev = _context6.next) {
             case 0:
@@ -388,40 +391,62 @@ export var MenuModule = /*#__PURE__*/function (_BaseModule) {
               this.logWarning('saveMenuToIndexDB: dbManager 不可用');
               return _context6.abrupt("return");
             case 3:
+              startedAt = performance.now();
+              clearDurationMs = 0;
+              writeDurationMs = 0;
               this.logInfo('开始保存餐牌数据到 IndexDB', {
                 menuCount: menuList.length
               });
-              _context6.prev = 4;
-              _context6.next = 7;
+              _context6.prev = 7;
+              // 先清空现有的餐牌数据
+              clearStartedAt = performance.now();
+              _context6.prev = 9;
+              _context6.next = 12;
               return this.dbManager.clear(INDEXDB_STORE_NAME);
-            case 7:
+            case 12:
+              _context6.prev = 12;
+              clearDurationMs = +(performance.now() - clearStartedAt).toFixed(2);
+              return _context6.finish(12);
+            case 15:
               // 逐个保存餐牌（每个餐牌是独立的记录）
+              writeStartedAt = performance.now();
               savePromises = menuList.map(function (menu) {
                 return _this2.dbManager.add(INDEXDB_STORE_NAME, menu);
               });
-              _context6.next = 10;
+              _context6.prev = 17;
+              _context6.next = 20;
               return Promise.all(savePromises);
-            case 10:
+            case 20:
+              _context6.prev = 20;
+              writeDurationMs = +(performance.now() - writeStartedAt).toFixed(2);
+              return _context6.finish(20);
+            case 23:
               console.log("[Menu] \u5DF2\u5C06 ".concat(menuList.length, " \u6761\u9910\u724C\u6570\u636E\u4FDD\u5B58\u5230 IndexDB"));
               this.logInfo('餐牌数据已保存到 IndexDB', {
-                menuCount: menuList.length
+                menuCount: menuList.length,
+                clearDurationMs: clearDurationMs,
+                writeDurationMs: writeDurationMs,
+                totalDurationMs: +(performance.now() - startedAt).toFixed(2)
               });
-              _context6.next = 19;
+              _context6.next = 32;
               break;
-            case 14:
-              _context6.prev = 14;
-              _context6.t0 = _context6["catch"](4);
+            case 27:
+              _context6.prev = 27;
+              _context6.t0 = _context6["catch"](7);
               errorMessage = _context6.t0 instanceof Error ? _context6.t0.message : String(_context6.t0);
               console.error('[Menu] 保存数据到 IndexDB 失败:', _context6.t0);
               this.logError('保存数据到 IndexDB 失败', {
                 menuCount: menuList.length,
+                clearDurationMs: clearDurationMs,
+                writeDurationMs: writeDurationMs,
+                totalDurationMs: +(performance.now() - startedAt).toFixed(2),
                 error: errorMessage
               });
-            case 19:
+            case 32:
             case "end":
               return _context6.stop();
           }
-        }, _callee6, this, [[4, 14]]);
+        }, _callee6, this, [[7, 27], [9,, 12, 15], [17,, 20, 23]]);
       }));
       function saveMenuToIndexDB(_x4) {
         return _saveMenuToIndexDB.apply(this, arguments);

package/dist/server/modules/order/index.d.ts

@@ -119,13 +119,17 @@ export declare class OrderModule extends BaseModule implements Module {
         payment: Record<string, any>;
         previousPayment: Record<string, any>;
     } | null>;
-    loadOrdersByServer(): Promise<OrderData[]>;
+    loadOrdersByServer(options?: {
+        trigger?: string;
+    }): Promise<OrderData[]>;
     /**
      * 静默全量刷新：后台重新拉取全量 SSE 订单数据并更新本地
      * 拿到完整数据后一次性替换 store，触发订单变更与同步完成事件
      * @returns 刷新后的订单列表
      */
-    silentRefresh(): Promise<OrderData[]>;
+    silentRefresh(options?: {
+        trigger?: string;
+    }): Promise<OrderData[]>;
     private normalizeOrderForMemoryList;
     private normalizeOrdersForMemoryList;
     private hasRealOrderId;

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

@@ -701,62 +701,78 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "preload",
     value: function () {
       var _preload = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
-        var cachedOrders, memoryOrders, orders;
+        var preloadStartedAt, cachedOrders, memoryOrders, orders;
         return _regeneratorRuntime().wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
+              preloadStartedAt = Date.now();
               cachedOrders = null;
               if (!this.dbManager) {
-                _context4.next = 11;
+                _context4.next = 12;
                 break;
               }
-              _context4.prev = 2;
-              _context4.next = 5;
+              _context4.prev = 3;
+              _context4.next = 6;
               return this.loadOrdersFromSQLite({
                 throwOnError: true
               });
-            case 5:
+            case 6:
               cachedOrders = _context4.sent;
-              _context4.next = 11;
+              _context4.next = 12;
               break;
-            case 8:
-              _context4.prev = 8;
-              _context4.t0 = _context4["catch"](2);
+            case 9:
+              _context4.prev = 9;
+              _context4.t0 = _context4["catch"](3);
               this.logWarning('preload-SQLite读取失败，回退远端全量拉取', {
                 error: _context4.t0 instanceof Error ? _context4.t0.message : String(_context4.t0)
               });
-            case 11:
+            case 12:
               if (!(cachedOrders !== null && this.hasPulledOrdersToday())) {
-                _context4.next = 20;
+                _context4.next = 22;
                 break;
               }
               memoryOrders = this.normalizeOrdersForMemoryList(cachedOrders, 'preload.sqliteMemory');
               this.store.list = cloneDeep(memoryOrders);
               this.syncOrdersMap();
-              _context4.next = 17;
+              _context4.next = 18;
               return this.core.effects.emit(OrderHooks.onOrdersLoaded, this.store.list);
-            case 17:
-              _context4.next = 19;
+            case 18:
+              _context4.next = 20;
               return this.emitOrdersChanged([], 'preload.sqlite');
-            case 19:
-              return _context4.abrupt("return");
             case 20:
-              _context4.next = 22;
-              return this.loadOrdersByServer();
+              this.logInfo('预加载完成', {
+                trigger: 'preload',
+                source: 'SQLite',
+                orderCount: this.store.list.length,
+                duration: "".concat(Date.now() - preloadStartedAt, "ms")
+              });
+              return _context4.abrupt("return");
             case 22:
+              _context4.next = 24;
+              return this.loadOrdersByServer({
+                trigger: 'preload'
+              });
+            case 24:
               orders = _context4.sent;
               this.store.list = cloneDeep(orders);
               this.syncOrdersMap();
-              _context4.next = 27;
-              return this.emitOrdersChanged([], 'preload');
-            case 27:
               _context4.next = 29;
-              return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
+              return this.emitOrdersChanged([], 'preload');
             case 29:
+              _context4.next = 31;
+              return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
+            case 31:
+              this.logInfo('预加载完成', {
+                trigger: 'preload',
+                source: 'Server',
+                orderCount: this.store.list.length,
+                duration: "".concat(Date.now() - preloadStartedAt, "ms")
+              });
+            case 32:
             case "end":
               return _context4.stop();
           }
-        }, _callee4, this, [[2, 8]]);
+        }, _callee4, this, [[3, 9]]);
       }));
       function preload() {
         return _preload.apply(this, arguments);
@@ -1089,19 +1105,32 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       var _loadOrdersByServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8() {
         var _this5 = this,
           _this$store;
-        var orderList, hasFetchedRemoteSnapshot, protectedOrdersBeforeRemoteFetch, data, _yield$this$replaceOr, mergedOrders, isRemoteSnapshotPersisted, memoryOrders;
+        var options,
+          orderList,
+          hasFetchedRemoteSnapshot,
+          trigger,
+          protectedOrdersBeforeRemoteFetch,
+          data,
+          _yield$this$replaceOr,
+          mergedOrders,
+          isRemoteSnapshotPersisted,
+          memoryOrders,
+          _args8 = arguments;
         return _regeneratorRuntime().wrap(function _callee8$(_context8) {
           while (1) switch (_context8.prev = _context8.next) {
             case 0:
+              options = _args8.length > 0 && _args8[0] !== undefined ? _args8[0] : {};
               orderList = [];
               hasFetchedRemoteSnapshot = false;
-              _context8.next = 4;
+              trigger = options.trigger || 'unknown';
+              _context8.next = 6;
               return this.loadOrdersFromSQLite();
-            case 4:
+            case 6:
               protectedOrdersBeforeRemoteFetch = _context8.sent.filter(function (order) {
                 return _this5.shouldProtectLocalOrderFromRemoteSnapshot(order);
               });
               this.logInfo('loadOrdersByServer-开始', {
+                trigger: trigger,
                 hasOrderDataSource: !!this.orderDataSource,
                 query: ((_this$store = this.store) === null || _this$store === void 0 ? void 0 : _this$store.createdAtQuery) || null,
                 protectedLocalOrderCount: protectedOrdersBeforeRemoteFetch.length,
@@ -1110,38 +1139,39 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 }, 0)
               });
               if (!this.orderDataSource) {
-                _context8.next = 21;
+                _context8.next = 23;
                 break;
               }
-              _context8.prev = 7;
-              _context8.next = 10;
+              _context8.prev = 9;
+              _context8.next = 12;
               return this.orderDataSource.run({
                 sse: {
                   query: this.store.createdAtQuery
                 }
               });
-            case 10:
+            case 12:
               data = _context8.sent;
               orderList = data || [];
               this.logInfo('loadOrdersByServer-SSE拉取成功', {
+                trigger: trigger,
                 count: orderList.length
               });
               hasFetchedRemoteSnapshot = true;
               this.lastServerFullFetchAtMs = Date.now();
-              _context8.next = 21;
+              _context8.next = 23;
               break;
-            case 17:
-              _context8.prev = 17;
-              _context8.t0 = _context8["catch"](7);
+            case 19:
+              _context8.prev = 19;
+              _context8.t0 = _context8["catch"](9);
               this.logInfo('loadOrdersByServer-SSE拉取失败，保持当前内存订单');
               return _context8.abrupt("return", this.store.list);
-            case 21:
+            case 23:
               if (hasFetchedRemoteSnapshot) {
                 this.clearOrderSnapshotMarker();
               }
-              _context8.next = 24;
+              _context8.next = 26;
               return this.replaceOrdersSnapshotInSQLite(orderList, 'loadOrdersByServer', protectedOrdersBeforeRemoteFetch);
-            case 24:
+            case 26:
               _yield$this$replaceOr = _context8.sent;
               mergedOrders = _yield$this$replaceOr.orders;
               isRemoteSnapshotPersisted = _yield$this$replaceOr.persisted;
@@ -1150,19 +1180,20 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
               }
               memoryOrders = this.normalizeOrdersForMemoryList(mergedOrders, 'loadOrdersByServer.memory');
               this.logInfo('loadOrdersByServer-结束', {
+                trigger: trigger,
                 count: memoryOrders.length,
                 persistedCount: mergedOrders.length,
                 sqliteOnlyDraftCount: mergedOrders.length - memoryOrders.length
               });
-              _context8.next = 32;
+              _context8.next = 34;
               return this.core.effects.emit(OrderHooks.onOrdersLoaded, memoryOrders);
-            case 32:
+            case 34:
               return _context8.abrupt("return", memoryOrders);
-            case 33:
+            case 35:
             case "end":
               return _context8.stop();
           }
-        }, _callee8, this, [[7, 17]]);
+        }, _callee8, this, [[9, 19]]);
       }));
       function loadOrdersByServer() {
         return _loadOrdersByServer.apply(this, arguments);
@@ -1178,53 +1209,76 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "silentRefresh",
     value: (function () {
       var _silentRefresh = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9() {
-        var startTime, elapsedSinceFullFetch, orders, errorMessage;
+        var options,
+          startTime,
+          trigger,
+          elapsedSinceFullFetch,
+          orders,
+          errorMessage,
+          _args9 = arguments;
         return _regeneratorRuntime().wrap(function _callee9$(_context9) {
           while (1) switch (_context9.prev = _context9.next) {
             case 0:
+              options = _args9.length > 0 && _args9[0] !== undefined ? _args9[0] : {};
               startTime = Date.now();
+              trigger = options.trigger || 'background';
               elapsedSinceFullFetch = Date.now() - this.lastServerFullFetchAtMs;
               if (!(this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < ORDER_SILENT_REFRESH_MIN_INTERVAL_MS)) {
-                _context9.next = 4;
+                _context9.next = 7;
                 break;
               }
+              this.logInfo('silentRefresh 跳过全量 SSE', {
+                trigger: trigger,
+                reason: 'within_min_interval',
+                minIntervalMs: ORDER_SILENT_REFRESH_MIN_INTERVAL_MS,
+                elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+                orderCount: this.store.list.length
+              });
               return _context9.abrupt("return", this.store.list);
-            case 4:
-              this.logInfo('silentRefresh 开始');
-              _context9.prev = 5;
+            case 7:
+              this.logInfo('silentRefresh 开始', {
+                trigger: trigger,
+                elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+                orderCount: this.store.list.length
+              });
+              _context9.prev = 8;
               // 刷新前，需要更新当前营业日边界（store.createdAtQuery）
               this.updateCreateStore();
-              _context9.next = 9;
-              return this.loadOrdersByServer();
-            case 9:
+              _context9.next = 12;
+              return this.loadOrdersByServer({
+                trigger: trigger
+              });
+            case 12:
               orders = _context9.sent;
               this.store.list = cloneDeep(orders);
               this.syncOrdersMap();
-              _context9.next = 14;
+              _context9.next = 17;
               return this.emitOrdersChanged([], 'silentRefresh');
-            case 14:
-              _context9.next = 16;
+            case 17:
+              _context9.next = 19;
               return this.core.effects.emit(OrderHooks.onOrdersSyncCompleted, null);
-            case 16:
+            case 19:
               this.logInfo('silentRefresh 完成', {
+                trigger: trigger,
                 orderCount: orders.length,
                 duration: "".concat(Date.now() - startTime, "ms")
               });
               return _context9.abrupt("return", this.store.list);
-            case 20:
-              _context9.prev = 20;
-              _context9.t0 = _context9["catch"](5);
+            case 23:
+              _context9.prev = 23;
+              _context9.t0 = _context9["catch"](8);
               errorMessage = _context9.t0 instanceof Error ? _context9.t0.message : String(_context9.t0);
               this.logError('silentRefresh 失败', {
+                trigger: trigger,
                 duration: "".concat(Date.now() - startTime, "ms"),
                 error: errorMessage
               });
               return _context9.abrupt("return", this.store.list);
-            case 25:
+            case 28:
             case "end":
               return _context9.stop();
           }
-        }, _callee9, this, [[5, 20]]);
+        }, _callee9, this, [[8, 23]]);
       }));
       function silentRefresh() {
         return _silentRefresh.apply(this, arguments);

package/dist/server/modules/products/index.d.ts

@@ -183,7 +183,9 @@ export declare class ProductsModule extends BaseModule implements Module {
     /**
      * 通过 ProductDataSource SSE 加载完整商品列表
      */
-    loadProductsByServer(): Promise<any>;
+    loadProductsByServer(options?: {
+        trigger?: string;
+    }): Promise<any>;
     /**
      * 纯请求方法：通过 HTTP 接口获取商品列表（无副作用，不触发事件、不写 IndexDB）
      * @param params 查询参数
@@ -333,7 +335,9 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
      * @returns 刷新后的商品列表
      */
-    silentRefresh(): Promise<ProductData[]>;
+    silentRefresh(options?: {
+        trigger?: string;
+    }): Promise<ProductData[]>;
     /**
      * 销毁同步资源（取消 pubsub 订阅、清除定时器）
      */