Cart 是 Lexsis 的购物车配置技能,用于创建、设计、组合、预览和管理 Lexsis 购物车配置文件(cart profiles)。购物车配置文件与页面区块 HTML 分开管理,页面通过其支持的页面配置启用购物车,不应在页面区块中添加 DrawerShell 或购物车行标记。
用途
该技能用于管理购物车配置文件的完整生命周期,包括读取有效配置、编辑草稿、管理促销与优惠、预览不同状态、发布已批准版本、回滚、设置默认配置、分配活动以及归档。它通过 lexsis_cart、lexsis_drafts、lexsis_live_ops 等路由动作完成这些操作。
主要能力
读取与检查:使用 lexsis_cart.get 读取购物车配置,可通过 page_id 检查有效配置及解析来源,通过 cart_profile_id 检查可编辑配置,通过 store_id 列出配置。使用 lexsis_cart.capabilities 查询能力,使用 lexsis_cart.promotions 查询促销,使用 lexsis_cart.preview 和 lexsis_cart.preview_states 进行预览。
草稿编辑:使用 lexsis_drafts.cart_set、cart_edit、cart_promotions_edit 编辑草稿。cart_edit 支持购物车模式、类型化设计设置、响应式呈现、作用域自定义 CSS 以及组合操作(upsert、move、set_enabled、remove)。cart_promotions_edit 用于促销、优惠、阈值、优惠券、支付和规则的编辑。
发布与生命周期:使用 lexsis_live_ops.cart_publish 发布精确批准的版本,使用 lexsis_live_ops.cart_rollback 回滚,使用 lexsis_live_ops.cart_set_default 设置默认配置,使用 lexsis_drafts.cart_assign_campaign 分配活动,使用 lexsis_drafts.cart_archive 归档。
使用方式
首先调用 lexsis_cart.get 读取配置。在首次设计或组合编辑前调用 lexsis_cart.capabilities。通过 lexsis_design.island_schema 解析 island 属性。对于折扣或优惠,调用 lexsis_cart.promotions 并报告配置值、活动 Shopify 折扣以及就绪或冲突诊断,然后使用 cart_promotions_edit 应用更改。编辑草稿时使用 lexsis_drafts.cart_edit 和部分补丁,可使用 dry_run:true 在保存前编译。预览时调用 lexsis_cart.preview,传入 page_id、cart_profile_id 和 fixture。发布前需获得对精确草稿的明确批准,然后调用 lexsis_live_ops.cart_publish。
适用场景
适用于需要配置和管理 Lexsis 购物车外观、行为、促销、优惠、支付选项、自定义模块以及预览不同购物车状态的场景。也适用于需要发布、回滚、设置默认、分配活动或归档购物车配置文件的场景。
限制
不得虚构产品、价格、货币、优惠或销售计划。草稿编辑在精确版本被明确批准并通过 lexsis_live_ops.cart_publish 或应用发布之前不会生效。自定义 CSS 必须保持在购物车作用域内,不允许外部导入、远程 URL、脚本逃逸和不平衡规则。购物车行、订单摘要、结账和 DrawerShell 由渲染器拥有。预览 URL 15 分钟后过期。Lexsis 不启动浏览器,需在自有浏览器中打开返回的 URL 并检查移动端/桌面端。示例购物车在内存中,阻止结账且不接触 lx_cartId。计算估算不能证明 Shopify 折扣就绪。Shopify 写入仅在发布时发生。回滚恢复前向草稿,但不发布。