@optima-chat/commerce-cli 1.10.0 → 1.10.1

package/.claude/skills/commerce-i18n/SKILL.md

@@ -322,12 +322,17 @@ commerce i18n variant create --variant-id var_2 --lang ja-JP \
 ### 自然语言映射
 
 当用户说：
+- "查看支持的语言" → `commerce i18n languages`
 - "给商品添加中文翻译" → `commerce i18n product create --product-id XX --lang zh-CN`
 - "翻译商品变体" → `commerce i18n variant create --variant-id XX --lang YY`
 - "翻译集合信息" → `commerce i18n collection create --collection-id XX --lang YY`
 - "设置商户多语言信息" → `commerce i18n merchant create --lang XX`
 - "翻译首页区块" → `commerce i18n homepage set --section-id XX --lang YY`
 
+### 语言管理
+
+- `commerce i18n languages` - 查看支持的语言代码
+
 ### 商品翻译
 
 - `commerce i18n product create` - 创建商品翻译
@@ -339,14 +344,16 @@ commerce i18n variant create --variant-id var_2 --lang ja-JP \
 ### 变体翻译
 
 - `commerce i18n variant create` - 创建变体翻译
-- `commerce i18n variant list` - 查看变体翻译
+- `commerce i18n variant list` - 查看变体翻译列表
+- `commerce i18n variant get` - 查看单个变体翻译
 - `commerce i18n variant update` - 更新变体翻译
 - `commerce i18n variant delete` - 删除变体翻译
 
 ### 集合翻译
 
 - `commerce i18n collection create` - 创建集合翻译
-- `commerce i18n collection list` - 查看集合翻译
+- `commerce i18n collection list` - 查看集合翻译列表
+- `commerce i18n collection get` - 查看单个集合翻译
 - `commerce i18n collection update` - 更新集合翻译
 - `commerce i18n collection delete` - 删除集合翻译
 

package/.claude/skills/commerce-inventory/SKILL.md

@@ -15,8 +15,7 @@ description: Inventory management and stock monitoring. Track stock levels, upda
 |---------|---------|-----------|
 | 查看低库存 | `inventory low-stock --threshold 10` | 阈值根据品类和销售速度设定 |
 | 补货操作 | `inventory update --quantity XX --reason` | 必须填写原因，便于追踪 |
-| 预留库存 | `inventory reserve --order-id XX` | 订单创建时立即预留，避免超卖 |
-| 释放预留 | `inventory release --order-id XX` | 订单取消或支付超时时释放 |
+| 预留库存 | `inventory reserve --product-id XX --quantity YY` | 订单创建时立即预留，避免超卖 |
 | 查看历史 | `inventory history --product-id XX` | 分析库存变化趋势，优化补货策略 |
 | 盘点调整 | `inventory update --reason "盘点调整"` | 账实不符时手动调整，记录差异原因 |
 
@@ -226,20 +225,16 @@ commerce inventory update \
 - "商品XX补货50个" → `commerce inventory update --id XX --quantity 50 --reason "补货"`
 - "预留库存" → `commerce inventory reserve --product-id XX --quantity YY`
 - "查看库存历史" → `commerce inventory history --product-id XX`
-- "查看所有商品库存" → `commerce inventory list`
 
 ### 核心功能
 
 **库存查询**:
-- `commerce inventory list` - 查看所有商品库存
-- `commerce inventory get` - 查看单个商品库存
 - `commerce inventory low-stock` - 查看低库存商品
 - `commerce inventory history` - 查看库存变更历史
 
 **库存更新**:
 - `commerce inventory update` - 更新库存数量
 - `commerce inventory reserve` - 预留库存
-- `commerce inventory release` - 释放预留库存
 
 ## 详细示例
 
