@optima-chat/optima-agent 0.4.18 → 0.4.19

package/.claude/settings.local.json

@@ -48,7 +48,20 @@
       "Bash(commerce collection list --help:*)",
       "Bash(commerce collection create --help:*)",
       "Bash(commerce collection remove-products:*)",
-      "Bash(commerce collection list-products:*)"
+      "Bash(commerce collection list-products:*)",
+      "Bash(commerce --version:*)",
+      "Bash(bi-cli --version:*)",
+      "Bash(commerce homepage create --help:*)",
+      "Bash(commerce homepage reorder --help:*)",
+      "Bash(commerce homepage delete --help:*)",
+      "Bash(commerce homepage update-images:*)",
+      "Bash(commerce homepage update-collections:*)",
+      "Bash(commerce homepage update-target:*)",
+      "Bash(commerce homepage switch-template:*)",
+      "Bash(commerce inventory:*)",
+      "Bash(commerce merchant:*)",
+      "Bash(commerce review:*)",
+      "Bash(commerce product-page:*)"
     ],
     "deny": [],
     "ask": []

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

@@ -167,7 +167,7 @@ Homepage
 - "添加轮播图区块" → `commerce homepage create --type banner --title "主 Banner"`
 - "更新轮播图图片" → `commerce homepage update-images --id xx --images '[...]'`
 - "设置集合列表" → `commerce homepage update-collections --id xx --slugs "a,b,c"`
-- "调整区块顺序" → `commerce homepage reorder --ids "id1,id2,id3"`
+- "调整区块顺序" → `commerce homepage reorder --moves '[{"section_id":"id1","new_position":0}]'`
 - "使用模板" → `commerce homepage switch-template --template-key minimal`
 - "删除区块" → `commerce homepage delete --id xx --yes`
 
@@ -185,7 +185,7 @@ Homepage
 - `commerce homepage get --id <id>` - 查看区块详情
 - `commerce homepage update --id <id>` - 更新区块
 - `commerce homepage delete --id <id> --yes` - 删除区块
-- `commerce homepage reorder --ids <id1,id2,...>` - 重新排序
+- `commerce homepage reorder --moves <json>` - 重新排序（JSON 格式：`[{"section_id":"xx","new_position":0}]`）
 
 ### 区块设置
 - `commerce homepage update-images --id <id> --images <json>` - 更新 banner 图片

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

@@ -14,11 +14,10 @@ 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 history --product-id XX` | 分析库存变化趋势，优化补货策略 |
-| 盘点调整 | `inventory update --reason "盘点调整"` | 账实不符时手动调整，记录差异原因 |
+| 补货操作 | `inventory update --id XX --quantity YY` | 使用 product list 获取商品 ID |
+| 预留库存 | `inventory reserve --id XX --quantity YY` | 订单创建时立即预留，避免超卖 |
+| 查看历史 | `inventory history --id XX` | 分析库存变化趋势，优化补货策略 |
+| 盘点调整 | `inventory update --id XX --quantity YY` | 账实不符时手动调整 |
 
 ### 1. 查看低库存预警
 
@@ -35,15 +34,12 @@ commerce inventory low-stock --threshold 5
 
 ```bash
 # 用户说："商品prod_123补货100个"
-commerce inventory update \
-  --id prod_123 \
-  --quantity 100 \
-  --reason "定期补货"
+commerce inventory update --id prod_123 --quantity 100
 
 # 根据销售数据决定补货量
-commerce inventory update --id prod_hot --quantity 500 --reason "畅销品大量补货"
-commerce inventory update --id prod_normal --quantity 100 --reason "常规补货"
-commerce inventory update --id prod_slow --quantity 20 --reason "滞销品少量补货"
+commerce inventory update --id prod_hot --quantity 500
+commerce inventory update --id prod_normal --quantity 100
+commerce inventory update --id prod_slow --quantity 20
 ```
 
 ### 3. 预留库存
@@ -52,16 +48,11 @@ commerce inventory update --id prod_slow --quantity 20 --reason "滞销品少量
 
 ```bash
 # 用户说："为订单预留5个商品"
