@optima-chat/optima-agent 0.4.19 → 0.4.20

package/.claude/settings.local.json

@@ -61,7 +61,14 @@
       "Bash(commerce inventory:*)",
       "Bash(commerce merchant:*)",
       "Bash(commerce review:*)",
-      "Bash(commerce product-page:*)"
+      "Bash(commerce product-page:*)",
+      "Bash(bi-cli:*)",
+      "Bash(comfy:*)",
+      "Bash(scout search:*)",
+      "Bash(scout product:*)",
+      "Bash(commerce homepage create-collections:*)",
+      "Bash(commerce homepage create-featured:*)",
+      "Bash(commerce homepage create-collection-products:*)"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/homepage/SKILL.md

@@ -164,11 +164,12 @@ Homepage
 当用户说：
 - "查看首页配置" → `commerce homepage get-config`
 - "查看首页区块" → `commerce homepage list`
-- "添加轮播图区块" → `commerce homepage create --type banner --title "主 Banner"`
+- "添加轮播图" → `commerce homepage create-banner --title "主Banner" --images '[{"url":"..."}]'`
+- "添加集合入口" → `commerce homepage create-collections --title "精选系列" --slugs "a,b,c"`
+- "添加集合商品" → `commerce homepage create-collection-products --title "新品" --slug new-arrivals`
+- "添加特色推荐" → `commerce homepage create-featured --title "推荐" --target-type collection --target-handle xx --cta "查看" --image-url "..."`
 - "更新轮播图图片" → `commerce homepage update-images --id xx --images '[...]'`
-- "设置集合列表" → `commerce homepage update-collections --id xx --slugs "a,b,c"`
 - "调整区块顺序" → `commerce homepage reorder --moves '[{"section_id":"id1","new_position":0}]'`
-- "使用模板" → `commerce homepage switch-template --template-key minimal`
 - "删除区块" → `commerce homepage delete --id xx --yes`
 
 ## 命令参考
@@ -179,9 +180,14 @@ Homepage
 - `commerce homepage switch-template --template-key <key>` - 切换模板（minimal|standard）
 - `commerce homepage delete-config --yes` - 删除首页配置
 
-### 区块 CRUD
+### 创建区块（v1.12.0 新命令）
+- `commerce homepage create-banner --title <title> --images <json>` - 创建轮播图
+- `commerce homepage create-collections --title <title> --slugs <slugs>` - 创建集合入口
+- `commerce homepage create-collection-products --title <title> --slug <slug>` - 创建集合商品
+- `commerce homepage create-featured --title <title> --target-type <type> --target-handle <handle> --cta <text> --image-url <url>` - 创建特色推荐
+
+### 区块管理
 - `commerce homepage list` - 列出所有区块
-- `commerce homepage create --type <type> --title <title>` - 创建区块
 - `commerce homepage get --id <id>` - 查看区块详情
 - `commerce homepage update --id <id>` - 更新区块
 - `commerce homepage delete --id <id> --yes` - 删除区块
@@ -205,64 +211,63 @@ commerce homepage list-templates
 commerce homepage switch-template --template-key standard --yes
 ```
 
-### 配置轮播图
+### 创建轮播图
 
 ```bash
-# 1. 创建 banner 区块
-commerce homepage create --type banner --title "首页轮播"
+# 创建 banner 并设置图片（一步完成）
+commerce homepage create-banner \
+  --title "首页轮播" \
+  --images '[{"url":"https://cdn.../img1.jpg","link":"/sale"}]'
 
-# 2. 更新 banner 图片（需要先上传图片获取 URL）
+# 后续更新图片
 commerce homepage update-images \
   --id section_xxx \
-  --images '[{"url":"https://cdn.../img1.jpg","alt":"夏日促销","action_type":"collection","action_value":"summer-sale"}]'
+  --images '[{"url":"https://cdn.../img2.jpg","alt":"夏日促销","link":"/summer"}]'
 ```
 
-### 展示集合入口
+### 创建集合入口
 
 ```bash
-# 1. 先确保有集合（参考 collection skill）
-commerce collection list
-
-# 2. 创建 collections 区块
-commerce homepage create --type collections --title "精选系列"
-
-# 3. 设置要展示的集合（逗号分隔，无空格）
-commerce homepage update-collections \
-  --id section_xxx \
+# 创建 collections 区块（一步完成）
+commerce homepage create-collections \
+  --title "精选系列" \
   --slugs "new-arrivals,best-sellers,summer-sale"
-```
-
-### 展示某集合的商品
 
-```bash
-# 创建 collection_products 区块并配置
-commerce homepage create \
-  --type collection_products \
-  --title "新品上市" \
-  --settings '{"collection_slug":"new-arrivals","limit":8,"sort_by":"created_at","sort_order":"desc"}'
+# 后续更新集合列表
+commerce homepage update-collections --id section_xxx --slugs "a,b,c"
 ```
 
-### 特色推荐集合
+### 创建集合商品展示
 
 ```bash
-# 1. 创建 featured 区块
-commerce homepage create --type featured --title "本周推荐"
-
-# 2. 设置推荐目标为集合
-commerce homepage update-target \
-  --id section_xxx \
-  --type collection \
-  --handle "weekly-picks"
+# 创建 collection_products 区块
+commerce homepage create-collection-products \
+  --title "新品上市" \
+  --slug new-arrivals \
+  --limit 8
 ```
 
-### 特色推荐商品
+### 创建特色推荐
 
 ```bash
-# 设置推荐目标为某个商品
-commerce homepage update-target \
-  --id section_xxx \
-  --type product \
-  --handle "ceramic-cup-white"
+# 推荐集合
+commerce homepage create-featured \
+  --title "本周推荐" \
+  --target-type collection \
+  --target-handle weekly-picks \
+  --cta "立即查看" \
+  --image-url "https://cdn.../featured.jpg"
+
+# 推荐商品
+commerce homepage create-featured \
+  --title "爆款单品" \
+  --target-type product \
+  --target-handle ceramic-cup-white \
+  --cta "立即购买" \
+  --image-url "https://cdn.../product.jpg"
+
+# 后续更新目标
+commerce homepage update-target --id section_xxx --type collection --handle "new-picks"
 ```
 
 ## 注意事项

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.4.19",
+  "version": "0.4.20",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",