@@ -275,12 +270,6 @@ commerce inventory history \
   --limit 20
 ```
 
-### 批量查看库存
-```bash
-# 用户说："查看所有商品的库存情况"
-commerce inventory list --limit 100
-```
-
 ## 重要提示
 
 - 库存变更会自动记录历史

package/.claude/skills/commerce-order/SKILL.md

@@ -24,23 +24,23 @@ description: Order fulfillment and shipping management. Process orders, ship pac
 | 查看待发货订单 | `order list --status paid` | 按付款时间升序，优先处理早期订单 |
 | 批量发货 | 循环 `order ship` | 必须有真实tracking号，避免虚假发货 |
 | 取消订单 | `order cancel --yes` | 检查是否已发货，避免错误取消 |
-| 处理退款 | `refund create` → `refund approve` | 先创建后审批，保留审计记录 |
+| 处理退款 | `refund create` | 创建退款请求 |
 | 运费查询 | `shipping calculate` | 提供准确重量和邮编，避免运费纠纷 |
-| 物流异常 | `shipping track` → `shipping update-status` | 主动更新状态，及时通知客户 |
+| 物流状态更新 | `order update-shipping-status` | 手动更新物流状态，及时通知客户 |
+| 查看物流历史 | `order shipping-history` | 查看订单物流状态变更记录 |
 
 ### 标准订单履行流程
 1. **查看待发货** - `commerce order list --status paid` 按时间升序
 2. **验证订单** - 检查库存、地址、特殊要求
 3. **批量打包** - 准备商品、包装材料、打印面单
 4. **标记发货** - 循环 `commerce order ship --id XX --tracking YY --carrier ZZ`
-5. **物流跟踪** - 定期 `commerce shipping track` 监控异常
+5. **更新物流** - `commerce order update-shipping-status` 更新物流状态
 6. **确认送达** - 签收后 `commerce order mark-delivered --id XX`
 
 ### 退款处理流程
-1. **创建退款** - `commerce refund create` 填写详细原因
-2. **审核评估** - 检查商品状态、退货凭证、历史记录
-3. **批准/拒绝** - `commerce refund approve/reject` 并通知客户
-4. **跟踪反馈** - 记录退款原因，优化产品和服务
+1. **创建退款** - `commerce refund create --order-id XX --amount YY --reason "原因"`
+2. **查看详情** - `commerce refund get --id XX` 查看退款状态
+3. **跟踪反馈** - 记录退款原因，优化产品和服务
 
 ## 卓越标准
 
@@ -116,21 +116,21 @@ commerce order ship --id order_789 --tracking DHL123458 --carrier DHL
 - `commerce order list` - 查看订单列表
 - `commerce order get` - 查看订单详情
 - `commerce order ship` - 标记订单发货
-- `commerce order cancel` - 取消订单
-- `commerce order complete` - 完成订单
+- `commerce order update-shipping-status` - 更新物流状态（手动物流）
 - `commerce order mark-delivered` - 标记已送达
+- `commerce order complete` - 完成订单
+- `commerce order cancel` - 取消订单
+- `commerce order shipping-history` - 查看物流状态历史
 
 ### 退款管理
 - `commerce refund create` - 创建退款
-- `commerce refund list` - 查看退款列表
 - `commerce refund get` - 查看退款详情
-- `commerce refund approve` - 批准退款
-- `commerce refund reject` - 拒绝退款
 
-### 物流管理
+### 运费管理
 - `commerce shipping calculate` - 计算运费
-- `commerce shipping track` - 物流追踪
-- `commerce shipping update-status` - 更新物流状态
+- `commerce shipping get-mode` - 查看运费模式配置
+- `commerce shipping update-mode` - 更新运费模式配置
+- `commerce shipping countries` - 查看支持的运送国家
 
 ## 详细示例
 
@@ -181,21 +181,30 @@ commerce refund create \
   --amount 150 \
   --reason "商品有瑕疵"
 
-# 批准退款
-commerce refund approve --id refund_456
+# 查看退款详情
+commerce refund get --id refund_456
 ```
 