-commerce inventory reserve \
-  --product-id prod_123 \
-  --quantity 5 \
-  --order-id order_456
+commerce inventory reserve --id prod_123 --quantity 5
 ```
 
 **库存预留机制**：
 - **订单创建时预留** - 避免超卖，保证订单可履行
-- **支付超时释放** - 未支付订单15分钟后自动释放预留
-- **取消订单释放** - 订单取消后立即释放预留
 - **发货后扣减** - 商品发货后从可用库存扣减
 
 ### 4. 盘点调整
@@ -70,13 +61,7 @@ commerce inventory reserve \
 
 ```bash
 # 实际库存95，账面库存100，差异5个
-commerce inventory update \
-  --id prod_123 \
-  --quantity 95 \
-  --reason "盘点调整：实际库存95，账面100，差异-5（仓库损耗）"
-
-# 验证更新
-commerce inventory get --id prod_123
+commerce inventory update --id prod_123 --quantity 95
 ```
 
 ### 5. 处理超卖
@@ -103,9 +88,7 @@ commerce inventory get --id prod_123
 
 ```bash
 # 用户说："查看商品prod_123的库存变更记录"
-commerce inventory history \
-  --product-id prod_123 \
-  --limit 20
+commerce inventory history --id prod_123
 ```
 
 ## 卓越标准
@@ -128,8 +111,8 @@ commerce inventory history \
 1. **查看低库存** - 每日 `commerce inventory low-stock --threshold 10`
 2. **分析销售趋势** - 结合订单数据判断补货优先级
 3. **制定补货计划** - 畅销品加大补货量，滞销品谨慎补货
-4. **执行补货** - `commerce inventory update --id XX --quantity YY --reason "补货"`
-5. **验证更新** - `commerce inventory get --id XX` 确认库存正确
+4. **执行补货** - `commerce inventory update --id XX --quantity YY`
+5. **验证更新** - `commerce product get --id XX` 确认库存正确
 6. **定期盘点** - 每月实地盘点，调整账面库存
 
 ## 常见问题
@@ -140,7 +123,7 @@ commerce inventory history \
 ```bash
 # 不分析就盲目补货，可能造成库存积压
 for product_id in $(commerce inventory low-stock --json | jq -r '.[].id'); do
-  commerce inventory update --id $product_id --quantity 100 --reason "批量补货"
+  commerce inventory update --id $product_id --quantity 100
 done
 ```
 
@@ -150,9 +133,9 @@ done
 commerce inventory low-stock --threshold 10
 
 # 根据销售数据决定补货量
-commerce inventory update --id prod_hot --quantity 500 --reason "畅销品大量补货"
-commerce inventory update --id prod_normal --quantity 100 --reason "常规补货"
-commerce inventory update --id prod_slow --quantity 20 --reason "滞销品少量补货"
+commerce inventory update --id prod_hot --quantity 500      # 畅销品大量补货
+commerce inventory update --id prod_normal --quantity 100   # 常规补货
+commerce inventory update --id prod_slow --quantity 20      # 滞销品少量补货
 ```
 
 ### ❌ 问题2：库存差异超过5%未深入调查
@@ -165,11 +148,8 @@ commerce inventory update --id prod_slow --quantity 20 --reason "滞销品少量
 3. 差异率 > 5%需要深入调查根本原因
 
 ```bash
-# 调整库存并详细记录原因
-commerce inventory update \
-  --id prod_123 \
-  --quantity 95 \
-  --reason "盘点调整：实际95，账面100，差异-5（仓库损耗，需检查存储条件）"
+# 调整库存（记录差异原因：实际95，账面100，差异-5，仓库损耗）
+commerce inventory update --id prod_123 --quantity 95
 ```
 
 ### ❌ 问题3：滞销商品长期占用库存
@@ -184,24 +164,17 @@ commerce inventory update \
 
 ```bash
 # 查看库存历史判断是否滞销
-commerce inventory history --product-id prod_slow --limit 50
+commerce inventory history --id prod_slow
 ```
 
-### ❌ 问题4：不记录库存变更原因
+### ❌ 问题4：不分析销售数据就补货
 
-**错误做法**：
-```bash
-# 缺少原因，无法追溯
-commerce inventory update --id prod_123 --quantity 100
-```
+**错误做法**：直接设置固定数量，不考虑销售速度
 
 **✅ 正确做法**：
 ```bash
-# 必须记录原因
-commerce inventory update \
-  --id prod_123 \
-  --quantity 100 \
-  --reason "定期补货：上周销量50，预计2周销量"
+# 根据销售数据决定补货量（如上周销量50，预计2周销量）
+commerce inventory update --id prod_123 --quantity 100
 ```
 
 ### ❌ 问题5：超卖后处理不当
