@pisell/pisellos 2.3.61 → 2.3.62

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

@@ -40,6 +40,7 @@ var import_types = require("./types");
 var import_payment_utils = require("../../../modules/Order/payment-utils");
 var INDEXDB_STORE_NAME = "orders";
 var ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY = "server_order_last_full_fetch_at";
+var ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY = "server_order_last_full_fetch_shop_id";
 var ORDER_SYNC_THROTTLE_MS_STORAGE_KEY = "order_sync_throttle_ms";
 var DEFAULT_ORDER_SYNC_THROTTLE_MS = 2e3;
 var ORDER_SQLITE_DEDUPE_MS = 15e3;
@@ -524,11 +525,47 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return DEFAULT_ORDER_SYNC_THROTTLE_MS;
   }
   async preload() {
-    const orders = await this.loadOrdersByServer();
+    const preloadStartedAt = Date.now();
+    let cachedOrders = null;
+    if (this.dbManager) {
+      try {
+        cachedOrders = await this.loadOrdersFromSQLite({ throwOnError: true });
+      } catch (error) {
+        this.logWarning("preload-SQLite读取失败，回退远端全量拉取", {
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+    if (cachedOrders !== null && this.hasPulledOrdersToday()) {
+      const memoryOrders = this.normalizeOrdersForMemoryList(
+        cachedOrders,
+        "preload.sqliteMemory"
+      );
+      this.store.list = (0, import_lodash_es.cloneDeep)(memoryOrders);
+      this.syncOrdersMap();
+      await this.core.effects.emit(import_types.OrderHooks.onOrdersLoaded, this.store.list);
+      await this.emitOrdersChanged([], "preload.sqlite");
+      this.logInfo("预加载完成", {
+        trigger: "preload",
+        source: "SQLite",
+        orderCount: this.store.list.length,
+        duration: `${Date.now() - preloadStartedAt}ms`
+      });
+      return;
+    }
+    const orders = await this.loadOrdersByServer({
+      trigger: "preload"
+    });
     this.store.list = (0, import_lodash_es.cloneDeep)(orders);
     this.syncOrdersMap();
     await this.emitOrdersChanged([], "preload");
     await this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
+    this.logInfo("预加载完成", {
+      trigger: "preload",
+      source: "Server",
+      orderCount: this.store.list.length,
+      duration: `${Date.now() - preloadStartedAt}ms`
+    });
   }
   getOrders() {
     return this.store.list;
@@ -749,13 +786,16 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     this.logInfo("updateLocalPayment-变更事件完成", paymentContext);
     return { order: nextOrder, payment: nextPayment, previousPayment };
   }
-  async loadOrdersByServer() {
+  async loadOrdersByServer(options = {}) {
     var _a;
     let orderList = [];
+    let hasFetchedRemoteSnapshot = false;
+    const trigger = options.trigger || "unknown";
     const protectedOrdersBeforeRemoteFetch = (await this.loadOrdersFromSQLite()).filter(
       (order) => this.shouldProtectLocalOrderFromRemoteSnapshot(order)
     );
     this.logInfo("loadOrdersByServer-开始", {
+      trigger,
       hasOrderDataSource: !!this.orderDataSource,
       query: ((_a = this.store) == null ? void 0 : _a.createdAtQuery) || null,
       protectedLocalOrderCount: protectedOrdersBeforeRemoteFetch.length,
@@ -773,25 +813,36 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         });
         orderList = data || [];
         this.logInfo("loadOrdersByServer-SSE拉取成功", {
+          trigger,
           count: orderList.length
         });
-        this.markOrderPulledAtNow();
+        hasFetchedRemoteSnapshot = true;
         this.lastServerFullFetchAtMs = Date.now();
       } catch {
         this.logInfo("loadOrdersByServer-SSE拉取失败，保持当前内存订单");
         return this.store.list;
       }
     }
-    const mergedOrders = await this.replaceOrdersSnapshotInSQLite(
+    if (hasFetchedRemoteSnapshot) {
+      this.clearOrderSnapshotMarker();
+    }
+    const {
+      orders: mergedOrders,
+      persisted: isRemoteSnapshotPersisted
+    } = await this.replaceOrdersSnapshotInSQLite(
       orderList,
       "loadOrdersByServer",
       protectedOrdersBeforeRemoteFetch
     );
+    if (hasFetchedRemoteSnapshot && isRemoteSnapshotPersisted) {
+      this.markOrderPulledAtNow();
+    }
     const memoryOrders = this.normalizeOrdersForMemoryList(
       mergedOrders,
       "loadOrdersByServer.memory"
     );
     this.logInfo("loadOrdersByServer-结束", {
+      trigger,
       count: memoryOrders.length,
       persistedCount: mergedOrders.length,
       sqliteOnlyDraftCount: mergedOrders.length - memoryOrders.length
@@ -804,21 +855,34 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 拿到完整数据后一次性替换 store，触发订单变更与同步完成事件
    * @returns 刷新后的订单列表
    */
-  async silentRefresh() {
+  async silentRefresh(options = {}) {
     const startTime = Date.now();
+    const trigger = options.trigger || "background";
     const elapsedSinceFullFetch = Date.now() - this.lastServerFullFetchAtMs;
     if (this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < ORDER_SILENT_REFRESH_MIN_INTERVAL_MS) {
+      this.logInfo("silentRefresh 跳过全量 SSE", {
+        trigger,
+        reason: "within_min_interval",
+        minIntervalMs: ORDER_SILENT_REFRESH_MIN_INTERVAL_MS,
+        elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+        orderCount: this.store.list.length
+      });
       return this.store.list;
     }
-    this.logInfo("silentRefresh 开始");
+    this.logInfo("silentRefresh 开始", {
+      trigger,
+      elapsedSinceFullFetchMs: elapsedSinceFullFetch,
+      orderCount: this.store.list.length
+    });
     try {
       this.updateCreateStore();
-      const orders = await this.loadOrdersByServer();
+      const orders = await this.loadOrdersByServer({ trigger });
       this.store.list = (0, import_lodash_es.cloneDeep)(orders);
       this.syncOrdersMap();
       await this.emitOrdersChanged([], "silentRefresh");
       await this.core.effects.emit(import_types.OrderHooks.onOrdersSyncCompleted, null);
       this.logInfo("silentRefresh 完成", {
+        trigger,
         orderCount: orders.length,
         duration: `${Date.now() - startTime}ms`
       });
@@ -826,6 +890,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError("silentRefresh 失败", {
+        trigger,
         duration: `${Date.now() - startTime}ms`,
         error: errorMessage
       });
@@ -2119,20 +2184,29 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     return { list, removedCount };
   }
   /**
-   * 当前订单拉取窗口：
-   * - 优先使用 createdAtQuery.sales_time_between（已按营业日边界初始化）
-   * - 无法解析时退化为自然日窗口
+   * 当前订单缓存可复用窗口。
+   * start_time 模式使用精确的营业日起止时间；配置缺失或异常时退化为自然日。
    */
-  getCurrentPullWindow() {
-    var _a, _b;
+  getCurrentOrderCacheWindow() {
+    var _a;
     const now = (0, import_dayjs.default)();
-    const range = (_b = (_a = this.store) == null ? void 0 : _a.createdAtQuery) == null ? void 0 : _b.sales_time_between;
-    if (Array.isArray(range) && range.length >= 2) {
-      const startAt2 = (0, import_dayjs.default)(range[0]);
-      const endExclusiveAt = (0, import_dayjs.default)(range[1]);
-      if (startAt2.isValid() && endExclusiveAt.isValid() && endExclusiveAt.isAfter(startAt2)) {
-        return { startAt: startAt2, endExclusiveAt };
+    try {
+      const appPlugin = this.core.getPlugin("app");
+      const app = appPlugin == null ? void 0 : appPlugin.getApp();
+      const coreData = app == null ? void 0 : app.data.store.getStore().getDataByModel("core");
+      const boundary = (_a = coreData == null ? void 0 : coreData.core) == null ? void 0 : _a.operating_day_boundary;
+      if ((boundary == null ? void 0 : boundary.type) === "start_time") {
+        const boundaryTime = String(boundary.time || "").trim();
+        const todayBoundary = (0, import_dayjs.default)(`${now.format("YYYY-MM-DD")} ${boundaryTime}`);
+        if (todayBoundary.isValid()) {
+          const startAt2 = now.isBefore(todayBoundary) ? todayBoundary.subtract(1, "day") : todayBoundary;
+          return {
+            startAt: startAt2,
+            endExclusiveAt: startAt2.add(1, "day")
+          };
+        }
       }
+    } catch {
     }
     const startAt = now.startOf("day");
     return { startAt, endExclusiveAt: startAt.add(1, "day") };
@@ -2141,17 +2215,51 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     const lastFullFetchAt = this.getStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY);
     if (!lastFullFetchAt)
       return false;
+    const currentShopId = this.getCurrentShopId();
+    const lastFullFetchShopId = this.getStorageItem(
+      ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY
+    );
+    if (!currentShopId || !lastFullFetchShopId || currentShopId !== lastFullFetchShopId) {
+      return false;
+    }
     const parsed = (0, import_dayjs.default)(lastFullFetchAt);
     if (!parsed.isValid())
       return false;
-    const { startAt, endExclusiveAt } = this.getCurrentPullWindow();
+    const { startAt, endExclusiveAt } = this.getCurrentOrderCacheWindow();
     return (parsed.isAfter(startAt) || parsed.isSame(startAt)) && parsed.isBefore(endExclusiveAt);
   }
   markOrderPulledAtNow() {
+    const currentShopId = this.getCurrentShopId();
+    if (!currentShopId)
+      return;
     this.setStorageItem(
       ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY,
       (0, import_dayjs.default)().format("YYYY-MM-DD HH:mm:ss")
     );
+    this.setStorageItem(
+      ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY,
+      currentShopId
+    );
+  }
+  clearOrderSnapshotMarker() {
+    this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, "");
+    this.setStorageItem(ORDER_LAST_FULL_FETCH_SHOP_ID_STORAGE_KEY, "");
+  }
+  getCurrentShopId() {
+    var _a;
+    try {
+      const appPlugin = this.core.getPlugin("app");
+      const app = appPlugin == null ? void 0 : appPlugin.getApp();
+      if (!app)
+        return null;
+      const coreData = app.data.store.getStore().getDataByModel("core");
+      const shopId = (_a = coreData == null ? void 0 : coreData.core) == null ? void 0 : _a.id;
+      if (shopId === void 0 || shopId === null || shopId === "")
+        return null;
+      return String(shopId);
+    } catch {
+      return null;
+    }
   }
   getStorageItem(key) {
     var _a;
@@ -2178,7 +2286,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     } catch {
     }
   }
-  async loadOrdersFromSQLite() {
+  async loadOrdersFromSQLite(options = {}) {
     if (!this.dbManager)
       return [];
     try {
@@ -2186,7 +2294,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return (orders || []).map(
         (order) => this.normalizeOrderCollectionsForIngress(order, "loadOrdersFromSQLite")
       );
-    } catch {
+    } catch (error) {
+      if (options.throwOnError)
+        throw error;
       return [];
     }
   }
@@ -2408,14 +2518,17 @@ var OrderModule = class extends import_BaseModule.BaseModule {
    * 用于 SSE 全量拉取与营业日窗口裁剪。
    *
    * @example
-   * await this.replaceOrdersSnapshotInSQLite(orderList)
+   * const { orders, persisted } = await this.replaceOrdersSnapshotInSQLite(orderList, 'refresh')
    */
   async replaceOrdersSnapshotInSQLite(orderList, source, protectedOrdersBeforeRemoteFetch = []) {
     if (!this.dbManager) {
-      return this.compactOrderListByIdentity(
-        orderList.map((order) => this.normalizeRemoteSyncedOrder(order)),
-        `${source}.snapshotNoDb`
-      ).list;
+      return {
+        orders: this.compactOrderListByIdentity(
+          orderList.map((order) => this.normalizeRemoteSyncedOrder(order)),
+          `${source}.snapshotNoDb`
+        ).list,
+        persisted: false
+      };
     }
     const remoteSnapshot = (0, import_lodash_es.cloneDeep)(orderList).map(
       (order) => this.normalizeOrderCollectionsForIngress(order, `${source}.remoteIngress`)
@@ -2424,6 +2537,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       remoteSnapshot.map((order) => this.normalizeRemoteSyncedOrder(order)),
       `${source}.remoteSnapshot`
     ).list;
+    let persisted = false;
     try {
       await this.runInOrderSQLiteSaveQueue(async () => {
         const existingOrders = typeof this.dbManager.getAll === "function" ? await this.dbManager.getAll(INDEXDB_STORE_NAME) : [];
@@ -2488,13 +2602,14 @@ var OrderModule = class extends import_BaseModule.BaseModule {
           count: mergedSnapshot.length
         });
       });
+      persisted = true;
     } catch (error) {
       this.logError("全量保存订单到 SQLite 失败", {
         error: error instanceof Error ? error.message : String(error),
         orderList: remoteSnapshot.length
       });
     }
-    return mergedSnapshot;
+    return { orders: mergedSnapshot, persisted };
   }
   /**
    * 清空订单模块的内存数据和本地 SQLite 订单表。
@@ -2510,7 +2625,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         await this.dbManager.clear(INDEXDB_STORE_NAME);
       });
     }
-    this.setStorageItem(ORDER_LAST_FULL_FETCH_AT_STORAGE_KEY, "");
+    this.clearOrderSnapshotMarker();
     this.emitOrdersChanged([], "clear");
   }
 };

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

@@ -25,6 +25,7 @@ export declare class ProductsModule extends BaseModule implements Module {
     private quotationBridgeLoadedKey?;
     private quotationBridgeRefreshPromise?;
     private quotationBridgeRefreshKey?;
+    private quotationBridgeUpdatedCallback?;
     private quotationScheduleCache;
     private quotationScheduleCacheSource;
     private quotationScheduleCacheLoaded;
@@ -72,6 +73,7 @@ export declare class ProductsModule extends BaseModule implements Module {
         scheduleModule?: any;
         channel?: string;
         customer_id?: number | string;
+        onQuotationUpdated?: () => void;
     }): Promise<void>;
     /**
      * 刷新桥接器内的报价单列表。
@@ -181,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 查询参数
@@ -331,7 +335,9 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
      * @returns 刷新后的商品列表
      */
-    silentRefresh(): Promise<ProductData[]>;
+    silentRefresh(options?: {
+        trigger?: string;
+    }): Promise<ProductData[]>;
     /**
      * 销毁同步资源（取消 pubsub 订阅、清除定时器）
      */

package/lib/server/modules/products/index.js

@@ -192,7 +192,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * Server 层负责传入完整 schedule 模块，Products 只负责把报价单计算结果转成价格响应形状。
    */
   async setupQuotationPriceBridge(params) {
-    var _a;
+    var _a, _b, _c;
     if (!this.core) {
       this.logWarning("setupQuotationPriceBridge: core 尚未初始化");
       return;
@@ -211,13 +211,13 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         this.quotationScheduleCacheSource = params.scheduleModule;
       }
       this.quotationPriceBridge.setScheduleResolver((id) => {
-        var _a2, _b, _c, _d, _e, _f;
+        var _a2, _b2, _c2, _d, _e, _f;
         const scheduleId = String(id);
         if (this.quotationScheduleCache.has(scheduleId)) {
           return this.quotationScheduleCache.get(scheduleId);
         }
         if (!this.quotationScheduleCacheLoaded) {
-          const scheduleList = ((_b = (_a2 = params.scheduleModule).getScheduleList) == null ? void 0 : _b.call(_a2)) || [];
+          const scheduleList = ((_b2 = (_a2 = params.scheduleModule).getScheduleList) == null ? void 0 : _b2.call(_a2)) || [];
           for (const schedule of scheduleList) {
             this.quotationScheduleCache.set(String(schedule.id), schedule);
           }
@@ -226,12 +226,21 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         if (this.quotationScheduleCache.has(scheduleId)) {
           return this.quotationScheduleCache.get(scheduleId);
         }
-        const schedules = ((_d = (_c = params.scheduleModule).getScheduleListByIds) == null ? void 0 : _d.call(_c, [id])) || ((_f = (_e = params.scheduleModule).getScheduleByIds) == null ? void 0 : _f.call(_e, [id])) || [];
+        const schedules = ((_d = (_c2 = params.scheduleModule).getScheduleListByIds) == null ? void 0 : _d.call(_c2, [id])) || ((_f = (_e = params.scheduleModule).getScheduleByIds) == null ? void 0 : _f.call(_e, [id])) || [];
         if (schedules[0])
           this.quotationScheduleCache.set(scheduleId, schedules[0]);
         return schedules[0];
       });
     }
+    if (params.onQuotationUpdated) {
+      this.quotationBridgeUpdatedCallback = params.onQuotationUpdated;
+    }
+    (_c = (_b = this.quotationPriceBridge).setQuotationListUpdatedListener) == null ? void 0 : _c.call(_b, () => {
+      var _a2;
+      this.quotationBridgeLoadedKey = this.getQuotationBridgeScopeKey();
+      this.clearPriceCache();
+      (_a2 = this.quotationBridgeUpdatedCallback) == null ? void 0 : _a2.call(this);
+    });
     await this.refreshQuotationPriceBridge({ customer_id: params.customer_id });
   }
   /**
@@ -798,17 +807,20 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    */
   clearPriceCache() {
     this.productsPriceCache.clear();
+    this.quotationScheduleCache.clear();
+    this.quotationScheduleCacheLoaded = false;
     console.log("[ProductsModule] 🗑️ 商品价格缓存已清空");
   }
   /**
    * 通过 ProductDataSource SSE 加载完整商品列表
    */
-  async loadProductsByServer() {
+  async loadProductsByServer(options = {}) {
     if (!this.productDataSource) {
       this.logWarning("loadProductsByServer: ProductDataSource 不可用");
       return [];
     }
-    this.logInfo("开始通过 DataSource SSE 加载商品列表");
+    const trigger = options.trigger || "unknown";
+    this.logInfo("开始通过 DataSource SSE 加载商品列表", { trigger });
     const t0 = performance.now();
     try {
       const tSSE = performance.now();
@@ -816,6 +828,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       const list = productList || [];
       (0, import_product.perfMark)("loadProductsByServer.SSE", performance.now() - tSSE, { count: list.length });
       this.logInfo("通过 DataSource SSE 加载商品列表成功", {
+        trigger,
         productCount: list.length,
         duration: `${Math.round(performance.now() - t0)}ms`
       });
@@ -829,6 +842,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Products] 加载商品数据失败:", error);
       this.logError("通过 DataSource SSE 加载商品列表失败", {
+        trigger,
         duration: `${duration}ms`,
         error: errorMessage
       });
@@ -1019,7 +1033,9 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
   async refreshProducts() {
     const tTotal = performance.now();
     this.logInfo("refreshProducts 开始");
-    const products = await this.loadProductsByServer();
+    const products = await this.loadProductsByServer({
+      trigger: "product_sync"
+    });
     if (products && products.length > 0) {
       this.store.list = products;
       this.syncProductsMap();
@@ -1064,18 +1080,23 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("loadProductsFromIndexDB: dbManager 不可用");
       return [];
     }
+    const startedAt = performance.now();
     try {
-      const t0 = performance.now();
       const products = await this.dbManager.getAll(INDEXDB_STORE_NAME);
-      (0, import_product.perfMark)("loadProductsFromIndexDB", performance.now() - t0, { count: (products == null ? void 0 : products.length) ?? 0 });
+      const durationMs = +(performance.now() - startedAt).toFixed(2);
+      (0, import_product.perfMark)("loadProductsFromIndexDB", durationMs, { count: (products == null ? void 0 : products.length) ?? 0 });
       this.logInfo("从 IndexDB 加载商品数据", {
-        productCount: (products == null ? void 0 : products.length) ?? 0
+        productCount: (products == null ? void 0 : products.length) ?? 0,
+        durationMs
       });
       return products || [];
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Products] 从 IndexDB 读取数据失败:", error);
-      this.logError("从 IndexDB 读取数据失败", { error: errorMessage });
+      this.logError("从 IndexDB 读取数据失败", {
+        durationMs: +(performance.now() - startedAt).toFixed(2),
+        error: errorMessage
+      });
       return [];
     }
   }
@@ -1103,22 +1124,54 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("replaceProductsSnapshotInIndexDB: dbManager 不可用");
       return;
     }
+    const enqueuedAt = performance.now();
+    let queueWaitMs = 0;
+    let clearDurationMs = 0;
+    let writeDurationMs = 0;
     try {
       await this.runInProductIndexDBSaveQueue(async () => {
-        this.logInfo("replaceProductsSnapshotInIndexDB 开始", { source, productCount: products.length });
-        const t0 = performance.now();
-        await this.dbManager.clear(INDEXDB_STORE_NAME);
+        const operationStartedAt = performance.now();
+        queueWaitMs = +(operationStartedAt - enqueuedAt).toFixed(2);
+        this.logInfo("replaceProductsSnapshotInIndexDB 开始", {
+          source,
+          productCount: products.length,
+          queueWaitMs
+        });
+        const clearStartedAt = performance.now();
+        try {
+          await this.dbManager.clear(INDEXDB_STORE_NAME);
+        } finally {
+          clearDurationMs = +(performance.now() - clearStartedAt).toFixed(2);
+        }
         if (products.length > 0) {
-          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
+          const writeStartedAt = performance.now();
+          try {
+            await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
+          } finally {
+            writeDurationMs = +(performance.now() - writeStartedAt).toFixed(2);
+          }
         }
-        (0, import_product.perfMark)("replaceProductsSnapshotInIndexDB", performance.now() - t0, { count: products.length });
-        this.logInfo("replaceProductsSnapshotInIndexDB 完成", { source, productCount: products.length });
+        const executeDurationMs = +(performance.now() - operationStartedAt).toFixed(2);
+        (0, import_product.perfMark)("replaceProductsSnapshotInIndexDB", executeDurationMs, { count: products.length });
+        this.logInfo("replaceProductsSnapshotInIndexDB 完成", {
+          source,
+          productCount: products.length,
+          queueWaitMs,
+          clearDurationMs,
+          writeDurationMs,
+          executeDurationMs,
+          totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2)
+        });
       });
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError("全量保存商品到 IndexDB 失败", {
         source,
         productCount: products.length,
+        queueWaitMs,
+        clearDurationMs,
+        writeDurationMs,
+        totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2),
         error: errorMessage
       });
     }
@@ -1200,6 +1253,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
           source: "IndexDB"
         });
         this.logInfo("预加载完成（从 IndexDB）", {
+          trigger: "preload",
           productCount: cachedData.length,
           duration: `${Math.round(performance.now() - tTotal)}ms`,
           source: "IndexDB"
@@ -1215,7 +1269,9 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("从 IndexDB 加载数据失败，准备从服务器加载", { error: errorMessage });
     }
     const tServer = performance.now();
-    const products = await this.loadProductsByServer();
+    const products = await this.loadProductsByServer({
+      trigger: "preload"
+    });
     (0, import_product.perfMark)("preload.loadFromServer", performance.now() - tServer, { count: (products == null ? void 0 : products.length) ?? 0 });
     if (products && products.length > 0) {
       this.store.list = products;
@@ -1228,6 +1284,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         source: "Server"
       });
       this.logInfo("预加载完成（从服务器）", {
+        trigger: "preload",
         productCount: products.length,
         duration: `${Math.round(performance.now() - tTotal)}ms`,
         source: "Server"
@@ -1592,17 +1649,31 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
    * @returns 刷新后的商品列表
    */
-  async silentRefresh() {
+  async silentRefresh(options = {}) {
     const t0 = performance.now();
     const now = Date.now();
-    const elapsedSincePreload = now - this.lastPreloadCompletedAtMs;
-    const elapsedSinceFullFetch = now - this.lastServerFullFetchAtMs;
-    if (this.lastPreloadCompletedAtMs > 0 && elapsedSincePreload < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS || this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS) {
+    const trigger = options.trigger || "background";
+    const elapsedSincePreloadMs = now - this.lastPreloadCompletedAtMs;
+    const elapsedSinceFullFetchMs = now - this.lastServerFullFetchAtMs;
+    if (this.lastPreloadCompletedAtMs > 0 && elapsedSincePreloadMs < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS || this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetchMs < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS) {
+      this.logInfo("silentRefresh 跳过全量 SSE", {
+        trigger,
+        reason: "within_min_interval",
+        minIntervalMs: PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS,
+        elapsedSincePreloadMs,
+        elapsedSinceFullFetchMs,
+        productCount: this.store.list.length
+      });
       return this.store.list;
     }
-    this.logInfo("silentRefresh 开始");
+    this.logInfo("silentRefresh 开始", {
+      trigger,
+      elapsedSincePreloadMs,
+      elapsedSinceFullFetchMs,
+      productCount: this.store.list.length
+    });
     try {
-      const products = await this.loadProductsByServer();
+      const products = await this.loadProductsByServer({ trigger });
       if (products && products.length > 0) {
         this.store.list = products;
         this.syncProductsMap();
@@ -1610,6 +1681,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
         await this.core.effects.emit(import_types.ProductsHooks.onProductsSyncCompleted, null);
         this.logInfo("silentRefresh 完成", {
+          trigger,
           productCount: products.length,
           duration: `${Math.round(performance.now() - t0)}ms`
         });
@@ -1621,6 +1693,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError("silentRefresh 失败", {
+        trigger,
         duration: `${Math.round(performance.now() - t0)}ms`,
         error: errorMessage
       });

package/lib/server/modules/resource/index.js

@@ -88,13 +88,18 @@ var ResourceModule = class extends import_BaseModule.BaseModule {
     }
   }
   async preload() {
-    await this.setupResourceSync();
     const cachedResources = await this.loadResourcesFromSQLite();
     if (cachedResources.length > 0) {
       this.store.list = (0, import_lodash_es.cloneDeep)(cachedResources).map((item) => this.normalizeResource(item));
       this.syncResourcesMap();
       await this.safeEmit(import_types.ResourceHooks.onResourcesChanged, this.store.list);
-    } else {
+      void this.setupResourceSync().catch((error) => {
+        this.logError("后台初始化资源同步失败", error);
+      });
+      return;
+    }
+    await this.setupResourceSync();
+    if (this.store.list.length === 0) {
       const resources = await this.loadResourcesByServer();
       if (resources.length > 0) {
         this.store.list = (0, import_lodash_es.cloneDeep)(resources).map((item) => this.normalizeResource(item));

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@pisell/pisellos",
-  "version": "2.3.61",
+  "version": "2.3.62",
   "description": "一个可扩展的前端模块化SDK框架，支持插件系统",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",