关于 salla-live-testing
面向 Salla 应用开发者的实测技能，指导在已安装的演示商店中验证应用，再决定是否完成发布。它覆盖设置、嵌入页面、店面片段和事件等商家可见行为，而非只依赖独立端点测试。
主要功能
- 01安装前核对已部署网址
- 02通过演示商店链接安装
- 03验证设置保存及持久化
- 04测试嵌入页面认证与加载
- 05检查店面渲染和真实事件送达
适用场景
- 01发布前验证 Salla 应用
- 02排查 OAuth 或 webhook 网址不匹配
- 03确认店面片段在主题中正常渲染
- 04验证 webhook 或 App Function 收到事件
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/salla-live-testing确认已加载。
详细介绍
Salla 实时测试
上线门槛：在真实演示商店中以商家的身份体验应用，然后再宣布完成。端点/MCP 测试通过并不能证明一切正常——面向商家的集成仍可能存在问题。
仅使用演示数据。 在演示商店中使用非敏感数据进行测试。不要将生产环境密钥、OAuth/访问令牌/刷新令牌、Webhook 签名密钥和真实客户个人身份信息泄露给第三方捕获/检查工具（请求接收端点、屏幕共享、聊天）。如果测试时将配置指向临时接收端，之后请恢复原来的
webhook_url、重定向 URL 和密钥。
步骤 0 — 将已配置的 URL 指向已部署的域名
安装前，获取已配置的 URL（salla_apps action=get）——webhook_url、OAuth 重定向/回调 URL、嵌入式页面 URL——并确认每个 URL 都指向应用实际运行的域名。这些 URL 必须一致：URL 不匹配时会静默失败（OAuth 无处重定向，Webhook 会在旧主机上返回 404，iframe 无法加载，且不会显示错误）。生成安装链接 之前，先使这些 URL 与部署保持一致。
步骤 1 — 在演示商店中安装
使用你的 app_id 调用 salla_apps action=demo_stores，然后从结果中选择一个商店。安装链接有时效限制（约 1 小时），因此请在测试前立即生成，并马上使用。如果安装似乎没有任何反应（链接过期时会静默失败或重定向到登录页），请重新运行 salla_apps action=demo_stores 获取新链接。
发布前，请始终使用
salla_apps action=demo_stores返回的install_url在演示商店中测试。 公共 App-Store 链接https://s.salla.sa/apps/install/{app_id}只有在应用发布之后才有效；它无法安装未发布的应用。不要手动拼接该链接进行测试——演示商店的install_url会在公司的演示商店中自动安装应用。
三个不同的 URL，三种用途：
| 字段 | 指向 | 用途 |
|---|---|---|
install_url | OAuth + 安装 | 触发安装流程（授权 → app.store.authorize） |
url | 店面 | 在商品/购物车页面测试代码片段（店面检查） |
dashboard_url | 商家管理后台 | 在管理后台测试嵌入式应用 + 设置（自动登录） |
connected: true 表示应用已安装；否则，请在浏览器中打开一个新生成的 install_url 进行安装。字段名称来自工具的契约定义——请根据实际响应确认当前返回的数据结构。
步骤 2 — 运行检查
| 界面 | 检查 | 事实来源 |
|---|---|---|
| 设置 | 打开应用的设置页面，更改一个值并保存，然后重新打开 — 确认值已保留。 | salla-app-settings（保存冒烟测试）；以及自动发送到应用 webhook_url 的 app.settings.updated webhook 负载（应用事件 — 无需订阅） |
| 嵌入式页面 | 在仪表板中打开嵌入式页面 — 确认它完成身份验证（SDK 令牌在服务端验证、会话建立后，页面才会渲染）、加载数据且不会卡住。测试令牌过期的情况 → 确认 SDK 刷新流程能够恢复。请在 salla-embedded-app 中核实准确的身份验证流程。 | salla-embedded-app |
| 店面 | 访问商品页面 — 确认代码片段以原生方式渲染（主题、图标、RTL），并截图。确认没有重复的小组件。在浏览器 DevTools Console 中确认代码片段确实运行（加载标记、无红色错误、事件负载）——参见 salla-snippets 的浏览器测试步骤。 | salla-snippets + salla-storefront-ui |
| 事件 | 触发真实事件（创建测试订单、更改库存、保存设置）— 确认 webhook 收到这些事件（并且签名/幂等性处理通过，参见 salla-webhooks）/应用函数触发。 | salla-webhooks / salla-app-functions |
| 日志 | 检查 Partner/Portal 日志以及浏览器控制台，查看上述操作期间是否有错误。确认控制台/日志中没有输出令牌或密钥。 | — |
步骤 3 — 什么才算证明
配置层面的成功不等于集成成功 — 请验证商家实际看到的行为：
- Portal 接受设置架构 → 确认已安装的表单可以保存（步骤 2）。
- 代码片段已执行 → 确认它以原生方式呈现且外观正确（参见
salla-storefront-ui）。 - 端点单独测试时返回 200 → 确认 Salla 使用真实负载调用它（步骤 2：事件）。
门槛：“在已安装应用的演示商店中：设置可以保存并保留、嵌入式页面完成身份验证并加载、店面代码片段以原生方式渲染，且真实事件到达 webhook/应用函数 — 所有这些都经过验证，并有截图/日志为证？”