-### 物流追踪
+### 查看物流历史
 ```bash
-# 用户说："查询快递单号DHL123456的物流信息"
-commerce shipping track --tracking-number DHL123456
+# 用户说："查看订单order_123的物流状态历史"
+commerce order shipping-history --id order_123
+```
+
+### 更新物流状态
+```bash
+# 用户说："更新订单order_123的物流状态为已发货"
+commerce order update-shipping-status \
+  --id order_123 \
+  --status shipped \
+  --note "已从仓库发出"
 ```
 
 ## 重要提示
 
 - 订单状态流转：pending → paid → shipped → delivered → completed
-- 取消和删除操作需要 `--yes` 确认
+- 取消操作需要 `--yes` 确认
 - 发货后订单状态自动变为 shipped
-- 退款需要先创建，然后批准才会实际退款
-- 支持的物流商：DHL, FedEx, UPS, USPS, SF Express, 顺丰
+- 退款使用 `refund create` 创建，使用 `refund get` 查看状态
+- 物流状态更新使用 `order update-shipping-status`（手动物流模式）
 - 使用 `--help` 查看命令详细参数

package/.claude/skills/commerce-product/SKILL.md

@@ -205,12 +205,16 @@ commerce product create --title "T恤" --price 99 --stock 50  # 确保真实有5
 当用户说：
 - "创建XX商品，价格YY" → `commerce product create --title XX --price YY`
 - "上传商品图片" → `commerce upload image --path ./photo.jpg`
+- "上传商品视频" → `commerce upload video --path ./video.mp4`
 - "添加商品变体" → 先 `commerce product get --id XX` 查看现有 attributes keys，再 `commerce variant create`
+- "搜索红色变体" → `commerce variant search --color 红色`
 - "更新商品价格" → `commerce product update --id XX --price YY`
 - "给商品打标签" → `commerce product update --id XX --tags "featured,new"`
 - "查看所有商品" → `commerce product list`
+- "获取商品链接" → `commerce product url --id XX`
 - "商品图片地址是 https://..." → `commerce product add-images --id XX --url "https://..."`
 - "变体图片地址是 https://..." → `commerce variant add-images --product-id XX --variant-id YY --url "https://..."`
+- "调整图片顺序" → `commerce product reorder-images --id XX --media-ids media1,media2`
 - "添加商品视频" / "视频URL是..." → `commerce product add-videos --id XX --url "https://..."`
 - "查看视频状态" → `commerce product video-status --media-id XX`
 - "用这个URL添加图片" → 根据上下文选择 `product add-images --url` 或 `variant add-images --url`
@@ -223,24 +227,31 @@ commerce product create --title "T恤" --price 99 --stock 50  # 确保真实有5
 - `commerce product get` - 查看商品详情
 - `commerce product update` - 更新商品信息
 - `commerce product delete` - 删除商品
+- `commerce product url` - 获取商品公开链接
 
 **变体/SKU 管理**:
 - `commerce variant create` - 创建商品变体
 - `commerce variant list` - 查看变体列表
+- `commerce variant search` - 按属性搜索变体（颜色、尺寸）
 - `commerce variant update` - 更新变体信息
 - `commerce variant delete` - 删除变体
+- `commerce variant add-images` - 添加变体图片
 
 **图片管理**:
 - `commerce upload image` - 上传本地图片文件
 - `commerce product add-images` - 添加商品图片（支持 `--url`/`--media-id`/`--path`）
-- `commerce variant add-images` - 添加变体图片（支持 `--url`/`--media-id`/`--path`）
 - `commerce product remove-images` - 移除商品图片
+- `commerce product reorder-images` - 重排商品图片顺序
 
 **视频管理**:
+- `commerce upload video` - 上传本地视频文件
 - `commerce product add-videos` - 添加商品视频（支持 `--url`/`--media-id`）
 - `commerce product remove-videos` - 移除商品视频
 - `commerce product reorder-videos` - 重排商品视频顺序
