用途：为新建 Shopify 应用搭建认证流程，使用官方 @shopify/shopify-api 库，覆盖 OAuth、会话令牌交换、自定义应用令牌及 Storefront API 访问。前置条件：Node.js 18+、Shopify Partner 账号、在 Partner Dashboard 创建应用并获取 API 凭据、一个用于测试的开发商店。
主要能力：安装核心库及运行适配器，如 npm install @shopify/shopify-api @shopify/shopify-app-remix，或对独立 Node 应用使用 @shopify/shopify-app-express；配置环境变量（SHOPIFY_API_KEY、SHOPIFY_API_SECRET、SHOPIFY_SCOPES、SHOPIFY_APP_URL、SHOPIFY_HOST_NAME、SHOPIFY_API_VERSION 等）；初始化 shopifyApi 实例；实现 OAuth 流程或嵌入式应用的会话令牌交换；自定义/私有应用使用永久访问令牌；通过 Admin API GraphQL 查询验证连接。
使用方式：创建 .env 并加入 .gitignore；用 shopifyApi 初始化；公共应用走 OAuth 回调换取令牌，嵌入式应用调用 shopify.auth.tokenExchange 将 JWT 换为 API 访问令牌；单店自定义应用直接用永久令牌，无需 OAuth；最后用 GraphQL shop 查询验证认证是否生效。输出包括库安装配置完成、认证流程可用、有效令牌会话持久化、Admin API 连接验证通过。
适用场景：Shopify 应用开发初期的认证配置。限制：未提供具体代码以外的价格、效果或平台支持信息；错误处理需按表排查，如 InvalidApiKeyError、InvalidHmacError、SessionNotFound、401、InvalidScopeError、InvalidShop；shop 域名须为 *.myshopify.com 并使用 sanitizeShop()；API 版本需按季度更新。