@optima-chat/optima-agent 0.8.5 → 0.8.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -56,7 +56,8 @@ Homepage
|
|
|
56
56
|
**images 数组元素**：
|
|
57
57
|
| 字段 | 必填 | 说明 |
|
|
58
58
|
|------|------|------|
|
|
59
|
-
| url | ✓ |
|
|
59
|
+
| url | ✓ | 桌面端图片 URL |
|
|
60
|
+
| mobile_url | | 手机端专用图片 URL（3:4 竖向，可选） |
|
|
60
61
|
| alt | ✓ | 图片描述（SEO + 可访问性） |
|
|
61
62
|
| action_type | ✓ | 点击动作类型（见下方） |
|
|
62
63
|
| action_value | | 动作目标值 |
|
|
@@ -74,7 +75,7 @@ Homepage
|
|
|
74
75
|
```json
|
|
75
76
|
{
|
|
76
77
|
"images": [
|
|
77
|
-
{"url": "https://cdn.../summer.jpg", "alt": "夏日促销", "action_type": "collection", "action_value": "summer-sale"},
|
|
78
|
+
{"url": "https://cdn.../summer.jpg", "mobile_url": "https://cdn.../summer-mobile.jpg", "alt": "夏日促销", "action_type": "collection", "action_value": "summer-sale"},
|
|
78
79
|
{"url": "https://cdn.../promo.jpg", "alt": "活动页面", "action_type": "url", "action_value": "https://promo.example.com/event"},
|
|
79
80
|
{"url": "https://cdn.../hero.jpg", "alt": "品牌形象", "action_type": "none", "action_value": null}
|
|
80
81
|
],
|
|
@@ -320,5 +321,6 @@ commerce i18n homepage set \
|
|
|
320
321
|
- **区块顺序**：使用 `reorder` 调整，position 从 0 开始
|
|
321
322
|
- **模板切换**：会创建新区块并停用旧区块，谨慎操作
|
|
322
323
|
- **图片格式**：banner images 需要完整的 JSON 数组，每个元素必须有 url 和 alt
|
|
324
|
+
- **手机端图片**：可选提供 mobile_url（3:4 竖向），有 mobile_url 时手机端显示竖向大图，无则保持 16:9 横向
|
|
323
325
|
- **集合引用**：确保引用的 collection slug 存在，否则前端可能显示空
|
|
324
326
|
- **删除确认**：删除操作需要 `--yes` 参数
|
|
@@ -17,7 +17,7 @@ commerce upload image --path ./tshirt-main.jpg # 获得 media_123
|
|
|
17
17
|
|
|
18
18
|
# 2. 创建商品
|
|
19
19
|
commerce product create \
|
|
20
|
-
--
|
|
20
|
+
--name "纯棉T恤" \
|
|
21
21
|
--price 99 \
|
|
22
22
|
--stock 20 \
|
|
23
23
|
--description "100% 纯棉，舒适透气" \
|
|
@@ -28,7 +28,7 @@ commerce product create \
|
|
|
28
28
|
**流程**: 创建主商品 → 创建所有变体 → 关联图片
|
|
29
29
|
```bash
|
|
30
30
|
# 1. 创建主商品
|
|
31
|
-
commerce product create --
|
|
31
|
+
commerce product create --name "T恤" --price 99
|
|
32
32
|
# 获得 product_id: prod_123
|
|
33
33
|
|
|
34
34
|
# 2. 创建所有变体
|
|
@@ -48,7 +48,7 @@ commerce upload image --path ./brand-logo.jpg # 获得 media_shared
|
|
|
48
48
|
|
|
49
49
|
# 2. 批量创建商品（复用media_id）
|
|
50
50
|
for product in "T恤" "衬衫" "卫衣"; do
|
|
51
|
-
commerce product create --
|
|
51
|
+
commerce product create --name "$product" --price 99 --media-id media_shared
|
|
52
52
|
done
|
|
53
53
|
```
|
|
54
54
|
|
|
@@ -78,7 +78,7 @@ commerce product add-images --id prod_123 --media-id media_new
|
|
|
78
78
|
```bash
|
|
79
79
|
# 创建促销商品：售价79，原价99（显示划线价）
|
|
80
80
|
commerce product create \
|
|
81
|
-
--
|
|
81
|
+
--name "夏日特惠T恤" \
|
|
82
82
|
--price 79 \
|
|
83
83
|
--original-price 99 \
|
|
84
84
|
--stock 100 \
|
|
@@ -143,7 +143,7 @@ commerce product create \
|
|
|
143
143
|
# 每个商品都上传相同的logo
|
|
144
144
|
for product in products; do
|
|
145
145
|
commerce upload image --path ./logo.jpg
|
|
146
|
-
commerce product create --
|
|
146
|
+
commerce product create --name "$product" --media-id $NEW_ID
|
|
147
147
|
done
|
|
148
148
|
```
|
|
149
149
|
|
|
@@ -152,7 +152,7 @@ done
|
|
|
152
152
|
# 先上传一次，复用media_id
|
|
153
153
|
commerce upload image --path ./logo.jpg # 获得 media_123
|
|
154
154
|
for product in products; do
|
|
155
|
-
commerce product create --
|
|
155
|
+
commerce product create --name "$product" --media-id media_123
|
|
156
156
|
done
|
|
157
157
|
```
|
|
158
158
|
|
|
@@ -162,10 +162,10 @@ done
|
|
|
162
162
|
|
|
163
163
|
```bash
|
|
164
164
|
# 错误：只创建主商品
|
|
165
|
-
commerce product create --
|
|
165
|
+
commerce product create --name "T恤" --price 99
|
|
166
166
|
|
|
167
167
|
# 正确：创建主商品 + 所有变体
|
|
168
|
-
commerce product create --
|
|
168
|
+
commerce product create --name "T恤" --price 99 # 获得 prod_123
|
|
169
169
|
commerce variant create --product-id prod_123 --sku "TSHIRT-RED-S" ...
|
|
170
170
|
commerce variant create --product-id prod_123 --sku "TSHIRT-RED-M" ...
|
|
171
171
|
```
|
|
@@ -203,7 +203,7 @@ commerce product update --id prod_123 --tags "featured,new,sale"
|
|
|
203
203
|
|
|
204
204
|
```bash
|
|
205
205
|
# 先确认真实库存，再创建
|
|
206
|
-
commerce product create --
|
|
206
|
+
commerce product create --name "T恤" --price 99 --stock 50 # 确保真实有50件
|
|
207
207
|
```
|
|
208
208
|
|
|
209
209
|
## 命令参考
|
|
@@ -211,9 +211,9 @@ commerce product create --title "T恤" --price 99 --stock 50 # 确保真实有5
|
|
|
211
211
|
### 自然语言映射
|
|
212
212
|
|
|
213
213
|
当用户说：
|
|
214
|
-
- "创建XX商品，价格YY" → `commerce product create --
|
|
215
|
-
- "创建XX商品，售价YY，原价ZZ" → `commerce product create --
|
|
216
|
-
- "创建促销商品，价格79，划线价99" → `commerce product create --
|
|
214
|
+
- "创建XX商品，价格YY" → `commerce product create --name XX --price YY`
|
|
215
|
+
- "创建XX商品，售价YY，原价ZZ" → `commerce product create --name XX --price YY --original-price ZZ`
|
|
216
|
+
- "创建促销商品，价格79，划线价99" → `commerce product create --name XX --price 79 --original-price 99`
|
|
217
217
|
- "上传商品图片" → `commerce upload image --path ./photo.jpg`
|
|
218
218
|
- "添加商品变体" → `commerce variant create --product-id XX --sku YY`
|
|
219
219
|
- "更新商品价格" → `commerce product update --id XX --price YY`
|
|
@@ -249,7 +249,7 @@ commerce product create --title "T恤" --price 99 --stock 50 # 确保真实有5
|
|
|
249
249
|
# 用户说："创建T恤商品，99美元，库存20"
|
|
250
250
|
# 描述支持 Markdown 格式
|
|
251
251
|
commerce product create \
|
|
252
|
-
--
|
|
252
|
+
--name "T恤" \
|
|
253
253
|
--price 99 \
|
|
254
254
|
--stock 20 \
|
|
255
255
|
--description "## 产品特点
|
|
@@ -314,7 +314,7 @@ commerce upload image --path ./tshirt-red.jpg # media_red
|
|
|
314
314
|
commerce upload image --path ./tshirt-blue.jpg # media_blue
|
|
315
315
|
|
|
316
316
|
# 2. 创建主商品
|
|
317
|
-
commerce product create --
|
|
317
|
+
commerce product create --name "纯棉T恤" --price 99
|
|
318
318
|
# 获得 product_id: prod_123
|
|
319
319
|
|
|
320
320
|
# 3. 创建变体
|