-- `commerce product video-status` - 查看视频转码状态（480p/720p/1080p）
+- `commerce product video-status` - 查看视频转码状态
+
+**文件上传**:
+- `commerce upload file` - 上传文档（PDF、目录、手册等）
 
 ## 详细示例
 

package/.claude/skills/commerce-storefront/SKILL.md

@@ -13,11 +13,12 @@ description: Storefront and product page configuration. Manage homepage sections
 
 | 用户需求 | 推荐命令 | 关键注意点 |
 |---------|---------|-----------|
-| 创建轮播图 | `commerce homepage module create --type banner` | 图片尺寸1920x600px，≤5张，配置跳转链接 |
-| 显示精选商品 | `commerce homepage module create --type featured` | 选择高转化商品，数量8-12个 |
-| 创建促销集合 | `collection create --slug sale` | slug 简短有意义，添加10-30个商品 |
-| 调整模块顺序 | `homepage module reorder --position X` | 重要模块靠前（轮播图position=1） |
-| 更新店铺信息 | `merchant update --name/description` | 名称简洁，描述突出差异化优势 |
+| 创建轮播图 | `commerce homepage create --type banner` | 图片尺寸1920x600px，≤5张，配置跳转链接 |
+| 显示精选商品 | `commerce homepage create --type featured` | 选择高转化商品，数量8-12个 |
+| 创建促销集合 | `commerce collection create --slug sale` | slug 简短有意义，添加10-30个商品 |
+| 设置集合封面 | `commerce collection set-cover --id XX` | 支持 --url、--path、--media-id 三种方式 |
+| 调整区块顺序 | `commerce homepage reorder --moves '[...]'` | 重要区块靠前（position=0） |
+| 更新店铺信息 | `commerce merchant update` | 名称简洁，描述突出差异化优势 |
 
 ### 场景 1：首页配置
 
@@ -29,12 +30,12 @@ description: Storefront and product page configuration. Manage homepage sections
 5. **品牌故事** (position=5) - 建立信任和品牌认知
 
 **标准流程**：
-1. **规划布局** - 确定首页模块顺序（轮播图 → 分类 → 精选商品 → 集合）
-2. **创建模块** - 依次 `commerce homepage module create` 创建各模块
-3. **配置顺序** - 使用 position 1, 2, 3... 排序
-4. **设置参数** - `commerce homepage settings update` 配置搜索、精选数量
-5. **验证效果** - `commerce homepage module list` 检查配置
-6. **定期优化** - 根据数据调整模块顺序和内容
+1. **规划布局** - 确定首页区块顺序（轮播图 → 分类 → 精选商品 → 集合）
+2. **创建区块** - 依次 `commerce homepage create` 创建各区块
+3. **配置顺序** - 使用 `commerce homepage reorder` 调整顺序
+4. **更新设置** - `commerce homepage patch-settings` 配置区块参数
+5. **验证效果** - `commerce homepage list` 检查配置
+6. **定期优化** - 根据数据调整区块顺序和内容
 
 ### 场景 2：创建轮播图
 
@@ -47,11 +48,10 @@ description: Storefront and product page configuration. Manage homepage sections
 
 ```bash
 # 图片 URL 直接使用，后端自动下载处理
-commerce homepage module create \
-  --slug hero-banner \
+commerce homepage create \
   --type banner \
-  --position 1 \
-  --config '{"images":[{"url":"https://example.com/banner.jpg","link":"/collections/summer-sale"}]}'
+  --title "主 Banner" \
+  --settings '{"images":[{"url":"https://example.com/banner.jpg","link":"/collections/summer-sale"}]}'
 ```
 
 ### 场景 3：创建商品集合
