SuperAPI AI 工具集

enable-shopify-markets

通用与其它

查看项目

更新于 10-16 03:36

技能介绍

用途:在 Vercel Shop 模板中加入多区域商务,将 next-intl 路由与 Shopify Markets 的国家/语言上下文绑定,让已校验的区域化语言标签同时决定翻译文案与 Shopify 的 country/language 上下文。适用于新区域化实现、已本地化/自定义项目,以及已启用仅文案 i18n 的项目,需先归类安装状态再动手。

主要能力:区域化 locale 作为唯一事实来源;提供 getCountryCode、getLanguageCode、getCommerceLocale 等边界校验,把校验后的 locale 转为 CommerceLocale 对象传给 Storefront API 操作;支持三种公开路由——区域子路径(如 /fr-CA/products/shoe)、隐形 Cookie(公开路径保持干净,内部重写为 /[locale]/...,但所有语言共享同一规范 URL,存在 SEO 取舍)、按域名(域选择 locale 上下文);货币始终取自 Shopify 本地化响应的 MoneyV2.currencyCode,不得由 locale 推断或新增货币映射。

使用方式:先阅读 package.json、lib/config/index.ts、lib/content/index.ts 及相关 Storefront 操作、购物车、客户账户、SEO 与 markdown 路由等现状;缺失时再安装 next-intl,并用 pnpm add next-intl。需要询问用户选定路由策略与默认/启用 locale(必须含语言与区域,如 en-US、fr-CA),再创建 lib/i18n/index.ts、routing、navigation、request、params 等模块,把根布局与页面移入 app/[locale]/,将 api、agent、md、llms.txt、robots.ts、sitemap 等保留在 app/ 下,并用 root-param 解析 locale。改动 Shopify GraphQL 前需用 Shopify AI Toolkit 核实当前 API 并校验完整操作,避免冗余市场键、货币映射与 /market/locale 路由。

限制:不负责推断购物者的商务国家,也不应仅凭 enable-i18n 引入的文案 locale 推测;已有自定义市场模型需要显式迁移决策而非自动删除;要保留既有目录、翻译、URL、域名、Cookie、重定向与缓存契约,不能盲目重装 next-intl;货币与具体支持的国家/语言值等资料未完整提供。