用途：@commercengine/ai 通过 WebMCP 把 Commerce Engine 店铺的能力发布给浏览器 AI 智能体，让智能体经 SDK 而非点击 DOM 来搜索目录、解析变体、修改购物车并导航站点。
主要能力：智能体可搜索商品、查看商品与变体、读取购物车、添加/更新/删除购物车行、导航、打开购物车、打开结账、打开登录界面；不能输入地址、支付、下单、登录或读取密码与验证码。open_checkout 把控制权交回用户。工具按能力门控注册：始终注册 search_products、get_product、browse_store、get_variant；提供 session 后增加购物车工具；提供 checkout 后增加 open_cart、open_checkout；checkout.openLogin 增加 open_login；navigation 增加 open_product；navigation.ordersUrl 增加 manage_orders；shopContent 增加 search_shop_policies_and_faqs。
使用方式：npm install @commercengine/ai，对等依赖 @commercengine/storefront，可选 @commercengine/checkout（>= 0.3.0）。调用 registerCommerceWebMcp 传入 storefront、siteUrl、routes、checkout、navigation、diagnostics 等配置；无模型上下文时返回 null 而不抛错。routes 与 site 来自 defineCommerceSeoConfig，可与 @commercengine/seo 共享。
限制：WebMCP 是社区组草案，需 Chromium 149+ 并开启 chrome://flags/#enable-webmcp-testing 或使用源试用令牌。add_to_cart 为累加，set_cart_item_quantity 为绝对数量且 0 删除；促销赠品行不可删除。外部导航需 navigation.allowedExternalOrigins 显式允许。登录后购物车合并仅在令牌存活的同一浏览器会话内保证。注册非原子，需用 config.signal 与返回控制器处理取消，避免重复工具名错误。诊断事件包括 unsupported、registered、registered:N、rollback。访问 https://llm-docs.commercengine.io 需带 Accept: text/markdown 头或路径加 .md。