@@ -86,10 +86,8 @@ commerce collection add-products \
 - 定期根据数据优化
 
 ```bash
-# 调整精选商品模块到第2位
-commerce homepage module reorder \
-  --module-id module_123 \
-  --position 2
+# 调整精选商品区块到第2位（0-indexed）
+commerce homepage reorder --moves '[{"section_id":"section-123","new_position":1}]'
 ```
 
 ### 场景 5：优化转化率
@@ -173,13 +171,13 @@ commerce collection create --name "New Arrivals" --slug "new-arrivals"
 **错误做法**：
 ```bash
 # 创建10张轮播图，导致首页加载缓慢
-commerce homepage module create --type banner --config '{"images":[...10张图片...]}'
+commerce homepage create --type banner --title "Banner" --settings '{"images":[...10张图片...]}'
 ```
 
 **✅ 正确做法**：
 ```bash
 # 限制≤5张，压缩图片，启用懒加载
-commerce homepage module create --type banner --config '{"images":[...3-5张图片...]}'
+commerce homepage create --type banner --title "Banner" --settings '{"images":[...3-5张图片...]}'
 ```
 
 ### ❌ 问题 3：精选商品数量过多
@@ -187,13 +185,13 @@ commerce homepage module create --type banner --config '{"images":[...3-5张图
 **错误做法**：
 ```bash
 # 显示30个精选商品，影响用户决策
-commerce homepage settings update --featured-limit 30
+commerce homepage patch-settings --id section-123 --settings '{"limit":30}'
 ```
 
 **✅ 正确做法**：
 ```bash
 # 限制8-12个，选择高转化商品
-commerce homepage settings update --featured-limit 10
+commerce homepage patch-settings --id section-123 --settings '{"limit":10}'
 ```
 
 ### ❌ 问题 4：集合缺少商品
@@ -212,22 +210,23 @@ commerce collection create --name "New Arrivals" --slug "new-arrivals"
 commerce collection add-products --slug new-arrivals --product-ids prod_1,prod_2,prod_3,prod_4,prod_5
 ```
 
-### ❌ 问题 5：首页模块顺序混乱
+### ❌ 问题 5：首页区块顺序混乱
 
 **错误做法**：
 ```bash
-# position 随意设置，导致布局混乱
-commerce homepage module create --type banner --position 10
-commerce homepage module create --type featured --position 2
-commerce homepage module create --type categories --position 50
+# 创建后不调整顺序，导致布局混乱
+commerce homepage create --type featured --title "精选"
+commerce homepage create --type banner --title "Banner"  # Banner 应该在最前面
 ```
 
 **✅ 正确做法**：
 ```bash
