@optima-chat/optima-agent 0.4.14 → 0.4.15

package/.claude/skills/collection/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: collection
+description: 商品集合管理。创建、编辑集合，管理集合中的商品。当用户需要对商品进行分组、创建促销专区、管理商品分类时使用。
+---
+
+## 概念
+
+Collection（集合）是商品的逻辑分组，用于在店铺中组织和展示商品。类似 Shopify 的 Collections。
+
+- 一个商品可以属于多个集合（多对多关系）
+- 集合支持层级结构（parent_id）
+- 集合通过 slug 在 URL 中标识，如 `/collections/summer-sale`
+
+## 结构
+
+```
+Collection
+├── 基本信息
+│   ├── name: 集合名称
+│   ├── slug: URL 标识（商户内唯一）
+│   └── description: 描述
+├── 显示设置
+│   ├── display_order: 显示顺序
+│   ├── is_active: 是否激活
+│   └── cover_media_id: 封面图
+├── 层级
+│   └── parent_id: 父集合（可选）
+├── SEO
+│   ├── meta_title: SEO 标题
+│   └── meta_description: SEO 描述
+└── 商品（多对多）
+    └── products: 集合中的商品列表
+```
+
+## 典型场景
+
+当用户说：
+- "查看所有集合" / "集合列表" → `commerce collection list`
+- "创建集合 XX" → `commerce collection create --name "XX" --slug xx`
+- "查看集合详情" → `commerce collection get --slug xx`
+- "删除集合 XX" → `commerce collection delete --slug xx --yes`
+- "把商品加到集合" → `commerce collection add-products --slug xx --product-ids p1,p2`
+- "从集合移除商品" → `commerce collection remove-products --slug xx --product-ids p1`
+- "查看集合里有哪些商品" → `commerce collection list-products --slug xx`
+
+## 命令参考
+
+### 集合 CRUD
+- `commerce collection list` - 列出所有集合
+- `commerce collection create` - 创建集合
+- `commerce collection get --slug <slug>` - 查看集合详情
+- `commerce collection update --slug <slug>` - 更新集合
+- `commerce collection delete --slug <slug> --yes` - 删除集合
+- `commerce collection set-cover --slug <slug> --media-id <id>` - 设置封面图
+
+### 商品管理
+- `commerce collection add-products --slug <slug> --product-ids <ids>` - 添加商品
+- `commerce collection remove-products --slug <slug> --product-ids <ids>` - 移除商品
+- `commerce collection list-products --slug <slug>` - 列出集合中的商品
+
+## 创建集合示例
+
+```bash
+# 创建促销集合
+commerce collection create \
+  --name "Summer Sale 2024" \
+  --slug summer-sale-2024 \
+  --description "Hot deals for summer"
+
+# 添加商品到集合
+commerce collection add-products \
+  --slug summer-sale-2024 \
+  --product-ids prod_123,prod_456,prod_789
+```
+
+## 注意事项
+
+- **slug 规范**：使用英文、数字、连字符，避免中文和特殊字符（影响 SEO 和 URL）
+- **删除确认**：删除操作需要 `--yes` 参数确认
+- **商品数量**：建议每个集合包含 5-30 个商品，过少显得空，过多难以浏览
+- **层级深度**：支持父子集合，但建议层级不超过 2 层

package/.claude/skills/comfy/SKILL.md

@@ -168,7 +168,7 @@ comfy video <图片路径> [options]
 | `-d, --duration` | 5 \| 10 \| 15 秒 | 5 |
 | `--shot-type` | single \| multi（多镜头叙事） | single |
 | `--no-audio` | 禁用自动配音 | - |
-| `--audio-url <url>` | 自定义音频（wav/mp3, 3-30秒） | - |
+| `--audio-url <url>` | 自定义音频 URL（需先用 `commerce upload` 上传） | - |
 | `--no-prompt-extend` | 禁用智能改写 prompt | - |
 | `--watermark` | 添加 AI 生成水印 | - |
 | `--seed <number>` | 随机种子（可复现） | - |
@@ -188,6 +188,11 @@ comfy video story.png --shot-type multi -d 15 --prompt "a day in the life"
 # 静音视频
 comfy video product.png --no-audio --prompt "360 degree rotation"
 
