@pisell/pisellos 2.3.59 → 2.3.61

package/dist/core/index.d.ts

@@ -12,15 +12,8 @@ declare class PisellOSCore implements PisellCore {
     context: BusinessContext;
     server: any;
     serverOptions?: ServerOptions;
-    private serverModulePromise?;
     constructor(options?: PisellOSOptions);
     private initialize;
-    /**
-     * 仅预加载 Server 模块代码，不创建实例、不注册模块、不请求业务数据。
-     * 导入失败会清空 Promise，正式 initializeServer 时仍可重新尝试。
-     */
-    preloadServerModule(): Promise<void>;
-    private loadServerModule;
     /**
      * 初始化 Server（公开方法，需要外部显式调用并等待）
      * Server 配置从构造函数传入的 options.server 中获取

package/dist/core/index.js

@@ -24,6 +24,8 @@ import { EffectsManager } from "../effects";
  * pisell OS 核心实现
  */
 var PisellOSCore = /*#__PURE__*/function () {
+  // 保存 Server 配置
+
   function PisellOSCore(options) {
     _classCallCheck(this, PisellOSCore);
     _defineProperty(this, "plugins", new Map());
@@ -35,8 +37,6 @@ var PisellOSCore = /*#__PURE__*/function () {
     _defineProperty(this, "server", void 0);
     // Server 实例
     _defineProperty(this, "serverOptions", void 0);
-    // 保存 Server 配置
-    _defineProperty(this, "serverModulePromise", void 0);
     this.debug = (options === null || options === void 0 ? void 0 : options.debug) || false;
     this.context = (options === null || options === void 0 ? void 0 : options.context) || {};
 
@@ -45,7 +45,7 @@ var PisellOSCore = /*#__PURE__*/function () {
       this.serverOptions = options.server;
     }
     this.initialize(options);
-    console.log('constructor123456');
+    console.log('constructor1234');
   }
   _createClass(PisellOSCore, [{
     key: "initialize",
@@ -64,49 +64,6 @@ var PisellOSCore = /*#__PURE__*/function () {
       this.log('[PisellOS] 核心初始化完成');
     }
 
-    /**
-     * 仅预加载 Server 模块代码，不创建实例、不注册模块、不请求业务数据。
-     * 导入失败会清空 Promise，正式 initializeServer 时仍可重新尝试。
-     */
-  }, {
-    key: "preloadServerModule",
-    value: (function () {
-      var _preloadServerModule = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
-        return _regeneratorRuntime().wrap(function _callee$(_context) {
-          while (1) switch (_context.prev = _context.next) {
-            case 0:
-              if (!(this.server || !this.serverOptions)) {
-                _context.next = 2;
-                break;
-              }
-              return _context.abrupt("return");
-            case 2:
-              _context.next = 4;
-              return this.loadServerModule();
-            case 4:
-            case "end":
-              return _context.stop();
-          }
-        }, _callee, this);
-      }));
-      function preloadServerModule() {
-        return _preloadServerModule.apply(this, arguments);
-      }
-      return preloadServerModule;
-    }())
-  }, {
-    key: "loadServerModule",
-    value: function loadServerModule() {
-      var _this2 = this;
-      if (!this.serverModulePromise) {
-        this.serverModulePromise = import("../server").catch(function (error) {
-          _this2.serverModulePromise = undefined;
-          throw error;
-        });
-      }
-      return this.serverModulePromise;
-    }
-
     /**
      * 初始化 Server（公开方法，需要外部显式调用并等待）
      * Server 配置从构造函数传入的 options.server 中获取
@@ -114,57 +71,57 @@ var PisellOSCore = /*#__PURE__*/function () {
   }, {
     key: "initializeServer",
     value: (function () {
-      var _initializeServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(options) {
+      var _initializeServer = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(options) {
         var ServerModule, Server;
-        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
-          while (1) switch (_context2.prev = _context2.next) {
+        return _regeneratorRuntime().wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
             case 0:
               if (!this.server) {
-                _context2.next = 3;
+                _context.next = 3;
                 break;
               }
               this.log('Server 已经初始化，跳过重复初始化', 'warn');
-              return _context2.abrupt("return");
+              return _context.abrupt("return");
             case 3:
               if (this.serverOptions) {
-                _context2.next = 6;
+                _context.next = 6;
                 break;
               }
               this.log('未提供 Server 配置，无法初始化', 'warn');
-              return _context2.abrupt("return");
+              return _context.abrupt("return");
             case 6:
-              _context2.prev = 6;
-              _context2.next = 9;
-              return this.loadServerModule();
+              _context.prev = 6;
+              _context.next = 9;
+              return import("../server");
             case 9:
-              ServerModule = _context2.sent;
+              ServerModule = _context.sent;
               Server = ServerModule.default; // 创建 Server 实例
               this.server = new Server(this);
               this.log('Server 实例已创建');
 
               // 初始化模块并预加载数据
               if (!this.serverOptions.modules) {
-                _context2.next = 16;
+                _context.next = 16;
                 break;
               }
-              _context2.next = 16;
+              _context.next = 16;
               return this.server.initialize(this.serverOptions.modules, this.serverOptions.autoInitData !== false, options);
             case 16:
               console.log('[PisellOS] ✅ Server 初始化完成，所有数据已预加载');
               this.log('[PisellOS] Server 初始化完成');
-              _context2.next = 25;
+              _context.next = 25;
               break;
             case 20:
-              _context2.prev = 20;
-              _context2.t0 = _context2["catch"](6);
-              console.error('[PisellOS] ❌ Server 初始化失败:', _context2.t0);
-              this.log("Server \u521D\u59CB\u5316\u5931\u8D25: ".concat(_context2.t0), 'error');
-              throw _context2.t0;
+              _context.prev = 20;
+              _context.t0 = _context["catch"](6);
+              console.error('[PisellOS] ❌ Server 初始化失败:', _context.t0);
+              this.log("Server \u521D\u59CB\u5316\u5931\u8D25: ".concat(_context.t0), 'error');
+              throw _context.t0;
             case 25:
             case "end":
-              return _context2.stop();
+              return _context.stop();
           }
-        }, _callee2, this, [[6, 20]]);
+        }, _callee, this, [[6, 20]]);
       }));
       function initializeServer(_x) {
         return _initializeServer.apply(this, arguments);
@@ -197,7 +154,7 @@ var PisellOSCore = /*#__PURE__*/function () {
   }, {
     key: "registerPlugin",
     value: function registerPlugin(plugin, options) {
-      var _this3 = this;
+      var _this2 = this;
       if (this.plugins.has(plugin.name)) {
         this.log("\u63D2\u4EF6 ".concat(plugin.name, " \u5DF2\u7ECF\u6CE8\u518C\u8FC7\uFF0C\u5C06\u88AB\u8986\u76D6"), 'warn');
       }
@@ -225,7 +182,7 @@ var PisellOSCore = /*#__PURE__*/function () {
         var result = plugin.initialize();
         if (result instanceof Promise) {
           result.catch(function (err) {
-            _this3.log("\u63D2\u4EF6 ".concat(plugin.name, " \u521D\u59CB\u5316\u5931\u8D25: ").concat(err.message), 'error');
+            _this2.log("\u63D2\u4EF6 ".concat(plugin.name, " \u521D\u59CB\u5316\u5931\u8D25: ").concat(err.message), 'error');
             throw err;
           });
         }
@@ -251,7 +208,7 @@ var PisellOSCore = /*#__PURE__*/function () {
   }, {
     key: "registerModule",
     value: function registerModule(module, options) {
-      var _this4 = this;
+      var _this3 = this;
       if (this.modules.has(module.name)) {
         this.log("\u6A21\u5757 ".concat(module.name, " \u5DF2\u7ECF\u6CE8\u518C\u8FC7\uFF0C\u5C06\u88AB\u8986\u76D6"), 'warn');
       }
@@ -294,7 +251,7 @@ var PisellOSCore = /*#__PURE__*/function () {
       // 预先给模块初始化值系统
       var _createStore = createStore((options === null || options === void 0 ? void 0 : options.initialState) || {}, module.name, function (path, value) {
           console.log('core 检测到模块值更新', module.name, path, value);
-          _this4.effects.emit("".concat(module.name, ":changed"), {
+          _this3.effects.emit("".concat(module.name, ":changed"), {
             path: path,
             value: value
           });
@@ -309,7 +266,7 @@ var PisellOSCore = /*#__PURE__*/function () {
         }, options));
         if (result instanceof Promise) {
           result.catch(function (err) {
-            _this4.log("\u6A21\u5757 ".concat(module.name, " \u521D\u59CB\u5316\u5931\u8D25: ").concat(err.message), 'error');
+            _this3.log("\u6A21\u5757 ".concat(module.name, " \u521D\u59CB\u5316\u5931\u8D25: ").concat(err.message), 'error');
             throw err;
           });
         }
@@ -354,100 +311,100 @@ var PisellOSCore = /*#__PURE__*/function () {
   }, {
     key: "destroy",
     value: function () {
-      var _destroy = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
+      var _destroy = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
         var _iterator4, _step4, _step4$value, name, module, _iterator5, _step5, _step5$value, _name, plugin;
-        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
-          while (1) switch (_context3.prev = _context3.next) {
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
             case 0:
               // 先销毁模块
               _iterator4 = _createForOfIteratorHelper(this.modules.entries());
-              _context3.prev = 1;
+              _context2.prev = 1;
               _iterator4.s();
             case 3:
               if ((_step4 = _iterator4.n()).done) {
-                _context3.next = 17;
+                _context2.next = 17;
                 break;
               }
               _step4$value = _slicedToArray(_step4.value, 2), name = _step4$value[0], module = _step4$value[1];
               if (!module.destroy) {
-                _context3.next = 15;
+                _context2.next = 15;
                 break;
               }
-              _context3.prev = 6;
-              _context3.next = 9;
+              _context2.prev = 6;
+              _context2.next = 9;
               return Promise.resolve(module.destroy());
             case 9:
               this.log("\u6A21\u5757 ".concat(name, " \u5DF2\u9500\u6BC1"));
-              _context3.next = 15;
+              _context2.next = 15;
               break;
             case 12:
-              _context3.prev = 12;
-              _context3.t0 = _context3["catch"](6);
-              this.log("\u9500\u6BC1\u6A21\u5757 ".concat(name, " \u65F6\u51FA\u9519: ").concat(_context3.t0), 'error');
+              _context2.prev = 12;
+              _context2.t0 = _context2["catch"](6);
+              this.log("\u9500\u6BC1\u6A21\u5757 ".concat(name, " \u65F6\u51FA\u9519: ").concat(_context2.t0), 'error');
             case 15:
-              _context3.next = 3;
+              _context2.next = 3;
               break;
             case 17:
-              _context3.next = 22;
+              _context2.next = 22;
               break;
             case 19:
-              _context3.prev = 19;
-              _context3.t1 = _context3["catch"](1);
-              _iterator4.e(_context3.t1);
+              _context2.prev = 19;
+              _context2.t1 = _context2["catch"](1);
+              _iterator4.e(_context2.t1);
             case 22:
-              _context3.prev = 22;
+              _context2.prev = 22;
               _iterator4.f();
-              return _context3.finish(22);
+              return _context2.finish(22);
             case 25:
               this.modules.clear();
 
               // 再销毁插件
               _iterator5 = _createForOfIteratorHelper(this.plugins.entries());
-              _context3.prev = 27;
+              _context2.prev = 27;
               _iterator5.s();
             case 29:
               if ((_step5 = _iterator5.n()).done) {
-                _context3.next = 43;
+                _context2.next = 43;
                 break;
               }
               _step5$value = _slicedToArray(_step5.value, 2), _name = _step5$value[0], plugin = _step5$value[1];
               if (!plugin.destroy) {
-                _context3.next = 41;
+                _context2.next = 41;
                 break;
               }
-              _context3.prev = 32;
-              _context3.next = 35;
+              _context2.prev = 32;
+              _context2.next = 35;
               return Promise.resolve(plugin.destroy());
             case 35:
               this.log("\u63D2\u4EF6 ".concat(_name, " \u5DF2\u9500\u6BC1"));
-              _context3.next = 41;
+              _context2.next = 41;
               break;
             case 38:
-              _context3.prev = 38;
-              _context3.t2 = _context3["catch"](32);
-              this.log("\u9500\u6BC1\u63D2\u4EF6 ".concat(_name, " \u65F6\u51FA\u9519: ").concat(_context3.t2), 'error');
+              _context2.prev = 38;
+              _context2.t2 = _context2["catch"](32);
+              this.log("\u9500\u6BC1\u63D2\u4EF6 ".concat(_name, " \u65F6\u51FA\u9519: ").concat(_context2.t2), 'error');
             case 41:
-              _context3.next = 29;
+              _context2.next = 29;
               break;
             case 43:
-              _context3.next = 48;
+              _context2.next = 48;
               break;
             case 45:
-              _context3.prev = 45;
-              _context3.t3 = _context3["catch"](27);
-              _iterator5.e(_context3.t3);
+              _context2.prev = 45;
+              _context2.t3 = _context2["catch"](27);
+              _iterator5.e(_context2.t3);
             case 48:
-              _context3.prev = 48;
+              _context2.prev = 48;
               _iterator5.f();
-              return _context3.finish(48);
+              return _context2.finish(48);
             case 51:
               this.plugins.clear();
               this.log('PisellOS 核心已销毁');
             case 53:
             case "end":
-              return _context3.stop();
+              return _context2.stop();
           }
-        }, _callee3, this, [[1, 19, 22, 25], [6, 12], [27, 45, 48, 51], [32, 38]]);
+        }, _callee2, this, [[1, 19, 22, 25], [6, 12], [27, 45, 48, 51], [32, 38]]);
       }));
       function destroy() {
         return _destroy.apply(this, arguments);

package/dist/model/strategy/adapter/walletPass/evaluator.js

@@ -257,7 +257,6 @@ export var WalletPassEvaluator = /*#__PURE__*/function () {
             var rawText = this.getText(reasonCode);
             // 金额类型字段：从 otherParams.getData 取货币符号；非金额或取不到则留空
             var currency = failedField && AMOUNT_FIELDS.has(failedField) ? ((_this$otherParams = this.otherParams) === null || _this$otherParams === void 0 || (_this$otherParams$get = (_this$otherParams2 = _this$otherParams).getData) === null || _this$otherParams$get === void 0 ? void 0 : _this$otherParams$get.call(_this$otherParams2, 'shop_symbol')) || '' : '';
-            console.log(currency, 'currency12345');
             var reason = thresholdValue !== undefined ? formatReason(rawText, thresholdValue, currency) : rawText;
             results.push({
               voucher: voucher,

package/dist/model/strategy/adapter/walletPass/type.d.ts

@@ -26,6 +26,11 @@ export interface Voucher {
     recommended_usage_amount: number;
     /** 后端计算推荐使用金额（仅商品） 不包含税费附加费 */
     recommended_pure_product_usage_amount: number;
+    /**
+     * 扫码资产自身可供前端重新计算的金额基准。
+     * 后端 recommended_usage_amount 会包含当前已选券上下文，取消勾选后不能继续把它当作资产永久上限。
+     */
+    _wallet_asset_recalculation_base_amount?: number;
     /** 实际抵扣金额 */
     actualDeduction: number;
     /** 抵扣详情 */

package/dist/model/strategy/adapter/walletPass/utils.js

@@ -1,9 +1,4 @@
 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 _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; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
-function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 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."); }
@@ -11,7 +6,25 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 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 _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 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; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import Decimal from 'decimal.js';
+var DEFAULT_WALLET_PASS_CALCULATION_CONFIG = {
+  maxDeductionAmount: 99999,
+  maxUsagePerOrder: 0,
+  allowCrossProduct: true,
+  applicableProductLimit: 0,
+  deductTaxAndFee: true,
+  maxPassesPerItem: 0,
+  deductOptionPrice: false
+};
+function getWalletPassCalculationConfig(voucher) {
+  return _objectSpread(_objectSpread({}, DEFAULT_WALLET_PASS_CALCULATION_CONFIG), (voucher === null || voucher === void 0 ? void 0 : voucher.config) || {});
+}
+
 /** 订单商品数量 */
 export var getProductQuantity = function getProductQuantity(product) {
   return product.quantity || product.product_quantity || 1;
@@ -72,12 +85,22 @@ function applyMaxPassUsageIncrements(usageMap, walletPassProductId, maxPassesPer
 // 辅助函数：根据 deductTaxAndFee 配置获取推荐使用金额
 var getRecommendedAmount = function getRecommendedAmount(voucher) {
   var _config$deductTaxAndF;
-  console.log('voucher312', voucher);
   var config = voucher.config,
     recommended_usage_amount = voucher.recommended_usage_amount,
     recommended_pure_product_usage_amount = voucher.recommended_pure_product_usage_amount;
   var deductTaxAndFee = (_config$deductTaxAndF = config === null || config === void 0 ? void 0 : config.deductTaxAndFee) !== null && _config$deductTaxAndF !== void 0 ? _config$deductTaxAndF : true; // 默认开启抵扣税费
 
+  // 扫码接口的 recommended_* 金额包含搜索时已选券的上下文，可能只是当时的
+  // 剩余可抵扣额。取消其他券后，前端重算需要回到资产自身金额基准，再由
+  // 剩余订单金额、适用商品金额和策略上限重新裁剪。
+  var rawRecalculationBaseAmount = voucher._wallet_asset_recalculation_base_amount;
+  if (rawRecalculationBaseAmount !== undefined && rawRecalculationBaseAmount !== null) {
+    var recalculationBaseAmount = Number(rawRecalculationBaseAmount);
+    if (Number.isFinite(recalculationBaseAmount) && recalculationBaseAmount >= 0) {
+      return recalculationBaseAmount;
+    }
+  }
+
   // 如果开启抵扣税费，使用 recommended_usage_amount（包含税费）
   // 如果关闭抵扣税费，使用 recommended_pure_product_usage_amount（仅商品金额）
   return deductTaxAndFee ? recommended_usage_amount : recommended_pure_product_usage_amount !== null && recommended_pure_product_usage_amount !== void 0 ? recommended_pure_product_usage_amount : recommended_usage_amount;
@@ -285,7 +308,6 @@ export function processVouchers(applicableVouchers, orderTotalAmount, products)
   // 辅助函数：判断券是否可用，返回可用性和原因代码
   var isVoucherAvailable = function isVoucherAvailable(voucher, productsData, usedVoucherCounts, itemPassUsage) {
     var config = voucher.config,
-      id = voucher.id,
       product_id = voucher.product_id;
 
     // 根据 deductTaxAndFee 配置获取推荐金额
@@ -659,6 +681,7 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
   var productsForCalc = expandProductsWithBundleItems(products, true);
   var remainingOrderAmount = new Decimal(orderTotalAmount);
   var selectedWithDetails = [];
+  var usedVoucherCounts = new Map();
 
   // 追踪每个 Wallet Pass 商品对每个订单商品行的已使用卡券次数（按行唯一键）
   var itemPassUsageMap = new Map();
@@ -678,15 +701,26 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
   // 第一步：按顺序应用已选中的券，计算实际抵扣
   selectedVouchers.forEach(function (selectedVoucher) {
     var _selectedVoucher$_ava;
-    var config = selectedVoucher.config,
-      id = selectedVoucher.id;
+    var product_id = selectedVoucher.product_id;
+    var config = getWalletPassCalculationConfig(selectedVoucher);
     var maxDeductionAmount = config.maxDeductionAmount,
+      maxUsagePerOrder = config.maxUsagePerOrder,
       allowCrossProduct = config.allowCrossProduct,
       applicableProductLimit = config.applicableProductLimit,
-      _config$deductTaxAndF4 = config.deductTaxAndFee,
-      deductTaxAndFee = _config$deductTaxAndF4 === void 0 ? true : _config$deductTaxAndF4,
-      _config$maxPassesPerI = config.maxPassesPerItem,
-      maxPassesPerItem = _config$maxPassesPerI === void 0 ? 0 : _config$maxPassesPerI;
+      deductTaxAndFee = config.deductTaxAndFee,
+      maxPassesPerItem = config.maxPassesPerItem;
+    var usedCount = usedVoucherCounts.get(product_id) || 0;
+    if (maxUsagePerOrder > 0 && usedCount >= maxUsagePerOrder) {
+      selectedWithDetails.push(_objectSpread(_objectSpread({}, selectedVoucher), {}, {
+        config: config,
+        actualDeduction: 0,
+        deductionDetails: [],
+        _available_max_amount: 0,
+        _unified_available_status: 0,
+        reasonCode: 'usage_limit_reached'
+      }));
+      return;
+    }
 
     // 根据券的配置选择使用哪个单价字段和金额字段
     var unitPriceField = deductTaxAndFee ? 'unitPriceWithTax' : 'unitPricePure';
@@ -702,6 +736,7 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
     if (applicableProducts.length === 0) {
       // 无适用商品，跳过
       selectedWithDetails.push(_objectSpread(_objectSpread({}, selectedVoucher), {}, {
+        config: config,
         actualDeduction: 0,
         deductionDetails: [],
         _available_max_amount: 0,
@@ -798,6 +833,7 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
     remainingOrderAmount = remainingOrderAmount.minus(totalDeducted);
     applyMaxPassUsageIncrements(itemPassUsageMap, selectedVoucher.product_id, maxPassesPerItem, deductionDetails);
     selectedWithDetails.push(_objectSpread(_objectSpread({}, selectedVoucher), {}, {
+      config: config,
       actualDeduction: totalDeducted.toNumber(),
       // 转换为数字
       deductionDetails: deductionDetails,
@@ -805,16 +841,15 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
       // 转换为数字
       _unified_available_status: totalDeducted.greaterThan(0) ? 1 : 0
     }));
+    if (totalDeducted.greaterThan(0)) {
+      usedVoucherCounts.set(product_id, usedCount + 1);
+    }
   });
 
   // 第二步：为所有券重新计算 _available_max_amount 和 _unified_available_status
   var selectedIds = new Set(selectedVouchers.map(function (v) {
     return v.id;
   }));
-  var usedVoucherCounts = new Map();
-  selectedVouchers.forEach(function (v) {
-    usedVoucherCounts.set(v.product_id, (usedVoucherCounts.get(v.product_id) || 0) + 1);
-  });
   var allWithUpdatedStatus = allVouchers.map(function (voucher) {
     // 如果是已选中的券，使用详细计算结果
     if (selectedIds.has(voucher.id)) {
@@ -825,16 +860,13 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
     }
 
     // 未选中的券，重新计算其可用状态
-    var config = voucher.config,
-      id = voucher.id,
-      product_id = voucher.product_id;
+    var product_id = voucher.product_id;
+    var config = getWalletPassCalculationConfig(voucher);
     var maxDeductionAmount = config.maxDeductionAmount,
       allowCrossProduct = config.allowCrossProduct,
       applicableProductLimit = config.applicableProductLimit,
-      _config$deductTaxAndF5 = config.deductTaxAndFee,
-      deductTaxAndFee = _config$deductTaxAndF5 === void 0 ? true : _config$deductTaxAndF5,
-      _config$maxPassesPerI2 = config.maxPassesPerItem,
-      maxPassesPerItem = _config$maxPassesPerI2 === void 0 ? 0 : _config$maxPassesPerI2;
+      deductTaxAndFee = config.deductTaxAndFee,
+      maxPassesPerItem = config.maxPassesPerItem;
 
     // 根据券的配置选择使用哪个单价字段和金额字段
     var unitPriceField = deductTaxAndFee ? 'unitPriceWithTax' : 'unitPricePure';
@@ -929,6 +961,7 @@ export function recalculateVouchers(allVouchers, selectedVouchers, orderTotalAmo
       }
     }
     return _objectSpread(_objectSpread({}, voucher), {}, {
+      config: config,
       _available_max_amount: calculatedMaxAmount.toNumber(),
       // 转换为数字
       _unified_available_status: isAvailable ? 1 : 0

package/dist/modules/Payment/types.d.ts

@@ -486,6 +486,8 @@ export interface WalletPassPayment {
     importWalletAssetsSnapshot: (snapshot: WalletAssetsSnapshot) => WalletAssetsState;
     /** 设置单张钱包资产的选择状态并重新计算其实际抵扣额。 */
     selectWalletAsset: (assetId: WalletAssetId, options: SelectWalletAssetOptions) => WalletAssetsState;
+    /** 更新已选钱包资产的手动使用金额，并保持原有选择顺序重新计算。 */
+    updateWalletAssetAmount: (assetId: WalletAssetId, amount: number) => WalletAssetsState;
     /** 精确搜索钱包资产；仅当前券可用时自动选择。 */
     scanWalletAssetAsync: (code: string) => Promise<ScanWalletAssetResult>;
     /** 清空未确认的钱包资产选择。 */

package/dist/modules/Payment/utils.js

@@ -12,9 +12,12 @@ export var getAvailableMaxAmount = function getAvailableMaxAmount(data) {
  */
 export var formatWalletPassList2PreparePayments = function formatWalletPassList2PreparePayments(list) {
   var formatted = (list || []).map(function (item) {
+    var _ref, _item$actualDeduction;
     return {
       voucher_id: item.id || 0,
-      amount: Number(item.edit_current_amount || getAvailableMaxAmount(item)) || 0,
+      // 前端策略重算后的 actualDeduction 才是最终可同步金额；
+      // edit_current_amount 只是用户请求值，仍可能被策略和订单剩余金额裁剪。
+      amount: Number((_ref = (_item$actualDeduction = item.actualDeduction) !== null && _item$actualDeduction !== void 0 ? _item$actualDeduction : item.edit_current_amount) !== null && _ref !== void 0 ? _ref : getAvailableMaxAmount(item)) || 0,
       tag: item.tag || '',
       wallet_pass_usage_unit: item.wallet_pass_usage_unit || {},
       wallet_pass_use_value: item.wallet_pass_use_value || undefined

package/dist/modules/Payment/walletpass.d.ts

@@ -24,6 +24,11 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
     private emitEvent;
     private publishWalletAssetsState;
     private recalculateWalletAssets;
+    /**
+     * 搜索接口只返回后端 Wallet Pass 数据，不包含前端策略 config。
+     * 在资产进入共享选择状态前补齐策略结果，避免增量重算回退到接口状态。
+     */
+    private formatSearchedWalletPaymentAssets;
     /** 获取当前缓存中所有支付类 Wallet 资产的扫码 code。 */
     private getSearchedWalletAssetCodes;
     /**
@@ -106,7 +111,13 @@ export declare class WalletPassPaymentImpl implements WalletPassPayment {
     getWalletAssetsState(): WalletAssetsState;
     exportWalletAssetsSnapshot(): WalletAssetsSnapshot;
     importWalletAssetsSnapshot(snapshot: WalletAssetsSnapshot): WalletAssetsState;
+    private updateWalletAssetEditAmountInCaches;
     selectWalletAsset(assetId: WalletAssetId, options: SelectWalletAssetOptions): WalletAssetsState;
+    /**
+     * 更新已选资产的手动金额。只允许在当前实际抵扣额内向下调整，
+     * 金额为 0 时沿用 legacy 行为取消选择。
+     */
+    updateWalletAssetAmount(assetId: WalletAssetId, amount: number): WalletAssetsState;
     scanWalletAssetAsync(code: string): Promise<ScanWalletAssetResult>;
     clearWalletAssetSelection(): WalletAssetsState;
     setCommittedWalletAssets(committedIds: WalletAssetId[], committedAssets?: any[]): WalletAssetsState;