云捷电商工具箱 · 插件开发包
=====================================

开发包版本：2.4.0
（= 整个开发包 SDK + 文档 + 技能参考 的版本，就写在 云捷SDK.js 开头；
  插件里可用 云捷.开发包版本 读到；每个版本改了什么见 SDK更新日志.md）

包里有什么（一个包全带，不需要再下别的）：

  云捷SDK.js              ← SDK：插件里 import './云捷SDK.js'（**不要自己手写 SDK**）
  SDK更新日志.md           ← 每个开发包版本改了什么、要不要升级
  组件/…                  ← 可复用组件库（如 组件/SKU搜索.js），放进插件目录后静态引入
  资源/…                  ← UI 资源（资源/vue.min.js、资源/element-ui/…；本地文件，**不要走 CDN**）
  .trae/skills/yunjie-plugin-dev/
                          ← **开发文档全在这里**（Trae 自动识别）：
                             SKILL.md 入口 + 参考/00 快速开始 ~ 11 平台能力与组件库
                             01 SDK速查 / 02 营销 / 03 商品 / 04 商机 / 05 售后 /
                             06 订单评价 / 07 数据存储 / 08 宿主能力 / 09 避坑 / 10 接口清单
  模板/…                  ← 三个能直接跑的模板（最小插件 / 列表操作插件 / 批量任务插件）

怎么开始（推荐：直接用 Trae 打开这个目录）
  1. 用 Trae 打开本目录 —— .trae/skills/ 里的「云捷插件开发」skill 会自动生效
  2. 对 Trae 说：「用云捷插件开发 skill，做一个 XXX 插件」
     （它会先读 SKILL.md，再按需只读需要的 1~2 份参考文档，不会一次吞几万字）
  3. 想更快跑通：把 模板/最小插件/ 里的 index.html、app.js 复制到本目录根，直接改
  4. 客户端「开发者中心 → 我的应用 → 版本 → 选择 / 更换目录」选中本目录 → 点「本地调试」

本目录就是你的工作目录
  - 直接把 index.html / app.js 写在包根即可（云捷SDK.js、资源/ 都是现成的）
  - 打包提交审核 / 本地调试会**自动跳过** .trae/、模板/ 与包自带的说明文件：
    不会把模板里的 index.html 当成你的入口，也不会把文档打进提交包

⚠️ 一个最容易踩的坑：不要写 `const 云捷 = window.云捷`
  `window.云捷` 是客户端注入的**不可配置全局属性**，重名声明会抛
  `Identifier '云捷' has already been declared`，**整段脚本都不执行**（页面白屏）。
  用 SDK：`import 云捷 from './云捷SDK.js'`。

更新开发包（整个包一起换，推荐）
  - 客户端「我的应用 → 版本 → **更新开发包（SDK + 文档）**」：
    把最新开发包**整包覆盖**进你的插件目录（云捷SDK.js、SDK更新日志、
    .trae/skills/ 全部开发文档、组件/、资源/、模板/ 一起换成同一版）。
  - 它**不会动**你自己写的 index.html / app.js。
  - 看每个开发包版本改了什么：「更新说明」，或看 SDK更新日志.md

提交上架
  客户端「我的应用 → 版本 → 打包提交审核」（自动压 zip 上传）→ 平台审核通过 → 上架应用市场。
  详细规则见 skill 参考 11-平台能力与组件库.md。