+# 自定义音频（需先上传获取 URL）
+commerce upload /home/aiuser/music.mp3
+# 返回 URL 后使用
+comfy video scene.png --audio-url "https://..." -o /home/aiuser/project/with-audio.mp4
+
 # 指定输出路径
 comfy video scene.png -o /home/aiuser/project/result.mp4 --prompt "camera zoom"
 Read /home/aiuser/project/result.mp4

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

@@ -0,0 +1,277 @@
+---
+name: homepage
+description: 店铺首页配置。管理首页区块（Banner、集合列表、集合商品、特色推荐）。当用户需要配置店铺首页布局、添加轮播图、展示集合时使用。
+---
+
+## 概念
+
+Homepage（首页）是店铺的入口页面，由多个 Section（区块）组成。每个商户有一个激活的首页配置。
+
+- 区块按 position 排序，从上到下显示
+- 每个区块有唯一的 handle，用于 URL 锚点定位
+- 区块通过 settings 存储类型特定的配置
+
+**与 Collection 的关系**：多个区块类型引用 Collection：
+- `collections` 区块：展示多个集合入口（引用 collection slugs）
+- `collection_products` 区块：展示某个集合的商品（引用单个 collection slug）
+- `featured` 区块：可推荐某个集合（target_type=collection）
+
+→ 参考 [Collection Skill](../collection/SKILL.md) 了解集合管理
+
+## 结构
+
+```
+Homepage
+├── HomepageConfig（商户唯一）
+│   ├── id: 配置 ID
+│   ├── is_active: 是否激活
+│   └── sections: 区块列表
+│
+└── HomepageSection（区块）
+    ├── 基本信息
+    │   ├── id: 区块 ID
+    │   ├── type: 类型（见下方）
+    │   ├── title: 标题
+    │   ├── handle: URL 标识
+    │   └── position: 显示顺序（0 开始）
+    │
+    └── settings: 类型特定配置（JSONB）
+```
+
+## 区块类型详解
+
+### 1. banner（图片轮播）
+
+首页顶部的轮播广告图，支持多张图片自动轮播，每张图可设置点击跳转。
+
+**Settings 字段**：
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| images | array | 图片数组（见下方） |
+| autoplay | boolean | 是否自动播放，默认 true |
+| interval | number | 轮播间隔（毫秒），默认 5000 |
+
+**images 数组元素**：
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| url | ✓ | 图片 URL |
+| alt | ✓ | 图片描述（SEO + 可访问性） |
+| action_type | ✓ | 点击动作类型（见下方） |
+| action_value | | 动作目标值 |
+
+**action_type 取值**：
+| 值 | 说明 | action_value |
+|----|------|--------------|
+| `none` | 无跳转 | null |
+| `collection` | 跳转到集合页 | collection slug |
+| `product` | 跳转到商品页 | product handle |
+| `url` | 跳转到 URL | 完整 URL 或相对路径 |
+| `section` | 滚动到页面区块 | section handle |
+
+**示例**：
+```json
+{
+  "images": [
+    {"url": "https://cdn.../summer.jpg", "alt": "夏日促销", "action_type": "collection", "action_value": "summer-sale"},
+    {"url": "https://cdn.../promo.jpg", "alt": "活动页面", "action_type": "url", "action_value": "https://promo.example.com/event"},
+    {"url": "https://cdn.../hero.jpg", "alt": "品牌形象", "action_type": "none", "action_value": null}
+  ],
+  "autoplay": true,
+  "interval": 5000
+}
+```
+
+### 2. collections（集合入口列表）
+
+展示多个集合的入口卡片，用户点击可进入对应集合页。
+
+**Settings 字段**：
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| collection_slugs | array | 集合 slug 数组，按顺序展示 |
+| layout | string | 布局方式：`grid`（网格）/ `carousel`（轮播） |
+| show_product_count | boolean | 是否显示集合商品数量 |
+
+**示例**：
+```json
+{
+  "collection_slugs": ["summer-sale", "new-arrivals", "best-sellers"],
+  "layout": "grid",
+  "show_product_count": true
+}
+```
+
+### 3. collection_products（集合商品展示）
+
+展示某个集合内的商品列表，支持自动获取或手动指定。
+
+**Settings 字段**：
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| collection_slug | string | 集合 slug（必需） |
+| mode | string | `auto`（自动获取）/ `manual`（手动指定） |
+| product_handles | array | mode=manual 时，手动指定的商品 handle 列表 |
+| limit | number | mode=auto 时，最多展示数量，默认 8 |
+| sort_by | string | 排序字段：`created_at` / `price` / `title` |
+| sort_order | string | 排序方向：`asc` / `desc` |
+
+**示例**：
+```json
+{
+  "collection_slug": "new-arrivals",
+  "mode": "auto",
+  "limit": 8,
+  "sort_by": "created_at",
+  "sort_order": "desc"
+}
+```
+
+### 4. featured（特色推荐）
+
+突出展示某个集合或商品，通常带有大图和 CTA 按钮。
+
+**Settings 字段**：
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| target_type | string | `collection`（推荐集合）/ `product`（推荐商品） |
+| target_handle | string | 目标的 slug/handle |
+| media_id | string | 封面图片的 media ID |
+| media_url | string | 或直接提供封面图片 URL |
+| cta_text | string | CTA 按钮文字，如 "立即查看" |
+| background_color | string | 背景颜色，如 "#f5f5f5" |
+
+**示例（推荐集合）**：
+```json
+{
+  "target_type": "collection",
+  "target_handle": "summer-sale",
+  "media_url": "https://cdn.../featured.jpg",
+  "cta_text": "查看夏日精选",
+  "background_color": "#fff8e1"
+}
+```
+
+**示例（推荐商品）**：
+```json
+{
+  "target_type": "product",
+  "target_handle": "ceramic-cup-white",
+  "media_url": "https://cdn.../product-hero.jpg",
+  "cta_text": "立即购买"
+}
+```
+
+## 典型场景
+
+当用户说：
+- "查看首页配置" → `commerce homepage get-config`
+- "查看首页区块" → `commerce homepage list`
+- "添加轮播图区块" → `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 switch-template --template-key minimal`
+- "删除区块" → `commerce homepage delete --id xx --yes`
+
+## 命令参考
+
+### 配置管理
+- `commerce homepage get-config` - 查看首页配置
+- `commerce homepage list-templates` - 列出可用模板
+- `commerce homepage switch-template --template-key <key>` - 切换模板（minimal|standard）
+- `commerce homepage delete-config --yes` - 删除首页配置
+
+### 区块 CRUD
+- `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` - 删除区块
+- `commerce homepage reorder --ids <id1,id2,...>` - 重新排序
+
+### 区块设置
+- `commerce homepage update-images --id <id> --images <json>` - 更新 banner 图片
+- `commerce homepage update-collections --id <id> --slugs <slugs>` - 更新 collections 集合
+- `commerce homepage update-target --id <id> --type <type> --handle <handle>` - 更新 featured 目标
+- `commerce homepage patch-settings --id <id> --settings <json>` - 通用设置更新
+
+## 典型操作示例
+
+### 快速开始：使用模板
+
+```bash
+# 查看可用模板
+commerce homepage list-templates
+
+# 切换到标准模板（会创建预设区块）
+commerce homepage switch-template --template-key standard --yes
+```
+
+### 配置轮播图
+
+```bash
+# 1. 创建 banner 区块
+commerce homepage create --type banner --title "首页轮播"
+
+# 2. 更新 banner 图片（需要先上传图片获取 URL）
+commerce homepage update-images \
+  --id section_xxx \
+  --images '[{"url":"https://cdn.../img1.jpg","alt":"夏日促销","action_type":"collection","action_value":"summer-sale"}]'
+```
+
+### 展示集合入口
+
+```bash
+# 1. 先确保有集合（参考 collection skill）
+commerce collection list
+
+# 2. 创建 collections 区块
+commerce homepage create --type collections --title "精选系列"
+
+# 3. 设置要展示的集合（逗号分隔，无空格）
+commerce homepage update-collections \
+  --id section_xxx \
+  --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"}'
+```
+
+### 特色推荐集合
+
+```bash
+# 1. 创建 featured 区块
+commerce homepage create --type featured --title "本周推荐"
+
+# 2. 设置推荐目标为集合
+commerce homepage update-target \
+  --id section_xxx \
+  --type collection \
+  --handle "weekly-picks"
+```
+
+### 特色推荐商品
+
+```bash
+# 设置推荐目标为某个商品
+commerce homepage update-target \
+  --id section_xxx \
+  --type product \
+  --handle "ceramic-cup-white"
+```
+
+## 注意事项
+
+- **区块顺序**：使用 `reorder` 调整，position 从 0 开始
+- **模板切换**：会创建新区块并停用旧区块，谨慎操作
+- **图片格式**：banner images 需要完整的 JSON 数组，每个元素必须有 url 和 alt
+- **集合引用**：确保引用的 collection slug 存在，否则前端可能显示空
+- **删除确认**：删除操作需要 `--yes` 参数
+- **slugs 参数**：逗号分隔，不要有空格

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

