Shopify Local Access Console

给客户 Shopify 建站配置权限。

默认按“新建可转让店铺”做客户新站：先在 Partner 后台建店，开发完成后转移所有权给客户。已有客户店铺需要改造时，再切到协作店铺模式。

店铺制作模式选择

给客户从 0 建站时，优先用“新建可转让店铺”。接手客户已有店铺时，才用“已有客户店铺”。

默认推荐：适合你给客户从头做新 Shopify 网站。 你在 Partner 后台创建 client transfer store / 面向客户的可转让商店，自己先开发制作，完成后把店铺所有权转移给客户。客户接收后选择套餐并续费。

打开 Partner 后台商店列表查看 Client transfer store 官方说明

从哪里开始 去 Partner 后台商店列表，点 Add store / 添加商店。

弹窗两个选项怎么选 客户正式新站选 Client transfer。Dev 只给测试、暂存和自用开发。

国家 / Country 怎么选 选客户的主国家，不是全球市场国家。它主要影响默认 Backup region。

全球业务怎么选 全球业务也要先定一个主国家。美国站和美元收款通常选 United States；不确定就先问客户。

制作期间谁有权限 店铺先在你的 Partner 账号下，能直接做主题、商品、应用和开发。

做好后怎么交付 在 Partner 后台转移所有权，客户接收并选套餐；你后续要再维护，就让客户补协作者权限。

用于客户已经有 Shopify 店铺，需要你进入原店改造。 这种模式必须看客户给你的账号权限。能进店铺后台，不代表能创建 app、安装 app、配置 scopes 或读取 Admin API。

直接客户账号 客户把店主账号或拥有足够权限的员工账号给你操作。通常权限阻力最少，但要注意账号安全和责任边界。

合作者账号 客户批准你的 collaborator 访问。适合正规协作，但客户必须明确给到 Apps and channels、Develop apps、Online Store 等实际权限。

App 权限重点 Client ID + Client secret 只是 app 凭据。必须完成 Release / 发布版本 和 Install app / 安装 app 到当前客户店铺，B. 店铺功能/API 权限才算完成。

客户店铺与权限

新建可转让店铺做好后，也把生成的 myshopify.com 域名填这里。AI 和后端命令只读取当前应用的一个客户店铺。

账号管理

当前应用账号 未应用任何店铺 正在读取浏览器账号库。

店铺权限设置

Shopify 店铺域名示例：your-store.myshopify.com，不需要 https://。打开当前店铺后台

店铺域名在哪里看

打开 Shopify 后台。
看浏览器地址栏，找到类似 xxxxx.myshopify.com 的域名。
只复制这个域名，不要复制后面的路径。

每个客户店铺只按两套权限管理

A. 主题制作权限 填 Theme Access token。用于选择、拉取、预览、上传 OS 2.0 主题，做首页、产品页、集合页、样式和可视化区块。 B. 店铺功能/API 权限 填 Client ID + Client secret。用于商品、库存、SEO、metafields、metaobjects、后台 app、安装授权；需要事件通知时再加 Webhook。

新客户建站先填 A；需要批量处理数据或开发功能时，再补 B。B 不是填完 Client ID/secret 就结束，必须把 app 安装到当前店铺后才算完成。

A. 主题制作权限

主题访问令牌用途：只做主题开发时填这里，用于 theme list、theme pull、theme dev、主题上传和预览。推荐通过 Shopify 官方 Theme Access app 生成。不要填：Client ID、Client secret、普通后台登录密码。它不能批量修改商品、订单、客户或 metafields。去获取主题访问令牌

如何获取主题访问令牌

进入 Shopify 后台，打开 Apps。
搜索并安装 Shopify 官方 Theme Access app。
打开 Theme Access，创建 developer password。
权限选择允许访问主题，生成后复制 password。
粘贴到上面的“主题访问令牌”。

