SHOPLINE 建站助手 — AI 自动化执行指令
本 SKILL.md 是 AI 的执行剧本。核心原则：AI 帮用户自动完成注册和配置，用户只需要提供信息。
透明度原则： 本技能通过浏览器自动化操作 SHOPLINE 后台页面。执行前应向用户说明 AI 将代为操作浏览器完成建站配置；对于密码、API 密钥等敏感信息，每次使用前需明确告知用途并获得用户确认。
零、浏览器模式
本技能始终使用 openclaw 隔离浏览器（OpenClaw 管理的沙盒浏览器实例，与用户个人 Chrome 完全隔离）。
不使用 profile="user"（CDP 连接用户个人浏览器）或 chrome-relay。原因：CDP 连接在技术上可访问用户所有标签页和 cookie，无法在 skill 层面强制约束范围，不符合最低权限原则。
对用户的说明： AI 会打开一个独立的浏览器窗口来操作 SHOPLINE，这个窗口与你的个人 Chrome 完全隔离。如果需要登录已有账号，AI 会引导你在这个独立窗口里手动登录（只需一次）。
批量操作规范（v2.0 新增）：
多个顺序操作尽量合并为批量调用以减少往返延迟：
CODEBLOCK0
一、触发后立即执行：信息收集
触发 skill 后，不要说废话，直接输出以下信息收集请求（一次性问完，用户填完就开始操作）：
👋 好的！我来帮你在 SHOPLINE 开店，全程 AI 帮你搞定，你只需要提供几个基本信息：
请一次性填写（填完我立刻帮你开始）：
- 1. 姓名：名字 / 姓氏（例：张 / 伟）
- 店铺名称：你的品牌名或店铺名（例：TrendyGoods Store）
- 目标市场：你主要卖给哪个国家/地区（例：United States / 美国）
- 注册邮箱：用来创建 SHOPLINE 账号的邮箱
- 公司名称（选填）：如有品牌/公司名可填，没有跳过
📌 说明：注册链接包含 UTM 归因参数（utm_source=openclaw），用于统计通过本 skill 完成注册的用户数量。这不影响你的注册流程和账号权益，SHOPLINE 不会因此向你收取额外费用。如不希望携带追踪参数，可直接访问 https://www.shopline.com/register 自行注册。
填好后我马上帮你注册 ✈️
收到用户信息后，进入注册流程。
二、注册流程（Step 1-6）
SHOPLINE 注册是一个多步骤 onboarding 表单，URL：
https://admin.myshopline.com/user/onboarding/6565889082504519950/en
| 步骤 | 页面内容 | 需要用户数据 | 可跳过 |
|---|
| Step 1 | 姓名 + 公司名 | ✅ First Name / Last Name / Company Name | ❌ 必填 |
| Step 2 |
身份选择 | 选「I am just starting」| ❌（自动选） |
| Step 3 | 销售方式 | 选「Online Store」| ❌（自动选） |
| Step 4 | 店铺名称 | ✅ Store name | ✅ 可 Skip |
| Step 5 | 销售地区 | ✅ 从下拉选用户的目标国家 | ❌ 必填 |
| Step 6 | 创建账号 | ✅ Email + Password（用户自填）| ❌ 必填 |
Step 1 — 姓名 + 公司名
执行步骤：
CODEBLOCK1
Step 2 — 身份选择
执行步骤：
CODEBLOCK2
⚠️ 如果用户是搬迁用户，改选「I am currently selling online or in-person」
Step 3 — 销售方式
执行步骤：
CODEBLOCK3
Step 4 — 店铺名称
执行步骤：
CODEBLOCK4
如用户未提供店铺名，点 Skip 跳过
Step 5 — 销售地区
执行步骤：
CODEBLOCK5
常用地区映射：美国 → United States，中国 → China，英国 → United Kingdom
Step 6 — 创建账号（🛑 AI 停止操作，用户在浏览器中自行完成）
执行步骤：
CODEBLOCK6
截图后告知用户：
🎯 最后一步到了！邮箱已经帮你填好了。
请你直接在刚才弹出的浏览器窗口里完成：
- 1. 在「Password」框里输入你的密码（8-20位，含大写/小写/数字/特殊字符）
- 在「Confirm Password」框里再次输入密码
- 勾选同意条款
- 点「SIGN UP」按钮
🔒 为什么要你自己输入？ 密码这种高敏感信息不应该通过聊天传递。请直接在浏览器里输入，这样密码不经过任何中间环节。
完成后告诉我「注册好了」，我继续帮你配置店铺 ✅
用户确认注册成功后，AI 继续：
CODEBLOCK7
注册完成 — 获取 store handle 并进入配置
执行步骤：
CODEBLOCK8
将 storeHandle 保存到进度文件：
CODEBLOCK9
完成后告知用户：
✅ 注册成功！你有 14 天免费试用期，无需立刻选套餐。
接下来我来帮你完成 4 步快速配置，让店铺准备好接单 🚀
⚠️ 后续所有 browser 操作的后台 URL 格式均为：
https://<storeHandle>.myshopline.com/admin/...
若 storeHandle 无法自动获取，询问用户登录 SHOPLINE 后台后，地址中 .myshopline.com 前面的那段名称。
三、Onboarding 配置（Step A/B/C/D）
注册成功后，AI 依次引导用户完成以下 4 个核心配置步骤。每步结束后截图确认，再进入下一步。
Step A：首页装修（AI 辅助）
先询问用户：
🏪
Step 1/4 — 首页装修
你这个店铺主要卖什么？用一句话描述一下
（例如：我们卖高端女装，风格简约优雅）
收到用户描述后，提供两个选择：
明白！你有两种方式来装修首页：
选 1：AI 自动建站（推荐）— SHOPLINE 内置 AI 建站功能，根据你的店铺类型自动生成完整主题、图片和文案，一键搞定 ✨
选 2：自己手动装修 — 我给你打开设计器，你自己来调
你选哪个？回复「1」或「2」
如果用户选 1（AI 自动建站）：
执行步骤：
CODEBLOCK10
⚠️ 路由说明（已实测验证）：
- - 主题管理入口： INLINECODE7
- AI Builder 页面： INLINECODE8
- ~~
/admin/themes~~ 和 ~~/admin/online-store/themes~~ 均为 404，不可用
完成后告知用户：
✅
AI 建站完成！ 你的店铺主题已上线 🎉
SHOPLINE AI 根据你的店铺描述自动生成了专属主题，包括图片、文案和页面布局，已直接发布。辅助页面（Contact us、Privacy Policy 等）也一并生成完毕。
如果用户选 2（手动装修）：
执行步骤：
CODEBLOCK11
完成后告知用户：
好的！这是你的主题设计器链接，你可以自己去调：
🔗 INLINECODE11
调好后告诉我，我们继续下一步 ✅
⚠️ AI 建站每个店铺免费使用 1 次。整个流程 AI 全程代操作，用户无需做任何选择。
Step B：上架第一个商品（AI 全自动）
AI 根据用户之前提供的店铺描述，自动生成商品信息并上架，不需要询问用户任何信息。
商品信息生成规则（根据店铺描述推断）：
| 店铺类型 | 商品示例 | 价格区间 |
|---|
| 运动/户外 | Lightweight Hiking Backpack 35L | $49.99 - $89.99 |
| 时尚/女装 |
Classic Linen Casual Dress | $29.99 - $69.99 |
| 家居/装饰 | Nordic Minimalist Table Lamp | $39.99 - $79.99 |
| 美妆/护肤 | Hydrating Daily Face Serum | $24.99 - $49.99 |
| 3C/科技 | Wireless Bluetooth Earbuds Pro | $39.99 - $79.99 |
图片来源：Unsplash（下载到本地再上传）
根据商品类型，从 Unsplash 下载 1-2 张匹配图片：
- - 运动背包： INLINECODE12
- 户外装备： INLINECODE13
- 时尚女装： INLINECODE14
- 家居装饰： INLINECODE15
下载命令： INLINECODE16
执行步骤：
CODEBLOCK12
完成后告知用户：
✅
第一个商品已上架！
🛍️ 商品：<商品名>
💰 价格：$<价格>
📝 描述：<一句话描述>
📦 库存：100
Step C：配置支付
导航： INLINECODE17
执行策略（三种支付方式，处理方式不同）：
| 支付方式 | AI 能否代操作 | 说明 |
|---|
| Cash on delivery | ✅ 可以 | 直接点 Enable → Add Cash On Delivery |
| PayPal |
❌ 不行 | Cloudflare 安全拦截，跳转后被阻止，需用户手动登录 PayPal 授权 |
| SHOPLINE Payments | ❌ 不行 | 需要 KYC 身份认证，必须用户手动提交 |
执行步骤：
CODEBLOCK13
完成后告知用户：
✅
货到付款（Cash on delivery）已开启！
另外还有两个支付方式需要你手动完成：
PayPal（推荐，美国客户常用）：
- 1. 在支付设置页找到 PayPal → 点 Enable
- 在弹出页面登录你的 PayPal 企业账号完成授权
SHOPLINE Payments（信用卡收款）：
- 1. 点「Activate SHOPLINE Payments」
- 按提示完成身份认证（KYC）
⚠️ PayPal 和 SHOPLINE Payments 均有安全验证机制，AI 无法代替登录，必须由真人操作。
Step D：配置物流
导航： INLINECODE18
执行步骤（全自动，无需询问用户）：
CODEBLOCK14
默认运费标准（AI 自动填入，无需询问用户）：
| Zone | 运费名称 | 价格 |
|---|
| US Domestic（美国全境） | Standard Shipping | $5.99 |
| International（全球 242 国） |
International Shipping | $14.99 |
完成后告知用户：
✅
物流配置完成！
已设置两个运费区：
- - 🇺🇸 美国境内：Standard Shipping $5.99
- 🌍 全球配送：International Shipping $14.99
⚠️ 技术注意：运费名称和价格输入框需用 native value setter + dispatchEvent('input') 填入，不能直接 type。spinbutton 的 value 格式为 $ 14.99（带空格和 $）。
🎉 Onboarding 完成
4 步全部完成后，输出：
🎉
恭喜！你的 SHOPLINE 店铺已经准备好接单了！
✅ 首页装修 — 完成
✅ 第一个商品 — 已上架
✅ 支付方式 — 已配置
✅ 物流规则 — 已设置
下一步建议：
- - 绑定你的独立域名（Settings > Domains）
- 继续上架更多商品
- 开启 Facebook / Google 广告引流
有任何问题随时问我！祝你早日首单 🚀
四、错误处理
| 场景 | AI 处理方式 |
|---|
| 遇到验证码（CAPTCHA） | 截图给用户，让用户手动处理，完成后告诉 AI 继续 |
| 遇到短信/邮箱验证码 |
截图给用户，用户输入验证码后 AI 继续 |
| 遇到二步验证（2FA）| 截图给用户，指导用户完成，然后继续 |
| 页面加载超时 | 刷新页面重试，超过3次告知用户 |
| 表单验证错误 | 截图显示错误信息，根据错误内容修正后重试 |
| 登录被重定向 | 截图给用户，引导用户手动登录后继续 |
截图原则： 凡需要用户介入，必先截图，让用户看到当前状态再操作。
CODEBLOCK15
五、通用原则
- - 语气简洁友好，像有经验的朋友帮你操作
- 不说废话，每步都有实质动作
- 每次截图后，将截图内容发给用户确认
- 遇到不确定的页面结构，先
browser(action=snapshot) 看清楚再操作 - 用户说「继续」就继续下一步，用户说「等一下」就暂停
关键链接
| 用途 | 链接 |
|---|
| 注册入口 | https://admin.myshopline.com/user/onboarding/6565889082504519950/en |
| 后台登录 |
https://admin.myshopline.com/user/signIn |
| 帮助中心（中文）| https://help.shopline.com/hc/zh-cn |
| 帮助中心（英文）| https://help.shopline.com/hc/en-001 |
| App Store | https://apps.shopline.com/?lang=en |
附录 A：基础店铺设置（可选）
如果用户需要调整基础设置（语言、货币、联系方式等），在 Onboarding 完成后执行：
基础店铺设置
路径： Settings > Basic settings
后台 URL： INLINECODE23
CODEBLOCK16
需要确认/配置的字段：
- - Store name（店铺显示名称）
- Store description（店铺描述，可选）
- Contact email（联系邮箱）
- Store address（店铺地址，影响税务和发票）
操作完成后截图给用户确认。
语言与货币设置
路径： Settings > Languages & Currencies
后台 URL： INLINECODE24
CODEBLOCK17
根据用户目标市场自动设置：
- - 默认语言（如 US 市场 → English）
- 货币（如 US 市场 → USD）
- 时区（如 US 市场 → America/NewYork 或 America/LosAngeles）
主题选择
路径： Online Store > Design（侧边栏），或首页「Design Your Store」按钮
后台 URL（已实测）： INLINECODE25
⚠️ /admin/themes 和 /admin/online-store/themes 均为 404，不可用，请用上方正确路由。
CODEBLOCK18
推荐走 AI Website Builder 流程（/admin/website/shopSetting/aiBuild），完整步骤见 Step A 章节。
附录 B：搬迁路径（Shopify / WooCommerce / Shoplazza）
如果用户说「我要从 Shopify / WooCommerce / Shoplazza 搬迁」，在完成注册 + 基础 Onboarding 后额外执行本流程。
触发关键词：「我现在在 Shopify / 从 Shopify 搬 / WooCommerce 迁移 / Shoplazza 转 SHOPLINE」
注册时 Step 2 身份选择改为「I am currently selling online or in-person」
B.1 搬迁插件信息
| 项目 | 内容 |
|---|
| 插件名 | Multi-platform Store Migration |
| 开发商 |
By SHOPLINE（官方出品） |
| 费用 | 免费 |
| 评分 | ⭐ 4.7（35条评价） |
| 支持平台 | Shopify、Shoplazza、WooCommerce |
| 搬迁内容 | 商品、客户、订单、301设置、Google Product Feed |
| App Store 详情页 |
https://apps.shopline.com/detail?appHandle=shopify_store_one_click_relocation&lang=en |
B.2 安装插件（AI 全自动）
CODEBLOCK19
⚠️ 技术注意：
- - App Store 页面（apps.shopline.com）与后台（myshopline.com/admin）是不同域，session 独立
- 如弹窗「The logged-in store does not match」→ 点「Re-login」重新授权即可
- 安装成功后会自动跳回后台并进入插件配置页
- INLINECODE30 在此场景优势明显：保持后台已登录状态，避免跨域 session 丢失问题
B.3 执行搬迁（安装后引导用户）
插件安装成功后，对用户说：
🎉 搬迁插件已安装！接下来需要你在 Shopify 这边做一个简单的授权配置，我来一步步告诉你怎么做。
⚠️ 重要提示：搬迁插件现在使用新版授权方式（Client ID + Secret），需要从 Shopify Dev Dashboard 创建应用获取，不是旧版的 API Access Token。
请按以下步骤操作（约5分钟）：
第一步： 打开 Shopify 开发者面板：https://shopify.dev/dashboard
（注意：这是开发者专用入口，不是店铺后台）
第二步： 点右上角 【Create app】 → 选 【Start from Dev Dashboard】 → App name 填 Migration Tool → 点 【Create】
第三步： 进入应用配置页：
- - 找 【App URL】 填： INLINECODE32
- 找 【Access > Select scopes】 → 勾选 Admin API 和 Customer Account API 下所有读写权限（Shopify Payments 相关可以不勾）
- 点 【Release】 发布
第四步： 点左侧 【Home】 → 右上角 【Install app】 → 选你的店铺，确认安装
第五步： 点左侧 【Settings】 → 在 Credentials 区域找到：
- - Client ID（直接复制）
- Secret（点眼睛图标显示后复制）
把 Client ID、Secret 和你的 Shopify 店铺 handle（yourstore.myshopify.com 前面那段）发给我，我来帮你填到搬迁工具里 ✅
📖 官方参考文档：https://help.shopline.com/hc/zh-cn/articles/53643605291929
⚠️ 注意事项：
- - 如果点 Install app 报错「此应用无法安装」：进入 Settings → Distribution → 选「自定义分发」→ 填入店铺域名 → 点 Generate Link → 在新标签页打开链接安装
- 如果搬迁插件界面仍然是要求输入 API Access Token 的旧版界面，则用旧版流程（在 Shopify 后台 Settings → Apps → Develop apps 里生成 Access Token）
用户提供信息后，AI 填写插件配置页并启动搬迁：
CODEBLOCK20
⚠️ 技术注意：
- - 搬迁插件托管在
admin.innovelabs.com，与 SHOPLINE 后台跨域，需用签名 URL 方式进入 - 签名 URL 有效期约 30 分钟，过期需重新调
/admin/appstore/get-install-url 获取 - 三个 input 中 index 0 为隐藏字段，从 index 1 开始是可见字段
- Secret 字段填的是 Shopify Dev Dashboard → Settings → Credentials 里的 Secret（格式
shpss_...，不是旧版 Access Token shpat_...） - 模块选择 checkbox 为 Vue 组件，必须用
elementFromPoint + 完整鼠标事件序列点击，JS click/dispatchEvent 无效 - 订单必须在商品+客户+折扣码全部勾选后再勾，否则弹依赖提示
搬迁启动后告知用户：
🚀
搬迁已启动！
数据正在从 [原平台] 迁移到你的 SHOPLINE 店铺，根据数据量大小通常需要几分钟到几小时。
迁移完成后你会收到邮件通知。期间店铺正常运营不受影响。
B.4 平台专属文档
| 来源平台 | 官方搬迁文档 |
|---|
| Shopify | https://help.shopline.com/hc/en-001/articles/4669702695193 |
| WooCommerce |
https://help.shopline.com/hc/en-001/articles/16784282483353 |
| Shoplazza | https://help.shopline.com/hc/en-001/articles/5943463861145 |
附录 C：References 索引
| 文件 | 内容 |
|---|
| INLINECODE39 | 新手流程话术参考（旧版，可参考细节） |
| INLINECODE40 |
搬迁流程话术参考（旧版，可参考细节） |
|
references/faq-zh.md | 中文 FAQ |
|
references/faq-en.md | 英文 FAQ |
SHOPLINE 建站助手 — AI 自动化执行指令
本 SKILL.md 是 AI 的执行剧本。核心原则：AI 帮用户自动完成注册和配置，用户只需要提供信息。
透明度原则： 本技能通过浏览器自动化操作 SHOPLINE 后台页面。执行前应向用户说明 AI 将代为操作浏览器完成建站配置；对于密码、API 密钥等敏感信息，每次使用前需明确告知用途并获得用户确认。
零、浏览器模式
本技能始终使用 openclaw 隔离浏览器（OpenClaw 管理的沙盒浏览器实例，与用户个人 Chrome 完全隔离）。
不使用 profile=user（CDP 连接用户个人浏览器）或 chrome-relay。原因：CDP 连接在技术上可访问用户所有标签页和 cookie，无法在 skill 层面强制约束范围，不符合最低权限原则。
对用户的说明： AI 会打开一个独立的浏览器窗口来操作 SHOPLINE，这个窗口与你的个人 Chrome 完全隔离。如果需要登录已有账号，AI 会引导你在这个独立窗口里手动登录（只需一次）。
批量操作规范（v2.0 新增）：
多个顺序操作尽量合并为批量调用以减少往返延迟：
python
推荐：一次调用执行多个动作
browser(action=act, request=[
{kind: click, ref: e12},
{kind: type, text: TrendyGoods Store},
{kind: press, key: Tab}
])
selector 定位（当 ref 不稳定时使用）
browser(action=act, request={kind: click, selector: #next-btn})
延迟点击（等页面动画/渲染完成）
browser(action=act, request={kind: click, ref: e12, delayMs: 500})
一、触发后立即执行：信息收集
触发 skill 后，不要说废话，直接输出以下信息收集请求（一次性问完，用户填完就开始操作）：
👋 好的！我来帮你在 SHOPLINE 开店，全程 AI 帮你搞定，你只需要提供几个基本信息：
请一次性填写（填完我立刻帮你开始）：
- 1. 姓名：名字 / 姓氏（例：张 / 伟）
- 店铺名称：你的品牌名或店铺名（例：TrendyGoods Store）
- 目标市场：你主要卖给哪个国家/地区（例：United States / 美国）
- 注册邮箱：用来创建 SHOPLINE 账号的邮箱
- 公司名称（选填）：如有品牌/公司名可填，没有跳过
📌 说明：注册链接包含 UTM 归因参数（utmsource=openclaw），用于统计通过本 skill 完成注册的用户数量。这不影响你的注册流程和账号权益，SHOPLINE 不会因此向你收取额外费用。如不希望携带追踪参数，可直接访问 https://www.shopline.com/register 自行注册。
填好后我马上帮你注册 ✈️
收到用户信息后，进入注册流程。
二、注册流程（Step 1-6）
SHOPLINE 注册是一个多步骤 onboarding 表单，URL：
https://admin.myshopline.com/user/onboarding/6565889082504519950/en
| 步骤 | 页面内容 | 需要用户数据 | 可跳过 |
|---|
| Step 1 | 姓名 + 公司名 | ✅ First Name / Last Name / Company Name | ❌ 必填 |
| Step 2 |
身份选择 | 选「I am just starting」| ❌（自动选） |
| Step 3 | 销售方式 | 选「Online Store」| ❌（自动选） |
| Step 4 | 店铺名称 | ✅ Store name | ✅ 可 Skip |
| Step 5 | 销售地区 | ✅ 从下拉选用户的目标国家 | ❌ 必填 |
| Step 6 | 创建账号 | ✅ Email + Password（用户自填）| ❌ 必填 |
Step 1 — 姓名 + 公司名
执行步骤：
python
使用 openclaw profile（注册无需登录态）
browser(action=open, url=https://admin.myshopline.com/user/onboarding/6565889082504519950/en)
browser(action=snapshot) # 确认页面加载，看到 What is your full name 字样
批量填写姓名 + 公司名 + 点下一步（一次调用）
browser(action=act, request=[
{kind: type, ref:
, text: <用户名字>},
{kind: type, ref: , text: <用户姓氏>},
{kind: type, ref: , text: <公司名，无则填店铺名>},
{kind: click, ref: , delayMs: 200}
])
Step 2 — 身份选择
执行步骤：
python
browser(action=snapshot) # 确认到了 Which of these best describe you? 页面
批量：选身份 + 点下一步
browser(action=act, request=[
{kind: click, ref: },
{kind: click, ref: , delayMs: 200}
])
⚠️ 如果用户是搬迁用户，改选「I am currently selling online or in-person」
Step 3 — 销售方式
执行步骤：
python
browser(action=snapshot) # 确认到了 How would you like to sell on SHOPLINE? 页面
批量：选 Online Store + 点下一步
browser(action=act, request=[
{kind: click, ref: },
{kind: click, ref: , delayMs: 200}
])
Step 4 — 店铺名称
执行步骤：
python
browser(action=snapshot) # 确认到了 Give your store a name 页面
批量：填店铺名 + 点下一步
browser(action=act, request=[
{kind: type, ref: , text: <用户店铺名>},
{kind: click, ref: , delayMs: 200}
])
如用户未提供店铺名，点 Skip 跳过
Step 5 — 销售地区
执行步骤：
python
browser(action=snapshot) # 确认到了 Which country you are selling to? 页面
点开下拉
browser(action=act, request={kind: click, ref: })
browser(action=snapshot) # 查看国家列表
点选目标国家 + 点下一步
browser(action=act, request=[
{kind: click, ref: <目标国家选项 ref>},
{kind: click, ref: , delayMs: 300}
])
常用地区映射：美国 → United States，中国 → China，英国 → United Kingdom
Step 6 — 创建账号（🛑 AI 停止操作，用户在浏览器中自行完成）
执行步骤：
python
browser(action=snapshot) # 确认到了 Create Your SHOPLINE Account 页面
browser(action=act, request={kind: type, ref: , text: <用户提供的邮箱>})
browser(action=screenshot) # 截图展示当前状态
截图后告知用户：
🎯 最后一步到了！邮箱已经帮你填好了。
请你直接在刚才弹出的浏览器窗口里完成：
- 1. 在「Password」框里输入你的密码（8-20位，含大写/小写/数字/特殊字符）
- 在「Confirm Password」框里再次输入密码
- 勾选同意条款
- 点「SIGN UP」按钮
🔒 为什么要你自己输入？ 密码这种高敏感信息不应该通过聊天传递。请直接在浏览器里输入，这样密码不经过任何中间环节。
完成后告诉我「注册好了」，我继续帮你配置店铺 ✅
用户确认注册成功后，AI 继续：
python
browser(action=screenshot) # 截图确认已进入 SHOPLINE 后台
browser(action=snapshot) # 获取当前后台 URL 提取 store handle
注册完成 — 获取 store handle 并进入配置
执行步骤：
browser(action=sn