-# 按重要性依次设置 position 1, 2, 3...
-commerce homepage module create --type banner --position 1
-commerce homepage module create --type categories --position 2
-commerce homepage module create --type featured --position 3
+# 先创建，再用 reorder 调整顺序
+commerce homepage create --type banner --title "主 Banner"
+commerce homepage create --type collections --title "分类导航"
+commerce homepage create --type featured --title "精选商品"
+# 确保 Banner 在最前面
+commerce homepage reorder --moves '[{"section_id":"banner-id","new_position":0}]'
 ```
 
 ### ❌ 问题 6：slug 使用中文或特殊字符
@@ -251,60 +250,74 @@ commerce collection create --name "Sale!!!" --slug "sale"
 ### 自然语言映射
 
 当用户说：
-- "创建首页轮播图" → `commerce homepage module create --type banner ...`
-- "更新首页设置" → `commerce homepage settings update --show-search true`
+- "创建首页轮播图" → `commerce homepage create --type banner --title "Banner"`
+- "查看首页配置" → `commerce homepage get-config`
+- "查看首页区块列表" → `commerce homepage list`
 - "创建商品集合" → `commerce collection create --name XX --slug YY`
+- "查看集合详情" → `commerce collection get --id XX`
 - "把商品添加到集合" → `commerce collection add-products --id XX --product-ids YY`
+- "查看集合内商品" → `commerce collection list-products --id XX`
 - "更新店铺信息" → `commerce merchant update --name XX`
+- "查看店铺链接" → `commerce merchant url`
 - "Banner 图片地址是 https://..." → `commerce homepage update-images --id XX --images '[{"url":"https://...","alt":"..."}]'`
 - "Featured 图片地址是 https://..." → `commerce homepage patch-settings --id XX --settings '{"url":"https://..."}'`
-- "集合封面图 URL 是 https://..." → `commerce collection update --id XX --image-url "https://..."`
+- "设置集合封面" / "修改集合封面图" → `commerce collection set-cover --id XX --url/--path/--media-id`
+- "集合封面图 URL 是 https://..." → `commerce collection set-cover --id XX --url "https://..."`
+- "上传本地图片作为集合封面" → `commerce collection set-cover --id XX --path ./cover.jpg`
 
 ### 核心功能
 
-**首页模块管理**:
-- `commerce homepage module create` - 创建首页模块
-- `commerce homepage module list` - 查看所有模块
-- `commerce homepage module update` - 更新模块
-- `commerce homepage module delete` - 删除模块
-- `commerce homepage module reorder` - 重新排序
-
-**首页设置**:
-- `commerce homepage settings get` - 查看首页设置
-- `commerce homepage settings update` - 更新首页设置
+**首页配置**:
+- `commerce homepage get-config` - 查看当前首页配置
+- `commerce homepage list` - 查看所有首页区块
+- `commerce homepage create` - 创建首页区块
+- `commerce homepage get` - 查看单个区块详情
+- `commerce homepage update` - 更新区块
+- `commerce homepage delete` - 删除区块
+- `commerce homepage reorder` - 重新排序区块
+- `commerce homepage update-images` - 更新 Banner 图片
+- `commerce homepage update-collections` - 更新集合区块
+- `commerce homepage update-target` - 更新 Featured 区块目标
+- `commerce homepage patch-settings` - 更新区块设置
+
+**首页模板**:
+- `commerce homepage list-templates` - 查看可用模板
+- `commerce homepage switch-template` - 切换首页模板
 
 **商品集合**:
 - `commerce collection create` - 创建集合
 - `commerce collection list` - 查看集合列表
+- `commerce collection get` - 查看集合详情
 - `commerce collection update` - 更新集合
 - `commerce collection delete` - 删除集合
+- `commerce collection set-cover` - 设置集合封面图
 - `commerce collection add-products` - 添加商品到集合
 - `commerce collection remove-products` - 从集合移除商品
+- `commerce collection list-products` - 查看集合内商品
 
 **商户信息**:
 - `commerce merchant info` - 查看商户信息
 - `commerce merchant update` - 更新商户信息
-- `commerce merchant init` - 初始化商户设置
+- `commerce merchant setup` - 初始化商户设置
+- `commerce merchant url` - 获取店铺公开链接
 
 ## 详细示例
 
 ### 创建首页轮播图
 ```bash
-# 用户说："创建首页轮播图模块"
-commerce homepage module create \
-  --slug hero-banner \
+# 用户说："创建首页轮播图"
+commerce homepage create \
   --type banner \
-  --position 1 \
-  --enabled true \
-  --config '{"images":[{"url":"https://example.com/banner1.jpg"}]}'
+  --title "主 Banner" \
+  --settings '{"images":[{"url":"https://example.com/banner1.jpg"}]}'
 ```
 
-### 更新首页设置
+### 更新区块设置
 ```bash
-# 用户说："启用首页搜索功能，显示8个精选商品"
-commerce homepage settings update \
-  --show-search true \
-  --featured-limit 8
+# 用户说："更新精选商品数量为8个"
+commerce homepage patch-settings \
+  --id section-123 \
+  --settings '{"limit":8}'
 ```
 
 ### 创建商品集合
@@ -324,6 +337,19 @@ commerce collection add-products \
   --product-ids prod_123,prod_456
 ```
 