这个令牌主要给我改主题用，比如拉取主题、预览主题、上传主题修改。

B. 店铺功能/API 权限

这一组用于 Admin API、后台 app、安装授权、Webhook。只做主题外观时可以整组留空。

按这 5 步完成 Client ID、Client secret 和 app 安装

打开当前店铺 Develop apps 打开 Shopify Dev Dashboard

先判断账号类型：客户自己的店主/员工账号优先；合作者账号 / Collaborator account 需要客户给到 app 开发、安装 app、在线商店等权限。

进入真正的 Dev Dashboard 先点 打开当前店铺 Develop apps。
看到 Build and manage apps in your Dev Dashboard 时，改点 打开 Shopify Dev Dashboard。
如果出现 This store will be right back，先回店铺后台确认账号和开发权限。
创建应用 / Create app 在 App name 填一个能认得出来的名字，然后点 Create。建议写 Local Dev Access 或客户店铺名。
保存 app 页面 URL 复制地址栏里 https://dev.shopify.com/dashboard/.../apps/... 这一段，填到下面的 Dev Dashboard app 页面 URL。
选权限并发布 App URL 先可填占位；Scopes 按下面的整站制作推荐勾选；最后点 Release。
用自定义分发安装 选 Custom distribution，填目标店铺域名，点 Generate link。
重点：以后用这个生成的 install link 打开安装页，不要只点概览页 Install。
完成标准：店铺后台 Apps / 应用 里能看到这个 app。打开这个 app 概览页
复制凭据 打开 Settings，把 Client ID 和 Client secret 分别填到下面两个输入框。

Dev Dashboard app 页面 URL 创建 app 后复制浏览器地址栏里的 Dev Dashboard app URL。每个客户、每个 app 都不同；填了它，安装和设置按钮才会打开正确 app。打开 Shopify Dev Dashboard Client ID 从 Dev Dashboard 左侧 Settings 里复制，字段名就叫 Client ID。它不是 access token，也不是 Theme Access password。只填 Client ID 不够；必须继续填写下面的 Client secret，并完成 scopes + 安装。 Client secret 从同一个 Settings 页面复制，字段名就叫 Client secret。它和上面的 Client ID 是一对。这是敏感信息。不要填 Theme Access password；勾选保存前，请确认这台电脑可信。即使这两个字段都填了，app 没安装到店铺前，B 权限仍未完成。 App URL（可选）用途：如果要在 Shopify 后台打开 app 页面，这里填你的 HTTPS app 服务首页。只做数据/API 工具时可暂时留空。当前你的安装入口应以 自定义分发生成的安装链接 为准，不要只靠概览页按钮。去配置 App URL Redirect URL（可选）用途：OAuth 安装授权回调地址。开发完整后台 app 时需要；只做主题制作可留空。去配置 Redirect URL Webhook URL（可选）用途：接收订单、商品、库存等事件通知时才需要。不是每个 app 都必须配置。去配置 Webhook

整站制作推荐 scopes

权限选择提示： All APIs 只是筛选显示范围，不是一键全选。不要把所有 checkbox 都勾上。

新手推荐： 每个客户店铺创建一套 app 凭证，先按 整站制作推荐包 逐个搜索勾选；后面具体项目需要更多权限时，再单独补。

商品/集合数据 read_products write_products

页面内容 read_online_store_pages write_online_store_pages read_content write_content

导航菜单 read_online_store_navigation write_online_store_navigation

客户数据（需要时） read_customers write_customers

订单分析/处理 read_orders write_orders

库存/地点 read_inventory write_inventory read_locations

折扣/营销 read_discounts write_discounts

草稿订单 read_draft_orders write_draft_orders

履约/发货 read_fulfillments write_fulfillments

谨慎添加 read_all_orders read_customer_payment_methods write_customer_payment_methods

