@pisell/pisellos 2.2.89 → 2.2.91

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

@@ -109,6 +109,7 @@ export interface ProductFormatterContext {
     schedule_date: string;
     priceData?: LoadProductsPriceData[];
     scheduleModule?: any;
+    locale?: string;
 }
 /**
  * 商品格式化器类型

package/dist/server/utils/product.d.ts

@@ -10,6 +10,10 @@ export declare function perfMark(label: string, durationMs: number, meta?: Recor
  */
 export declare function applyPriceDataToProducts(products: ProductData[], priceData: LoadProductsPriceData[]): ProductData[];
 export declare const getIsSessionProduct: (product: ProductData) => boolean;
+/**
+ * 根据 locale 将商品的 i18n 字段覆盖到对应原始字段
+ */
+export declare function applyI18nToProducts(products: ProductData[], locale?: string): ProductData[];
 /**
  * 将详情值数据应用到商品列表
  * @param products 商品列表

package/dist/server/utils/product.js

@@ -1,7 +1,11 @@
 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 _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 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 _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -186,6 +190,36 @@ var getIsOpenDetailModal = function getIsOpenDetailModal(product, context) {
     scheduleTimeSlots: scheduleTimeSlots
   };
 };
+var I18N_FIELD_MAP = {
+  title_i18n: 'title',
+  subtitle_i18n: 'subtitle',
+  description_i18n: 'description',
+  cover_i18n: 'cover'
+};
+
+/**
+ * 根据 locale 将商品的 i18n 字段覆盖到对应原始字段
+ */
+export function applyI18nToProducts(products, locale) {
+  if (!locale) return products;
+  return products.map(function (product) {
+    var _patched;
+    var patched = null;
+    for (var _i = 0, _Object$entries = Object.entries(I18N_FIELD_MAP); _i < _Object$entries.length; _i++) {
+      var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+        i18nKey = _Object$entries$_i[0],
+        originalKey = _Object$entries$_i[1];
+      var i18nDict = product[i18nKey];
+      if (!i18nDict) continue;
+      var localizedValue = i18nDict[locale];
+      if (localizedValue) {
+        if (!patched) patched = _objectSpread({}, product);
+        patched[originalKey] = localizedValue;
+      }
+    }
+    return (_patched = patched) !== null && _patched !== void 0 ? _patched : product;
+  });
+}
 var formatDataKey = function formatDataKey(data) {
   var _data$option, _data$bundle;
   var _data = _objectSpread({}, data);

package/dist/types/index.d.ts

@@ -52,6 +52,7 @@ export interface PisellCore {
     validateContext: (config: ModuleContextConfig) => boolean;
     serverOptions?: ServerOptions;
     server?: any;
+    setContext: (ctx: Partial<BusinessContext>) => void;
 }
 /**
  * 业务上下文接口
@@ -59,6 +60,7 @@ export interface PisellCore {
 export interface BusinessContext {
     userId?: string;
     companyId?: string;
+    locale?: string;
     [key: string]: any;
 }
 /**

package/lib/core/index.d.ts

@@ -29,6 +29,7 @@ declare class PisellOSCore implements PisellCore {
     getModuleExports<T = any>(name: string): T | null;
     hasModule(name: string): boolean;
     destroy(): Promise<void>;
+    setContext(ctx: Partial<BusinessContext>): void;
     /**
      * 验证上下文参数
      */

package/lib/core/index.js

@@ -235,6 +235,10 @@ var PisellOSCore = class {
     this.plugins.clear();
     this.log("PisellOS 核心已销毁");
   }
+  setContext(ctx) {
+    this.context = { ...this.context, ...ctx };
+    this.log(`上下文已更新: ${JSON.stringify(Object.keys(ctx))}`);
+  }
   /**
    * 验证上下文参数
    */

package/lib/server/index.d.ts

@@ -154,11 +154,16 @@ declare class Server {
     /**
      * 商品查询的核心计算逻辑（编排 Products、Menu、Schedule 模块）
      * 供 handleProductQuery 首次返回及 pubsub 变更推送复用
+     * @param context 查询上下文
+     * @param options 可选参数
+     * @param options.changedIds 变更的商品 IDs，用于增量更新价格缓存
      */
     private computeProductQueryResult;
     /**
      * 数据变更后，遍历所有订阅者重新计算查询结果并通过 callback 推送
      * 由 ProductsModule 的 onProductsSyncCompleted 事件触发
+     * @param options 可选参数
+     * @param options.changedIds 变更的商品 IDs，用于增量更新价格缓存
      */
     private recomputeAndNotifyProductQuery;
     /**

package/lib/server/index.js

@@ -415,8 +415,10 @@ var Server = class {
     } else {
       this.logInfo("跳过自动预加载", { autoPreload });
     }
-    this.core.effects.on(import_types.ProductsHooks.onProductsSyncCompleted, () => {
-      this.recomputeAndNotifyProductQuery();
+    this.core.effects.on(import_types.ProductsHooks.onProductsSyncCompleted, (payload) => {
+      this.recomputeAndNotifyProductQuery({
+        changedIds: payload == null ? void 0 : payload.changedIds
+      });
     });
     const duration = Date.now() - startTime;
     this.logInfo("Server 初始化完成", {
@@ -654,14 +656,18 @@ var Server = class {
   /**
    * 商品查询的核心计算逻辑（编排 Products、Menu、Schedule 模块）
    * 供 handleProductQuery 首次返回及 pubsub 变更推送复用
+   * @param context 查询上下文
+   * @param options 可选参数
+   * @param options.changedIds 变更的商品 IDs，用于增量更新价格缓存
    */
-  async computeProductQueryResult(context) {
+  async computeProductQueryResult(context, options) {
     const tTotal = performance.now();
     const { menu_list_ids, schedule_date, schedule_datetime } = context;
     this.logInfo("computeProductQueryResult 开始", {
       menuListIdsCount: (menu_list_ids == null ? void 0 : menu_list_ids.length) ?? 0,
       schedule_datetime,
-      schedule_date
+      schedule_date,
+      changedIds: options == null ? void 0 : options.changedIds
     });
     if (!this.products) {
       this.logError("computeProductQueryResult: Products 模块未注册");
@@ -691,6 +697,8 @@ var Server = class {
     const tPrice = performance.now();
     const allProductsWithPrice = await this.products.getProductsWithPrice(schedule_date, {
       scheduleModule: this.getSchedule()
+    }, {
+      changedIds: options == null ? void 0 : options.changedIds
     });
     (0, import_product.perfMark)("computeQuery.getProductsWithPrice", performance.now() - tPrice, {
       count: allProductsWithPrice.length
@@ -736,16 +744,21 @@ var Server = class {
   /**
    * 数据变更后，遍历所有订阅者重新计算查询结果并通过 callback 推送
    * 由 ProductsModule 的 onProductsSyncCompleted 事件触发
+   * @param options 可选参数
+   * @param options.changedIds 变更的商品 IDs，用于增量更新价格缓存
    */
-  async recomputeAndNotifyProductQuery() {
+  async recomputeAndNotifyProductQuery(options) {
     if (this.productQuerySubscribers.size === 0)
       return;
     this.logInfo("recomputeAndNotifyProductQuery: 开始推送", {
-      subscriberCount: this.productQuerySubscribers.size
+      subscriberCount: this.productQuerySubscribers.size,
+      changedIds: options == null ? void 0 : options.changedIds
     });
     for (const [subscriberId, subscriber] of this.productQuerySubscribers.entries()) {
       try {
-        const result = await this.computeProductQueryResult(subscriber.context);
+        const result = await this.computeProductQueryResult(subscriber.context, {
+          changedIds: options == null ? void 0 : options.changedIds
+        });
         subscriber.callback(result);
         this.logInfo("recomputeAndNotifyProductQuery: 已推送", { subscriberId });
       } catch (error) {

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

@@ -53,14 +53,20 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 缓存的是已经应用了价格的完整商品列表，避免重复转换
      * @param schedule_date 日期
      * @param extraContext 额外的上下文数据（可选，由 Server 层传入）
+     * @param options 可选参数
+     * @param options.changedIds 变更的商品 IDs，非空时仅对这些商品增量执行 prepare 并更新缓存
      * @returns 应用了价格的商品列表
      */
-    getProductsWithPrice(schedule_date: string, extraContext?: Partial<ProductFormatterContext>): Promise<ProductData[]>;
+    getProductsWithPrice(schedule_date: string, extraContext?: Partial<ProductFormatterContext>, options?: {
+        changedIds?: number[];
+    }): Promise<ProductData[]>;
     /**
      * 准备带价格的商品数据（通过格式化器流程处理）
      * @param schedule_date 日期
      * @param extraContext 额外的上下文数据（可选）
-     * @returns 完整处理后的商品列表
+     * @param options 可选参数
+     * @param options.productIds 指定商品 IDs，仅处理这些商品；不传则处理全量
+     * @returns 处理后的商品列表
      * @private
      */
     private prepareProductsWithPrice;
@@ -156,11 +162,6 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 用于 pubsub 同步 create / update / batch_update 场景
      */
     refreshProducts(): Promise<ProductData[]>;
-    /**
-     * 指定商品的报价单价格变更时，清除价格缓存
-     * 后续查询会走完整的 formatter 管道重建缓存
-     */
-    updateProductPriceByIds(ids: number[]): Promise<void>;
     /**
      * 清空缓存
      */
@@ -202,14 +203,18 @@ export declare class ProductsModule extends BaseModule implements Module {
      *
      * product 模块：
      *   - operation === 'delete' → 本地删除
-     *   - change_types 包含 price → SSE 增量拉取
+     *   - change_types 包含 price → 仅收集变更 IDs（不拉商品数据）
      *   - 有 body → body 完整数据直接覆盖本地
+     *   - 其他 → SSE 增量拉取
      *
-     * product_collection / product_category / product_quotation：
+     * product_collection / product_category：
      *   - 按 relation_product_ids SSE 拉取受影响商品
      *
-     * 处理完成后清除价格缓存并 emit onProductsSyncCompleted，
-     * Server 层监听该事件后重新查询，走完整的 formatter 管道重建缓存
+     * product_quotation：
+     *   - 报价单变更影响范围大，直接清除价格缓存走全量重建
+     *
+     * 处理完成后 emit onProductsSyncCompleted（携带 changedIds），
+     * Server 层监听该事件后对变更商品增量执行 prepareProductsWithPrice 并更新缓存
      */
     private processProductSyncMessages;
     /**

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

@@ -177,7 +177,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         duration: `${duration}ms`,
         error: errorMessage
       });
-      throw error;
+      return [];
     }
   }
   /**
@@ -186,13 +186,70 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * 缓存的是已经应用了价格的完整商品列表，避免重复转换
    * @param schedule_date 日期
    * @param extraContext 额外的上下文数据（可选，由 Server 层传入）
+   * @param options 可选参数
+   * @param options.changedIds 变更的商品 IDs，非空时仅对这些商品增量执行 prepare 并更新缓存
    * @returns 应用了价格的商品列表
    */
-  async getProductsWithPrice(schedule_date, extraContext) {
+  async getProductsWithPrice(schedule_date, extraContext, options) {
     const t0 = performance.now();
     const cacheKey = schedule_date;
+    const changedIds = options == null ? void 0 : options.changedIds;
     if (this.productsPriceCache.has(cacheKey)) {
       const cachedProducts = this.productsPriceCache.get(cacheKey);
+      if (changedIds && changedIds.length > 0) {
+        this.logInfo("商品价格缓存命中，增量更新变更商品", {
+          cacheKey,
+          changedIds,
+          cachedProductCount: cachedProducts.length
+        });
+        try {
+          const updatedProducts = await this.prepareProductsWithPrice(
+            schedule_date,
+            extraContext,
+            { productIds: changedIds }
+          );
+          if (updatedProducts.length > 0) {
+            const updatedMap = new Map(updatedProducts.map((p) => [p.id, p]));
+            const mergedCache = [];
+            for (const p of cachedProducts) {
+              if (updatedMap.has(p.id)) {
+                mergedCache.push(updatedMap.get(p.id));
+                updatedMap.delete(p.id);
+              } else {
+                mergedCache.push(p);
+              }
+            }
+            for (const p of updatedMap.values()) {
+              mergedCache.push(p);
+            }
+            this.productsPriceCache.set(cacheKey, mergedCache);
+            this.logInfo("增量更新完成", {
+              cacheKey,
+              changedCount: updatedProducts.length,
+              totalCount: mergedCache.length
+            });
+            (0, import_product.perfMark)("getProductsWithPrice(incrementalUpdate)", performance.now() - t0, {
+              cacheKey,
+              changedCount: changedIds.length,
+              count: mergedCache.length
+            });
+            return mergedCache;
+          }
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          this.logError("增量更新失败，返回现有缓存", {
+            cacheKey,
+            changedIds,
+            error: errorMessage
+          });
+        }
+        (0, import_product.perfMark)("getProductsWithPrice(incrementalUpdate)", performance.now() - t0, {
+          cacheKey,
+          changedCount: changedIds.length,
+          count: cachedProducts.length
+        });
+        return cachedProducts;
+      }
       (0, import_product.perfMark)("getProductsWithPrice(cacheHit)", performance.now() - t0, {
         cacheKey,
         count: cachedProducts.length
@@ -221,21 +278,38 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * 准备带价格的商品数据（通过格式化器流程处理）
    * @param schedule_date 日期
    * @param extraContext 额外的上下文数据（可选）
-   * @returns 完整处理后的商品列表
+   * @param options 可选参数
+   * @param options.productIds 指定商品 IDs，仅处理这些商品；不传则处理全量
+   * @returns 处理后的商品列表
    * @private
    */
-  async prepareProductsWithPrice(schedule_date, extraContext) {
+  async prepareProductsWithPrice(schedule_date, extraContext, options) {
+    var _a, _b;
     const tTotal = performance.now();
-    this.logInfo("prepareProductsWithPrice 开始处理", { schedule_date });
+    const targetIds = options == null ? void 0 : options.productIds;
+    const isIncremental = targetIds && targetIds.length > 0;
+    this.logInfo("prepareProductsWithPrice 开始处理", {
+      schedule_date,
+      mode: isIncremental ? "incremental" : "full",
+      targetIdsCount: targetIds == null ? void 0 : targetIds.length
+    });
     try {
-      const allProducts = this.getProductsRef();
-      this.logInfo("获取到商品列表", { productCount: allProducts.length });
-      const tIds = performance.now();
-      const ids = new Array(allProducts.length);
-      for (let i = 0; i < allProducts.length; i++) {
-        ids[i] = allProducts[i].id;
+      let products;
+      let ids;
+      if (isIncremental) {
+        const idSet = new Set(targetIds);
+        products = this.getProductsRef().filter((p) => idSet.has(p.id));
+        ids = products.map((p) => p.id);
+      } else {
+        products = this.getProductsRef();
+        const tIds = performance.now();
+        ids = new Array(products.length);
+        for (let i = 0; i < products.length; i++) {
+          ids[i] = products[i].id;
+        }
+        (0, import_product.perfMark)("prepareProducts.extractIds", performance.now() - tIds, { count: ids.length });
       }
-      (0, import_product.perfMark)("prepareProducts.extractIds", performance.now() - tIds, { count: ids.length });
+      this.logInfo("获取到商品列表", { productCount: products.length });
       const tPrice = performance.now();
       const priceData = await this.loadProductsPrice({
         ids,
@@ -246,26 +320,31 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       const context = {
         schedule_date,
         priceData,
+        locale: (_b = (_a = this.core) == null ? void 0 : _a.context) == null ? void 0 : _b.locale,
         ...extraContext
       };
       const tFormat = performance.now();
-      const processedProducts = await this.applyFormatters(allProducts, context);
+      const processedProducts = await this.applyFormatters(products, context);
       (0, import_product.perfMark)("prepareProducts.applyFormatters", performance.now() - tFormat, {
-        count: allProducts.length,
+        count: products.length,
         formatterCount: this.formatters.length
       });
       this.logInfo("prepareProductsWithPrice 处理完成", {
-        originalProductCount: allProducts.length,
+        mode: isIncremental ? "incremental" : "full",
+        originalProductCount: products.length,
         processedProductCount: processedProducts.length,
         formatterCount: this.formatters.length
       });
-      await this.core.effects.emit(
-        import_types.ProductsHooks.onProductsPriceApplied,
-        processedProducts
-      );
+      if (!isIncremental) {
+        await this.core.effects.emit(
+          import_types.ProductsHooks.onProductsPriceApplied,
+          processedProducts
+        );
+      }
       (0, import_product.perfMark)("prepareProductsWithPrice", performance.now() - tTotal, {
-        productCount: allProducts.length,
-        formatterCount: this.formatters.length
+        productCount: products.length,
+        formatterCount: this.formatters.length,
+        mode: isIncremental ? "incremental" : "full"
       });
       return processedProducts;
     } catch (err) {
@@ -340,10 +419,14 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       console.log(`[ProductsModule] 💰 应用价格数据到 ${products.length} 个商品`);
       return (0, import_product.applyPriceDataToProducts)(products, context.priceData);
     };
+    const i18nFormatter = (products, context) => {
+      return (0, import_product.applyI18nToProducts)(products, context.locale);
+    };
     const detailValueFormatter = (products, context) => {
       return (0, import_product.applyDetailValueToProducts)(products, context);
     };
     this.formatters.unshift(priceFormatter);
+    this.formatters.push(i18nFormatter);
     this.formatters.push(detailValueFormatter);
     this.isPriceFormatterRegistered = true;
     console.log("[ProductsModule] ✅ 内置价格格式化器已注册（第 1 个）");
@@ -604,14 +687,6 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     (0, import_product.perfMark)("refreshProducts", performance.now() - tTotal, { count: this.store.list.length });
     return this.store.list;
   }
-  /**
-   * 指定商品的报价单价格变更时，清除价格缓存
-   * 后续查询会走完整的 formatter 管道重建缓存
-   */
-  async updateProductPriceByIds(ids) {
-    this.logInfo("updateProductPriceByIds: 清除价格缓存", { ids });
-    this.clearPriceCache();
-  }
   /**
    * 清空缓存
    */
@@ -838,17 +913,21 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    *
    * product 模块：
    *   - operation === 'delete' → 本地删除
-   *   - change_types 包含 price → SSE 增量拉取
+   *   - change_types 包含 price → 仅收集变更 IDs（不拉商品数据）
    *   - 有 body → body 完整数据直接覆盖本地
+   *   - 其他 → SSE 增量拉取
    *
-   * product_collection / product_category / product_quotation：
+   * product_collection / product_category：
    *   - 按 relation_product_ids SSE 拉取受影响商品
    *
-   * 处理完成后清除价格缓存并 emit onProductsSyncCompleted，
-   * Server 层监听该事件后重新查询，走完整的 formatter 管道重建缓存
+   * product_quotation：
+   *   - 报价单变更影响范围大，直接清除价格缓存走全量重建
+   *
+   * 处理完成后 emit onProductsSyncCompleted（携带 changedIds），
+   * Server 层监听该事件后对变更商品增量执行 prepareProductsWithPrice 并更新缓存
    */
   async processProductSyncMessages() {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     const messages = [...this.pendingSyncMessages];
     this.pendingSyncMessages = [];
     if (messages.length === 0)
@@ -857,6 +936,8 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     const deleteIds = [];
     const bodyUpdates = /* @__PURE__ */ new Map();
     const sseRefreshIds = [];
+    const priceRefreshIds = [];
+    let shouldClearPriceCache = false;
     for (const msg of messages) {
       const channelKey = msg._channelKey || msg.module || "product";
       if (channelKey === "product") {
@@ -872,7 +953,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         }
         if ((_c = msg.change_types) == null ? void 0 : _c.includes("price")) {
           const ids = msg.ids || (msg.id ? [msg.id] : []);
-          sseRefreshIds.push(...ids);
+          priceRefreshIds.push(...ids);
           continue;
         }
         if (msg.body) {
@@ -886,14 +967,20 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         } else if (msg.id) {
           sseRefreshIds.push(msg.id);
         }
-      } else if (["product_collection", "product_category", "product_quotation"].includes(channelKey)) {
+      } else if (channelKey === "product_quotation") {
+        shouldClearPriceCache = true;
         if ((_e = msg.relation_product_ids) == null ? void 0 : _e.length) {
           sseRefreshIds.push(...msg.relation_product_ids);
         }
+      } else if (["product_collection", "product_category"].includes(channelKey)) {
+        if ((_f = msg.relation_product_ids) == null ? void 0 : _f.length) {
+          sseRefreshIds.push(...msg.relation_product_ids);
+        }
       }
     }
     const uniqueDeleteIds = [...new Set(deleteIds)];
     const uniqueSSEIds = [...new Set(sseRefreshIds)];
+    const uniquePriceIds = [...new Set(priceRefreshIds)];
     if (uniqueDeleteIds.length > 0) {
       await this.removeProductsByIds(uniqueDeleteIds);
     }
@@ -910,17 +997,30 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         receivedCount: freshProducts.length
       });
     }
+    const allChangedIds = [.../* @__PURE__ */ new Set([
+      ...Array.from(bodyUpdates.keys()),
+      ...uniqueSSEIds,
+      ...uniquePriceIds
+    ])];
     this.logInfo("processProductSyncMessages: 处理完成", {
       deleteCount: uniqueDeleteIds.length,
       bodyUpdateCount: bodyUpdates.size,
-      sseRefreshCount: uniqueSSEIds.length
+      sseRefreshCount: uniqueSSEIds.length,
+      priceRefreshCount: uniquePriceIds.length,
+      allChangedIdsCount: allChangedIds.length,
+      shouldClearPriceCache
     });
-    if (uniqueDeleteIds.length === 0 && bodyUpdates.size === 0 && uniqueSSEIds.length === 0) {
+    const hasChanges = uniqueDeleteIds.length > 0 || allChangedIds.length > 0 || shouldClearPriceCache;
+    if (!hasChanges) {
       this.logInfo("processProductSyncMessages: 没有变更，不触发 onProductsSyncCompleted");
       return;
     }
-    this.clearPriceCache();
-    await this.core.effects.emit(import_types.ProductsHooks.onProductsSyncCompleted, null);
+    if (shouldClearPriceCache) {
+      this.clearPriceCache();
+    }
+    await this.core.effects.emit(import_types.ProductsHooks.onProductsSyncCompleted, {
+      changedIds: allChangedIds
+    });
   }
   /**
    * 通过 SSE 按 ids 增量拉取商品数据

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

@@ -109,6 +109,7 @@ export interface ProductFormatterContext {
     schedule_date: string;
     priceData?: LoadProductsPriceData[];
     scheduleModule?: any;
+    locale?: string;
 }
 /**
  * 商品格式化器类型

package/lib/server/utils/product.d.ts

@@ -10,6 +10,10 @@ export declare function perfMark(label: string, durationMs: number, meta?: Recor
  */
 export declare function applyPriceDataToProducts(products: ProductData[], priceData: LoadProductsPriceData[]): ProductData[];
 export declare const getIsSessionProduct: (product: ProductData) => boolean;
+/**
+ * 根据 locale 将商品的 i18n 字段覆盖到对应原始字段
+ */
+export declare function applyI18nToProducts(products: ProductData[], locale?: string): ProductData[];
 /**
  * 将详情值数据应用到商品列表
  * @param products 商品列表

package/lib/server/utils/product.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var product_exports = {};
 __export(product_exports, {
   applyDetailValueToProducts: () => applyDetailValueToProducts,
+  applyI18nToProducts: () => applyI18nToProducts,
   applyPriceDataToProducts: () => applyPriceDataToProducts,
   getIsSessionProduct: () => getIsSessionProduct,
   perfMark: () => perfMark
@@ -155,6 +156,31 @@ var getIsOpenDetailModal = (product, context) => {
     scheduleTimeSlots
   };
 };
+var I18N_FIELD_MAP = {
+  title_i18n: "title",
+  subtitle_i18n: "subtitle",
+  description_i18n: "description",
+  cover_i18n: "cover"
+};
+function applyI18nToProducts(products, locale) {
+  if (!locale)
+    return products;
+  return products.map((product) => {
+    let patched = null;
+    for (const [i18nKey, originalKey] of Object.entries(I18N_FIELD_MAP)) {
+      const i18nDict = product[i18nKey];
+      if (!i18nDict)
+        continue;
+      const localizedValue = i18nDict[locale];
+      if (localizedValue) {
+        if (!patched)
+          patched = { ...product };
+        patched[originalKey] = localizedValue;
+      }
+    }
+    return patched ?? product;
+  });
+}
 var formatDataKey = (data) => {
   var _a, _b, _c, _d;
   const _data = {
@@ -258,6 +284,7 @@ function applyDetailValueToProducts(products, context) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   applyDetailValueToProducts,
+  applyI18nToProducts,
   applyPriceDataToProducts,
   getIsSessionProduct,
   perfMark

package/lib/types/index.d.ts

@@ -52,6 +52,7 @@ export interface PisellCore {
     validateContext: (config: ModuleContextConfig) => boolean;
     serverOptions?: ServerOptions;
     server?: any;
+    setContext: (ctx: Partial<BusinessContext>) => void;
 }
 /**
  * 业务上下文接口
@@ -59,6 +60,7 @@ export interface PisellCore {
 export interface BusinessContext {
     userId?: string;
     companyId?: string;
+    locale?: string;
     [key: string]: any;
 }
 /**

package/package.json

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