@@ -223,23 +196,16 @@ commerce inventory update \
 
 当用户说：
 - "查看库存低于10的商品" → `commerce inventory low-stock --threshold 10`
-- "商品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`
+- "商品XX补货50个" → `commerce inventory update --id XX --quantity 50`
+- "预留库存" → `commerce inventory reserve --id XX --quantity YY`
+- "查看库存历史" → `commerce inventory history --id XX`
 
 ### 核心功能
 
-**库存查询**:
-- `commerce inventory list` - 查看所有商品库存
-- `commerce inventory get` - 查看单个商品库存
 - `commerce inventory low-stock` - 查看低库存商品
-- `commerce inventory history` - 查看库存变更历史
-
-**库存更新**:
 - `commerce inventory update` - 更新库存数量
+- `commerce inventory history` - 查看库存变更历史
 - `commerce inventory reserve` - 预留库存
-- `commerce inventory release` - 释放预留库存
 
 ## 详细示例
 
@@ -252,40 +218,26 @@ commerce inventory low-stock --threshold 5
 ### 补货操作
 ```bash
 # 用户说："商品prod_123补货100个"
-commerce inventory update \
-  --id prod_123 \
-  --quantity 100 \
-  --reason "定期补货"
+commerce inventory update --id prod_123 --quantity 100
 ```
 
 ### 预留库存
 ```bash
 # 用户说："为订单预留5个商品"
 commerce inventory reserve \
-  --product-id prod_123 \
-  --quantity 5 \
-  --order-id order_456
+  --id prod_123 \
+  --quantity 5
 ```
 
 ### 查看库存历史
 ```bash
 # 用户说："查看商品prod_123的库存变更记录"
-commerce inventory history \
-  --product-id prod_123 \
-  --limit 20
-```
-
-### 批量查看库存
-```bash
-# 用户说："查看所有商品的库存情况"
-commerce inventory list --limit 100
+commerce inventory history --id prod_123
 ```
 
 ## 重要提示
 
 - 库存变更会自动记录历史
 - 预留库存不会减少可用库存数量
-- 更新库存时建议添加 `--reason` 说明原因
-- 低库存阈值可以自定义
-- 支持批量库存更新（通过脚本循环调用）
+- 低库存阈值可自定义（默认5）
 - 使用 `--help` 查看命令详细参数

package/.claude/skills/merchant/SKILL.md

@@ -19,19 +19,19 @@ commerce merchant info
 
 ### 更新店铺信息
 ```bash
-commerce merchant update --name "新店铺名" --description "描述" --currency USD
+commerce merchant update --name "新店铺名" --description "描述" --default-currency USD
 ```
 
 可更新的字段：
 - `--name`: 店铺名称
 - `--slug`: 店铺标识（URL 友好）
 - `--description`: 店铺描述
-- `--currency`: 默认货币（USD, CNY, EUR 等）
+- `--default-currency`: 默认货币（USD, CNY, EUR 等）
 - `--contact-name`: 联系人姓名
 - `--contact-phone`: 联系电话
 - `--contact-email`: 联系邮箱
-- `--company`: 公司名称
-- `--address-*`: 发货地址字段
+- `--company-name`: 公司名称
+- `--origin-*`: 发货地址字段（origin-country-alpha2, origin-city, origin-postal-code 等）
 
 ## 完整命令列表
 
@@ -46,10 +46,10 @@ commerce merchant update --name "我的店铺" --description "这是一个很棒
 commerce merchant update --contact-name "张三" --contact-phone "1234567890" --contact-email "contact@example.com"
 
 # 更新发货地址
-commerce merchant update --address-country "CN" --address-city "深圳" --address-postal-code "518000"
+commerce merchant update --origin-country-alpha2 "CN" --origin-city "深圳" --origin-postal-code "518000"
 
 # 更新多个字段
-commerce merchant update --name "新店铺" --currency "CNY" --company "我的公司"
+commerce merchant update --name "新店铺" --default-currency "CNY" --company-name "我的公司"
 ```
 
 ## 工作流示例
@@ -75,9 +75,9 @@ commerce merchant update \
   --contact-name "张三" \
   --contact-phone "13800138000" \
   --contact-email "shop@example.com" \
-  --address-country "CN" \
-  --address-city "深圳" \
-  --address-postal-code "518000"
+  --origin-country-alpha2 "CN" \
+  --origin-city "深圳" \
+  --origin-postal-code "518000"
 ```
 
 ### 示例 3：修改店铺名称

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