@@ -0,0 +1,200 @@
+---
+name: product-page
+description: 商品详情页配置。自定义商品详情页的可折叠区块内容（如护理说明、退货政策）。当用户需要编辑商品页信息区块、隐藏某些区块、或添加自定义区块时使用。
+---
+
+## 概念
+
+Product Page Section（商品页区块）是商品详情页上的信息模块，采用三层继承机制：
+
+```
+System（系统默认）
+    ↓ 可被覆盖
+Merchant（商户级自定义）
+    ↓ 可被覆盖
+Product（商品级覆盖）
+```
+
+- **System**：系统预设的区块（如退货政策、发货说明）
+- **Merchant**：商户对系统区块的自定义（适用于所有商品）
+- **Product**：单个商品对上层区块的覆盖（仅影响该商品）
+
+每层都可以执行三种操作：
+- `override`：覆盖上层的内容
+- `new`：创建全新的区块
+- `hidden`：隐藏某个区块
+
+## 结构
+
+```
+ProductPageSection
+├── 基本信息
+│   ├── handle: 区块标识符（唯一）
+│   ├── operation_type: override | new | hidden
+│   ├── type: collapsible（可折叠）| static（静态）
+│   └── position: 显示位置（1-10）
+│
+├── 内容
+│   ├── content: Markdown 内容（支持模板变量）
+│   └── tab_group: Tab 分组（可选）
+│
+└── 翻译
+    └── translations: 多语言翻译
+```
+
+### 系统默认区块
+
+| handle | 说明 | 默认类型 |
+|--------|------|----------|
+| `highlights` | 产品亮点 | static |
+| `details` | 产品详情 | collapsible |
+| `guarantee` | 品质保证 | collapsible |
+| `care` | 护理说明 | collapsible |
+| `shipping-policies` | 发货政策 | collapsible |
+| `return` | 退换政策 | collapsible |
+| `eco-friendly` | 环保说明 | collapsible |
+
+### 模板变量
+
+content 支持模板变量，在前端渲染时自动替换：
+
+| 变量 | 说明 |
+|------|------|
+| `{{product.name}}` | 商品名称 |
+| `{{product.description}}` | 商品描述 |
+| `{{variant.sku}}` | 当前变体 SKU |
+| `{{merchant.name}}` | 店铺名称 |
+
+## 典型场景
+
+当用户说：
+- "查看所有区块" → `commerce product-page list --resolved`
+- "覆盖护理说明" → `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 product create --product-handle xxx ...`
+
+## 命令参考
+
+### 商户级命令（影响所有商品）
+
+- `commerce product-page list` - 列出商户自定义
+- `commerce product-page list --resolved` - 列出合并后的完整视图（推荐）
+- `commerce product-page create` - 创建/覆盖区块
+- `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 product list --product-handle <handle>` - 列出商品级覆盖
+- `commerce product-page product list --product-handle <handle> --resolved` - 列出合并视图
+- `commerce product-page product create --product-handle <handle> ...` - 创建商品级覆盖
+- `commerce product-page product update --product-handle <handle> --handle <section> ...` - 更新
+- `commerce product-page product delete --product-handle <handle> --handle <section> --yes` - 删除
+- `commerce product-page product hide --product-handle <handle> --handle <section>` - 隐藏
+
+### 翻译命令
+
+- `commerce product-page translation list --handle <handle>` - 查看区块翻译
+- `commerce product-page translation set --handle <handle> --lang <code>` - 设置翻译
+- `commerce product-page translation delete --handle <handle> --lang <code> --yes` - 删除翻译
+
+## 典型操作示例
+
+### 查看所有区块
+
+```bash
+# 查看合并后的完整视图（System + Merchant）
+commerce product-page list --resolved
+```
+
+### 覆盖系统默认区块
+
+```bash
+# 覆盖护理说明内容
+commerce product-page create \
+  --handle care \
+  --operation-type override \
+  --type collapsible \
+  --position 4 \
+  --content "## 洗涤说明\n\n- 可机洗，30°C\n- 请勿漂白\n- 低温烘干"
+```
+
+### 隐藏某个区块
+
+```bash
+# 快捷方式：隐藏环保说明区块
+commerce product-page hide --handle eco-friendly
+
+# 完整方式
+commerce product-page create --handle eco-friendly --operation-type hidden
+```
+
+### 创建自定义区块
+
+```bash
+# 添加品牌故事区块
+commerce product-page create \
+  --handle brand-story \
+  --operation-type new \
+  --type collapsible \
+  --position 8 \
+  --content "## 关于 {{merchant.name}}\n\n创立于2020年..."
+```
+
+### 使用 Tab 分组
+
+```bash
+# 创建属于同一 Tab 组的多个区块
+commerce product-page create \
+  --handle ingredients \
+  --operation-type new \
+  --type collapsible \
+  --position 5 \
+  --content "## 成分\n\n100% 有机棉" \
+  --tab-group product-info
+
+commerce product-page create \
+  --handle materials \
+  --operation-type new \
+  --type collapsible \
+  --position 6 \
+  --content "## 材质\n\n天然环保材料" \
+  --tab-group product-info
+```
+
+### 为单个商品设置不同内容
+
+```bash
+# 给某商品的护理说明设置特殊内容
+commerce product-page product create \
+  --product-handle ceramic-cup-white \
+  --handle care \
+  --operation-type override \
+  --type collapsible \
+  --position 4 \
+  --content "## 陶瓷护理\n\n- 可用洗碗机\n- 避免剧烈温度变化"
+```
+
+### 添加翻译
+
+```bash
+# 为护理说明添加英文翻译
+commerce product-page translation set \
+  --handle care \
+  --lang en-US \
+  --title "Care Instructions" \
+  --content "## Washing Instructions\n\n- Machine wash, 30°C\n- Do not bleach"
+```
+
+## 注意事项
+
+- **--resolved 参数**：查看列表时建议使用 `--resolved`，显示完整的合并视图
+- **handle 唯一性**：同一层级内 handle 必须唯一
+- **隐藏 vs 删除**：`hide` 是标记隐藏，`delete` 是删除自定义（恢复为上层默认）
+- **position 冲突**：不同区块可以有相同 position，显示时按 position 排序
+- **内容格式**：content 支持 Markdown，可使用模板变量
+- **Tab 分组**：tab_group 相同的区块会在前端合并为标签页显示