+### 设置集合封面图
+```bash
+# 方式 1：使用 Media ID（推荐，可复用已上传图片）
+commerce upload image --path ./cover.jpg  # 获取 media_id
+commerce collection set-cover --id coll-123 --media-id media_456
+
+# 方式 2：使用图片 URL
+commerce collection set-cover --id coll-123 --url "https://example.com/cover.jpg"
+
+# 方式 3：上传本地文件
+commerce collection set-cover --id coll-123 --path ./cover.jpg
+```
+
 ### 更新商户信息
 ```bash
 # 用户说："更新店铺名称和描述"
@@ -332,44 +358,37 @@ commerce merchant update \
   --description "Premium fashion for everyone"
 ```
 
-### 重新排序首页模块
+### 重新排序首页区块
 ```bash
-# 用户说："调整首页模块顺序"
-commerce homepage module reorder \
-  --module-id module_123 \
-  --position 2
+# 用户说："调整首页区块顺序"
+commerce homepage reorder --moves '[{"section_id":"section-123","new_position":1}]'
 ```
 
 ### 完整首页配置示例
 ```bash
-# 1. 创建轮播图模块
-commerce homepage module create \
-  --slug hero-banner \
+# 1. 创建轮播图区块
+commerce homepage create \
   --type banner \
-  --position 1 \
-  --config '{"images":[{"url":"https://example.com/banner1.jpg","link":"/collections/summer-sale"},{"url":"https://example.com/banner2.jpg","link":"/collections/new-arrivals"}]}'
-
-# 2. 创建分类导航模块
-commerce homepage module create \
-  --slug category-nav \
-  --type categories \
-  --position 2 \
-  --config '{"columns":4}'
-
-# 3. 创建精选商品模块
-commerce homepage module create \
-  --slug featured-products \
+  --title "主 Banner" \
+  --settings '{"images":[{"url":"https://example.com/banner1.jpg","link":"/collections/summer-sale"},{"url":"https://example.com/banner2.jpg","link":"/collections/new-arrivals"}]}'
+
+# 2. 创建集合区块
+commerce homepage create \
+  --type collections \
+  --title "精选集合"
+
+# 3. 创建精选商品区块
+commerce homepage create \
   --type featured \
-  --position 3 \
-  --config '{"limit":10}'
+  --title "精选商品" \
+  --settings '{"limit":10}'
 
-# 4. 更新首页设置
-commerce homepage settings update \
-  --show-search true \
-  --featured-limit 10
+# 4. 调整区块顺序（确保 Banner 在最前面）
+commerce homepage list  # 先查看区块 ID
+commerce homepage reorder --moves '[{"section_id":"banner-section-id","new_position":0}]'
 
 # 5. 验证配置
-commerce homepage module list
+commerce homepage list
 ```
 
 ## 场景 7：商品详情页内容区块管理
@@ -550,10 +569,10 @@ commerce product-page list --resolved
 ## 重要提示
 
 ### 首页配置
-- 首页模块支持类型：banner（轮播图）、featured（精选商品）、categories（分类）
+- 首页区块类型：banner（轮播图）、collections（集合列表）、collection_products（集合商品）、featured（精选商品）
 - 集合 slug 必须唯一，用于 URL
-- 模块的 position 决定显示顺序（从小到大）
-- config 字段使用 JSON 格式
+- 使用 `homepage reorder` 调整区块顺序
+- settings 字段使用 JSON 格式
 - 集合可以手动管理商品，也可以设置自动规则
 - **图片 URL 直接用**：Banner、Featured、集合封面等图片参数支持直接传 URL，后端自动下载处理
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/commerce-cli",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "用自然语言管理电商店铺 - 专为 Claude Code 设计的对话式 CLI 工具，支持多环境和功能测试",
   "main": "dist/index.js",
   "type": "module",