@@ -72,7 +72,7 @@ content 支持模板变量，在前端渲染时自动替换：
 - "覆盖护理说明" → `commerce product-page create --handle care --operation-type override ...`
 - "隐藏环保说明" → `commerce product-page hide --handle eco-friendly`
 - "添加品牌故事区块" → `commerce product-page create --handle brand-story --operation-type new ...`
-- "调整区块顺序" → `commerce product-page reorder --handles "h1,h2,h3"`
+- "调整区块顺序" → `commerce product-page reorder --sections '[{"handle":"h1","position":1},{"handle":"h2","position":2}]'`
 - "给某商品单独设置" → `commerce product-page product create --product-handle xxx ...`
 
 ## 命令参考
@@ -85,7 +85,7 @@ content 支持模板变量，在前端渲染时自动替换：
 - `commerce product-page update --handle <handle>` - 更新区块
 - `commerce product-page delete --handle <handle> --yes` - 删除自定义
 - `commerce product-page hide --handle <handle>` - 隐藏区块（快捷方式）
-- `commerce product-page reorder --handles <h1,h2,...>` - 重新排序
+- `commerce product-page reorder --sections <json>` - 重新排序（JSON 格式：`[{"handle":"xx","position":1}]`）
 
 ### 商品级命令（仅影响单个商品）
 

package/.claude/skills/review/SKILL.md

@@ -17,7 +17,7 @@ description: Review management and moderation. View, approve, reject, and respon
 - "设为精选" → `commerce review feature --id XX --enable`
 - "查看举报" → `commerce review reports --status pending`
 - "查看评价设置" → `commerce review get-settings`
-- "开启自动审核" → `commerce review update-settings --auto-approve --min-rating 4`
+- "开启自动审核" → `commerce review update-settings --auto-approve`
 
 ### 场景决策表
 
@@ -30,7 +30,7 @@ description: Review management and moderation. View, approve, reject, and respon
 | 处理举报 | `review handle-report` | 核实后决定删除或驳回 |
 | 查看统计 | `review stats` | 监控平均分和评分分布趋势 |
 | 查看设置 | `review get-settings` | 了解当前自动审核等配置 |
-| 开启自动审核 | `review update-settings --auto-approve` | 建议设置最低评分 4 星 |
+| 开启自动审核 | `review update-settings --auto-approve` | 所有评价自动通过 |
 
 ### 标准评价管理流程
 1. **每日审核** - `commerce review list --status pending` 查看待审核
@@ -202,31 +202,27 @@ commerce review get-settings
 
 ### 更新评价设置
 ```bash
-# 用户说："开启自动审核，4星以上自动通过"
-commerce review update-settings \
-  --auto-approve \
-  --min-rating 4
-
-# 设置评价请求时间（订单送达后7天发送）
-commerce review update-settings --request-days 7
-
-# 允许用户上传图片和视频
-commerce review update-settings \
-  --allow-media \
-  --max-images 5 \
-  --max-videos 1
+# 用户说："开启自动审核"
+commerce review update-settings --auto-approve
+
+# 设置评价时间窗口（订单后30天内可评价）
+commerce review update-settings --review-window-days 30
+
+# 允许用户上传图片，设置最大5张
+commerce review update-settings --allow-images --max-images 5
 ```
 
 ## 评价设置配置项
 
-| 配置 | 说明 | 默认值 |
-|------|------|--------|
-| `auto_approve` | 新评价是否自动通过 | false |
-| `auto_approve_min_rating` | 自动通过的最低评分 | 4 |
-| `request_days` | 订单送达后几天发送评价请求 | 7 |
-| `allow_media` | 是否允许上传图片/视频 | true |
-| `max_images` | 最大图片数 | 5 |
-| `max_videos` | 最大视频数 | 1 |
+| 配置 | 说明 |
+|------|------|
+| `--auto-approve` | 新评价自动通过 |
+| `--require-purchase` | 需要验证购买才能评价 |
+| `--allow-anonymous` | 允许匿名评价 |
+| `--review-window-days` | 评价时间窗口（1-365天）|
+| `--allow-images` | 允许上传图片 |
+| `--max-images` | 最大图片数（0-10）|
+| `--allow-edit` | 允许编辑评价 |
 
 ## 重要提示
 

package/package.json

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