package/README.md

@@ -72,7 +72,9 @@ optima -p "查看商品列表"
 | order | 订单处理 |
 | inventory | 库存管理 |
 | i18n | 国际化翻译 |
-| storefront | 店铺前台配置 |
+| collection | 商品集合管理 |
+| homepage | 店铺首页配置 |
+| product-page | 商品详情页配置 |
 | comfy | 图像/视频生成 |
 | ads | Google Ads 广告 |
 | scout | Amazon 选品调研 |

package/dist/src/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,CAmFxC"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,CAqFxC"}

package/dist/src/system-prompt.js

@@ -30,7 +30,9 @@ export function getSystemPrompt() {
 - **order** - 订单处理（发货、退款、查询）
 - **inventory** - 库存管理（监控、调整库存）
 - **i18n** - 国际化翻译管理
-- **storefront** - 店铺首页和集合配置
+- **collection** - 商品集合管理（分组、促销专区）
+- **homepage** - 店铺首页配置（Banner、集合展示）
+- **product-page** - 商品详情页配置
 - **comfy** - 图像/视频生成
 - **ads** - Google Ads 广告投放
 - **scout** - Amazon 选品调研

package/dist/src/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,OAAO;;;;;;;aAOI,OAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8D9B,CAAC;AACF,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IAEH,OAAO;;;;;;;aAOI,OAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgE9B,CAAC;AACF,CAAC"}

package/package.json

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

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

@@ -1,426 +0,0 @@
----
-name: storefront
-description: "店铺前台配置管理。使用场景：配置首页(homepage/首页)、商品详情页区块(sections/区块)、调整模块顺序和布局。使用 commerce homepage/section 命令。"
----
-
-# Commerce CLI - Storefront Configuration
-
-店铺前台配置模块，用于首页设置和商品详情页区块配置。
-
-## 典型场景
-
-### 场景决策表
-
-| 用户需求 | 推荐命令 | 关键注意点 |
-|---------|---------|-----------|
-| 创建轮播图 | `commerce homepage module create --type banner` | 图片尺寸1920x600px，≤5张，配置跳转链接 |
-| 显示精选商品 | `commerce homepage module create --type featured` | 选择高转化商品，数量8-12个 |
-| 调整模块顺序 | `commerce homepage module reorder --position X` | 重要模块靠前（轮播图position=1） |
-
-### 场景 1：首页配置
-
-**标准首页布局**（position顺序）：
-1. **轮播图** (position=1) - 展示促销、新品、品牌故事
-2. **分类导航** (position=2) - 快速引导到商品分类
-3. **精选商品** (position=3) - 展示高转化或高利润商品
-4. **热门集合** (position=4) - 展示2-3个核心集合
-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. **定期优化** - 根据数据调整模块顺序和内容
-
-### 场景 2：创建轮播图
-
-**配置要点**：
-- 图片尺寸：1920x600px（桌面端）
-- 数量限制：≤ 5张（避免影响加载速度）
-- 格式支持：WebP（优先）、JPG、PNG
-- 跳转链接：配置促销页面或集合页面
-- 懒加载：启用图片懒加载优化性能
-
-```bash
-commerce homepage module create \
-  --slug hero-banner \
-  --type banner \
-  --position 1 \
-  --enabled true \
-  --config '{"images":[{"url":"https://example.com/banner1.jpg","link":"/collections/summer-sale"}]}'
-```
-
-### 场景 3：调整模块顺序
-
-**重新排序原则**：
-- 重要模块靠前（轮播图 position=1）
-- 高转化模块优先级高
-- 移动端体验优先
-- 定期根据数据优化
-
-```bash
-# 调整精选商品模块到第2位
-commerce homepage module reorder \
-  --module-id module_123 \
-  --position 2
-```
-
-### 场景 4：优化转化率
-
-**数据驱动优化**：
-- 分析首页点击热图，调整模块顺序
-- A/B测试不同轮播图和精选商品
-- 精选商品选择高利润或高评分商品
-
-**性能优化建议**：
-- 轮播图：懒加载，压缩图片，支持WebP格式
-- 精选商品：限制8-12个，缓存1小时
-
-
-## 卓越标准
-
-### 店铺配置质量指标
-- **页面加载速度**: 首页加载 < 3秒，移动端 < 5秒
-- **视觉设计**: 轮播图尺寸统一（1920x600px），图片清晰无水印
-- **导航体验**: 分类层级 ≤ 3层，模块数量适中
-- **内容更新频率**: 轮播图每周更新，精选商品每3天更新
-- **转化率**: 首页访客转化率 > 3%
-
-### 店铺配置原则
-- **移动优先**: 所有配置考虑移动端体验，图片支持响应式
-- **性能优化**: 轮播图 ≤ 5张，精选商品 ≤ 12个，减少加载负担
-- **SEO友好**: 模块标题包含关键词
-- **一致性**: 风格统一（色彩、字体、间距），提升品牌辨识度
-- **数据驱动**: 根据点击率和转化率优化首页布局
-
-### 首页配置检查清单
-
-**上线前必查**：
-- [ ] 轮播图尺寸统一，图片清晰
-- [ ] 所有链接可点击，无404
-- [ ] 移动端显示正常
-- [ ] 加载速度 < 3秒
-- [ ] SEO信息完整（标题、描述、关键词）
-- [ ] 精选商品有库存
-- [ ] 首页模块顺序合理
-
-## 常见问题
-
-### ❌ 问题 1：轮播图过多影响性能
-
-**错误做法**：
-```bash
-# 创建10张轮播图，导致首页加载缓慢
-commerce homepage module create --type banner --config '{"images":[...10张图片...]}'
-```
-
-**✅ 正确做法**：
-```bash
-# 限制≤5张，压缩图片，启用懒加载
-commerce homepage module create --type banner --config '{"images":[...3-5张图片...]}'
-```
-
-### ❌ 问题 2：精选商品数量过多
-
-**错误做法**：
-```bash
-# 显示30个精选商品，影响用户决策
-commerce homepage settings update --featured-limit 30
-```
-
-**✅ 正确做法**：
-```bash
-# 限制8-12个，选择高转化商品
-commerce homepage settings update --featured-limit 10
-```
-
-### ❌ 问题 3：首页模块顺序混乱
-
-**错误做法**：
-```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
-```
-
-**✅ 正确做法**：
-```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
-```
-
-## 命令参考
-
-### 自然语言映射
-
-当用户说：
-- "创建首页轮播图" → `commerce homepage module create --type banner ...`
-- "更新首页设置" → `commerce homepage settings update --show-search true`
-
-### 核心功能
-
-**首页模块管理**:
-- `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` - 更新首页设置
-
-## 详细示例
-
-### 创建首页轮播图
-```bash
-# 用户说："创建首页轮播图模块"
-commerce homepage module create \
-  --slug hero-banner \
-  --type banner \
-  --position 1 \
-  --enabled true \
-  --config '{"images":[{"url":"https://example.com/banner1.jpg"}]}'
-```
-
-### 更新首页设置
-```bash
-# 用户说："启用首页搜索功能，显示8个精选商品"
-commerce homepage settings update \
-  --show-search true \
-  --featured-limit 8
-```
-
-### 重新排序首页模块
-```bash
-# 用户说："调整首页模块顺序"
-commerce homepage module reorder \
-  --module-id module_123 \
-  --position 2
-```
-
-### 完整首页配置示例
-```bash
-# 1. 创建轮播图模块
-commerce homepage module create \
-  --slug hero-banner \
-  --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 \
-  --type featured \
-  --position 3 \
-  --config '{"limit":10}'
-
-# 4. 更新首页设置
-commerce homepage settings update \
-  --show-search true \
-  --featured-limit 10
-
-# 5. 验证配置
-commerce homepage module list
-```
-
-## 场景 5：商品详情页区块管理
-
-### 三层继承模型
-
-商品详情页区块采用三层继承架构，实现灵活的内容定制：
-
-```
-┌─────────────────────────────────────────────────────────┐
-│  System Layer (系统默认)                                 │
-│  - 7个预设区块: highlights, details, guarantee,          │
-│    care, shipping-policies, return, eco-friendly        │
-│  - 支持7种语言的默认翻译                                  │
-│  - 不可删除，只能覆盖或隐藏                               │
-└─────────────────────────────────────────────────────────┘
-                          ↓ 继承
-┌─────────────────────────────────────────────────────────┐
-│  Merchant Layer (商户定制)                               │
-│  - 覆盖系统默认区块内容                                   │
-│  - 创建商户专属新区块                                     │
-│  - 隐藏不需要的系统区块                                   │
-│  - 适用于所有商品（除非商品级覆盖）                        │
-└─────────────────────────────────────────────────────────┘
-                          ↓ 继承
-┌─────────────────────────────────────────────────────────┐
-│  Product Layer (商品定制)                                │
-│  - 覆盖商户/系统区块内容                                  │
-│  - 创建商品专属区块                                       │
-│  - 隐藏特定商品不需要的区块                               │
-│  - 最高优先级，仅影响单个商品                             │
-└─────────────────────────────────────────────────────────┘
-```
-
-### 查看区块配置
-
-```bash
-# 查看商户级配置（推荐使用 --resolved 查看完整视图）
-commerce section list --resolved
-
-# 查看特定商品的区块配置
-commerce section product list prod-123 --resolved
-```
-
-**关键字段说明**：
-- `source`: 区块来源 (system/merchant/product)
-- `is_hidden`: 是否被隐藏
-- `translations`: 各语言的标题和内容
-
-### 覆盖系统默认区块
-
-```bash
-# 商户级：覆盖所有商品的"护理说明"
-commerce section create \
-  --handle care \
-  --operation-type override \
-  --type collapsible \
-  --position 4 \
-  --content "我们的产品均可机洗，30度冷水。"
-
-# 商品级：为特定商品定制"护理说明"
-commerce section product create prod-123 \
-  --handle care \
-  --operation-type override \
-  --type collapsible \
-  --position 4 \
-  --content "此款真丝产品需要干洗。"
-```
-
-### 创建自定义区块
-
-```bash
-# 商户级：创建"品牌故事"区块（所有商品显示）
-commerce section create \
-  --handle brand-story \
-  --operation-type new \
-  --type collapsible \
-  --position 8 \
-  --content "## 我们的故事\n\n创立于2020年..."
-
-# 商品级：创建"成分说明"区块（仅此商品显示）
-commerce section product create prod-123 \
-  --handle ingredients \
-  --operation-type new \
-  --type collapsible \
-  --position 5 \
-  --content "主要成分：有机棉100%"
-```
-
-### 隐藏不需要的区块
-
-```bash
-# 商户级：隐藏"环保包装"区块（所有商品不显示）
-commerce section hide eco-friendly
-
-# 商品级：隐藏特定商品的"退货政策"
-commerce section product hide prod-123 return
-```
-
-### 添加多语言翻译
-
-```bash
-# 为商户级区块添加中文翻译
-commerce section translation set care \
-  --lang zh-CN \
-  --title "护理说明" \
-  --content "机洗，30度冷水。"
-
-# 为商品级区块添加日文翻译
-commerce section translation set care \
-  --product-id prod-123 \
-  --lang ja-JP \
-  --title "お手入れ方法" \
-  --content "洗濯機で洗えます。水温30度。"
-```
-
-### 调整区块顺序
-
-```bash
-# 商户级排序
-commerce section reorder --sections '[
-  {"handle":"highlights","position":1},
-  {"handle":"details","position":2},
-  {"handle":"care","position":3}
-]'
-
-# 商品级排序
-commerce section product reorder prod-123 --sections '[...]'
-```
-
-### Section 常见问题
-
-#### ❌ 问题：不理解三层继承，直接在商品级创建
-
-**错误做法**：
-```bash
-# 想要所有商品都显示"品牌故事"，却在商品级创建
-commerce section product create prod-123 --handle brand-story ...
-commerce section product create prod-456 --handle brand-story ...  # 重复操作
-```
-
-**✅ 正确做法**：
-```bash
-# 在商户级创建，自动应用到所有商品
-commerce section create --handle brand-story --operation-type new ...
-```
-
-#### ❌ 问题：不使用 --resolved 查看配置
-
-**错误做法**：
-```bash
-# 只看商户自定义，看不到系统默认
-commerce section list
-# 返回空列表（新商户通常没有自定义）
-```
-
-**✅ 正确做法**：
-```bash
-# 使用 --resolved 查看完整的合并后视图
-commerce section list --resolved
-# 返回 System + Merchant 合并后的所有区块
-```
-
-### Section 自然语言映射
-
-当用户说：
-- "查看商品详情页区块" → `commerce section list --resolved`
-- "查看商品X的区块配置" → `commerce section product list <id> --resolved`
-- "修改护理说明" → `commerce section create --handle care --operation-type override ...`
-- "隐藏退货政策区块" → `commerce section hide return`
-- "为商品添加自定义区块" → `commerce section product create <id> --handle XX --operation-type new ...`
-- "添加区块的中文翻译" → `commerce section translation set <handle> --lang zh-CN ...`
-
-## 重要提示
-
-### 首页配置
-- 首页模块支持类型：banner（轮播图）、featured（精选商品）、categories（分类）
-- 模块的 position 决定显示顺序（从小到大）
-- config 字段使用 JSON 格式
-
-### 商品页区块
-- 系统默认区块：highlights, details, guarantee, care, shipping-policies, return, eco-friendly
-- `--resolved` 查看完整合并视图（推荐）
-- `source` 字段标识来源：system | merchant | product
-- 想改所有商品用 `section create`，只改一个商品用 `section product create`
-
-### 通用
-- 使用 `--help` 查看命令详细参数
-- 所有配置创建后需要验证是否正确
-- 定期根据数据分析优化布局和内容