整站制作需要先勾商品/集合、页面内容、导航菜单三组。否则只能改主题和商品，不能自动创建页面或菜单。read_all_orders 和客户付款方式属于更敏感权限，如果页面不允许、提示审核，或者暂时用不到，就先不勾。

发布后必须重新安装：改完权限范围后，要创建新版本并发布，再用 Custom distribution 生成安装链接重新安装到当前店铺；只改 scopes 不重新安装，Admin API 仍会返回 ACCESS_DENIED。

App URL / Redirect / Webhook 怎么看：Client ID 和 Client secret 是功能/API 权限的基础。App URL 和 Redirect URL 是开发可打开的后台 app 时需要；Webhook 只在要接订单、商品、库存等事件时需要。

我手里已经有 Admin API access token 少数旧 app 或自定义 app 才用。新客户建站一般不用点开。

如果 Shopify 页面直接给了一个 Admin API access token，可以填这里；如果你已经填写 Client ID / Client secret，这里留空。

Admin API access token（可选）用途：已有 Admin API token 时用于商品、库存、订单、客户、metafields、metaobjects 等数据操作。不要主动找“旧版入口”。没有现成 token 就用上面的 Client ID / Client secret。不要填 Theme Access password，也不要填 Client secret。去查看 Admin API 凭证入口

保存 token 和 secret 到浏览器账号库；点击应用后，只把这个账号写入后端运行配置

未应用账号只存在浏览器本机。后端和 AI 运行配置只能看到“当前应用账号”。

本机环境

确认这台电脑具备 Shopify 本地开发基础。

Node.js检测中

npm检测中

Shopify CLI检测中

Git检测中

Access Modules

通用权限配置

CLI 环境

检测本机是否已安装 Shopify CLI。

npm install -g @shopify/cli@latest

主题权限

填写主题访问令牌后，可读取、拉取、预览和修改主题。

shopify theme list --store your-store.myshopify.com

Admin API 权限

填写 Admin API token 后，可验证店铺 API 访问。

GraphQL: shop { name myshopifyDomain }

本地主题副本

把远程主题拉到本地 theme 文件夹，后续在副本上开发。

shopify theme pull --store your-store.myshopify.com --path theme

App 开发

可新建 Shopify app，或使用已有 app key/secret 调试。

npm init @shopify/app@latest shopify-app

执行与验证输出

命令输出、权限验证结果和下一步提示会显示在这里。

等待操作。

提示词建议

可以直接复制给执行任务的提示词，也可以按下面的拆分方式逐步下发。

整站仿站总提示词

我需要使用当前 http://shopify.svipf.svipwebs.com/ 的应用的店铺 cakf01-sfxuxijc.myshopify.com 和对应的权限（这是一个全新的店铺），执行整站制作仿站任务，对标网站 www.xxxxx.com，需要各个页面尽可能接近，制作过程需要严格按照 Codex 里的 Shopify 的 skill 的规范，以及 Shopify 主题开发的基本规范。全程自动执行，需要先分解整个任务，然后按各个任务逐个完成并验收。当前 cakf01-sfxuxijc.myshopify.com 店铺里实际使用的主题，只是系统初始设置的主题，你需要根据任务需要，选择及安装最适合的主题，并进行完整网站制作。资料都先用对标网站的占位资料。

1. 先确认制作模式 明确新店、主题选择、目录隔离和工作区结构。 2. 再确认店铺与权限 检查主题访问令牌、Admin API、app 凭据是否就绪。 3. 分解实施任务 按首页、产品页、集合页、信息页、导航、页脚逐个完成。 4. 每步都验收 每个阶段输出修改结果、风险点和下一步。

新手怎么填

给客户做 Shopify 新站，把权限分成两套：主题制作权限填 Theme Access token；店铺功能/API 权限填 Client ID、Client secret，并按需要补 App URL、Redirect URL、Webhook URL。已有 Admin API token 的情况放在折叠区里，平时不用管。

Shopify CLI Theme Access Admin API App 开发