@optima-chat/optima-agent 0.4.30 → 0.4.32

package/.claude/settings.local.json

@@ -0,0 +1,79 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh api:*)",
+      "WebFetch(domain:platform.claude.com)",
+      "Bash(git init:*)",
+      "Bash(mkdir:*)",
+      "Bash(npm run typecheck:*)",
+      "Bash(npm view:*)",
+      "WebSearch",
+      "Bash(commerce --help)",
+      "Bash(done)",
+      "Bash(commerce product:*)",
+      "Bash(commerce order:*)",
+      "Bash(commerce i18n:*)",
+      "Bash(google-ads:*)",
+      "Bash(scout --help:*)",
+      "Bash(tree:*)",
+      "Bash(cloc:*)",
+      "Bash(npm run build:*)",
+      "Bash(git restore:*)",
+      "Bash(gh repo view:*)",
+      "Bash(mv:*)",
+      "Bash(rmdir:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push)",
+      "Bash(timeout 5 npm run optima:*)",
+      "Bash(npm install:*)",
+      "Bash(cat:*)",
+      "Bash(gh issue create:*)",
+      "Bash(npx tsx:*)",
+      "Bash(timeout 30 npx tsx:*)",
+      "Bash(git push origin feature/ask-user-question)",
+      "Bash(node:*)",
+      "Bash(npm version:*)",
+      "Bash(git push:*)",
+      "Bash(npm publish:*)",
+      "Bash(pkill:*)",
+      "Bash(git -C /Users/verypro/optima-agent log --oneline --all -- \".claude/\")",
+      "Bash(wc:*)",
+      "Bash(grep:*)",
+      "Bash(find:*)",
+      "Bash(commerce collection --help:*)",
+      "Bash(commerce collection update --help:*)",
+      "Bash(commerce collection set-cover:*)",
+      "Bash(commerce collection get --help:*)",
+      "Bash(commerce collection list --help:*)",
+      "Bash(commerce collection create --help:*)",
+      "Bash(commerce collection remove-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:*)",
+      "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:*)",
+      "Bash(commerce homepage create-banner:*)",
+      "Bash(xargs -I {} sh -c 'echo \"\"\"\"=== {} ===\"\"\"\"; head -3 /Users/verypro/optima-agent/.claude/skills/{}/SKILL.md | grep \"\"\"\"name:\"\"\"\"')",
+      "Bash(ls:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

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

@@ -1,101 +1,104 @@
 ---
 name: merchant
-description: "店铺管理和信息查询。使用场景：查看店铺信息(merchant info/店铺信息/商户信息)、更新店铺配置(update merchant/更新店铺)、查看店铺设置。使用 commerce merchant 命令。"
+description: "店铺基础信息管理。使用场景：查看店铺信息、更新店铺名称/描述/联系方式/发货地址。注意：运费设置用 shipping skill。"
 ---
 
 # 店铺管理
 
-## 标准操作
+## 典型场景
 
-### 查看店铺信息
-```bash
-commerce merchant info
-```
-返回店铺的完整信息：
-- 店铺名称、标识、描述
-- 默认货币、状态
-- 联系信息、发货地址
-- 创建和更新时间
+| 用户说 | 命令 |
+|--------|------|
+| "查看店铺信息" / "我的店铺" | `commerce merchant info` |
+| "修改店铺名称" / "更新店铺描述" | `commerce merchant update --name/--description` |
+| "设置联系方式" | `commerce merchant update --contact-*` |
+| "更新发货地址" | `commerce merchant update --origin-*` |
 
-### 更新店铺信息
-```bash
-commerce merchant update --name "新店铺名" --description "描述" --default-currency USD
-```
+## 不在此模块（重要）
+
+| 用户说 | 正确位置 |
+|--------|----------|
+| "运费设置" / "运费模式" / "运费区域" | **shipping skill**：`commerce shipping get-mode` |
+| "Easyship" / "快递公司" | **shipping skill**：`commerce easyship couriers` |
+| "Stripe/支付设置" | `commerce stripe status` |
+| "首页设置" | **homepage skill** |
 
-可更新的字段：
-- `--name`: 店铺名称
-- `--slug`: 店铺标识（URL 友好）
-- `--description`: 店铺描述
-- `--default-currency`: 默认货币（USD, CNY, EUR 等）
-- `--contact-name`: 联系人姓名
-- `--contact-phone`: 联系电话
-- `--contact-email`: 联系邮箱
-- `--company-name`: 公司名称
-- `--origin-*`: 发货地址字段（origin-country-alpha2, origin-city, origin-postal-code 等）
+---
 
-## 完整命令列表
+## 查看店铺信息
 
 ```bash
-# 查看店铺信息
 commerce merchant info
+```
 
-# 更新基本信息
-commerce merchant update --name "我的店铺" --description "这是一个很棒的店铺"
-
-# 更新联系信息
-commerce merchant update --contact-name "张三" --contact-phone "1234567890" --contact-email "contact@example.com"
-
-# 更新发货地址
-commerce merchant update --origin-country-alpha2 "CN" --origin-city "深圳" --origin-postal-code "518000"
+返回：店铺名称、描述、Logo、货币、联系信息、发货地址
 
-# 更新多个字段
-commerce merchant update --name "新店铺" --default-currency "CNY" --company-name "我的公司"
-```
+**注意**：此命令不返回运费设置，运费相关请用 `commerce shipping get-mode`
 
-## 工作流示例
+---
 
-### 示例 1：查看店铺基本信息
-用户："查看我的店铺信息"
+## 更新店铺信息
 
 ```bash
-commerce merchant info
+commerce merchant update [选项]
 ```
 
-展示表格格式的店铺信息，包括：
-- 店铺名称、标识、描述
-- 货币、状态、创建时间
-- 联系信息（如有）
-- 发货地址（如有）
+### 基础信息
+| 选项 | 说明 |
+|------|------|
+| `--name` | 店铺名称 |
+| `--slug` | 店铺标识（影响 URL） |
+| `--description` | 店铺描述 |
+| `--default-currency` | 默认货币（USD, CNY 等） |
+
+### 联系方式
+| 选项 | 说明 |
+|------|------|
+| `--contact-name` | 联系人 |
+| `--contact-phone` | 联系电话 |
+| `--contact-email` | 联系邮箱 |
+| `--company-name` | 公司名称 |
+
+### 发货地址
+| 选项 | 说明 |
+|------|------|
+| `--origin-country-alpha2` | 国家代码（CN, US 等） |
+| `--origin-city` | 城市 |
+| `--origin-postal-code` | 邮编 |
+| `--origin-line-1` | 地址行1 |
+| `--origin-line-2` | 地址行2 |
+| `--origin-state` | 省/州 |
+
+---
 
-### 示例 2：完善店铺信息
-用户："帮我设置店铺的联系方式和地址"
+## 示例
 
 ```bash
+# 更新名称和描述
+commerce merchant update --name "我的小店" --description "精选好物"
+
+# 更新联系方式
 commerce merchant update \
   --contact-name "张三" \
   --contact-phone "13800138000" \
-  --contact-email "shop@example.com" \
-  --origin-country-alpha2 "CN" \
-  --origin-city "深圳" \
-  --origin-postal-code "518000"
-```
+  --contact-email "shop@example.com"
 
-### 示例 3：修改店铺名称
-用户："把店铺名改成'全球精品小店'"
-
-```bash
-commerce merchant update --name "全球精品小店"
+# 更新发货地址
+commerce merchant update \
+  --origin-country-alpha2 CN \
+  --origin-city 深圳 \
+  --origin-postal-code 518000 \
+  --origin-line-1 "科技园路1号" \
+  --origin-state 广东
 ```
 
-## 注意事项
+---
+
+## 命令参考
 
-- 店铺标识（slug）修改后会影响店铺 URL
-- 货币修改不会影响已创建的商品价格
-- 联系信息和发货地址建议完整填写
-- 更新后建议用 `commerce merchant info` 验证
+- `commerce merchant info` - 查看店铺信息
+- `commerce merchant update` - 更新店铺信息
 
-## 相关命令
+## 不确定用什么命令？
 
-- 查看商品：`commerce product list`
-- 查看订单：`commerce order list`
-- 查看集合：`commerce collection list`
+运行 `commerce --help` 查看所有模块，或 `commerce merchant --help` 查看子命令。

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

@@ -15,7 +15,6 @@ description: Order fulfillment and shipping management. Process orders, ship pac
 - "查询订单物流" / "运单标签好了吗" → `commerce order tracking --id XX`
 - "取消订单XX" → `commerce order cancel --id XX --yes`
 - "标记订单已送达" → `commerce order mark-delivered --id XX`
-- "查询运费" → `commerce shipping calculate --country XX --weight YY`
 - "处理退款" → `commerce refund create --order-id XX --amount YY`
 
 ### 场景决策表
@@ -26,15 +25,14 @@ description: Order fulfillment and shipping management. Process orders, ship pac
 | 批量发货 | 循环 `order ship` | 必须有真实tracking号，避免虚假发货 |
 | 取消订单 | `order cancel --yes` | 检查是否已发货，避免错误取消 |
 | 处理退款 | `refund create` → `refund approve` | 先创建后审批，保留审计记录 |
-| 运费查询 | `shipping calculate` | 提供准确重量和邮编，避免运费纠纷 |
-| 物流异常 | `shipping track` → `shipping update-status` | 主动更新状态，及时通知客户 |
+| 物流异常 | `order tracking` → `order update-shipping-status` | 主动更新状态，及时通知客户 |
 
 ### 标准订单履行流程
 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 tracking` 或 `commerce easyship track` 监控异常
 6. **确认送达** - 签收后 `commerce order mark-delivered --id XX`
 
 ### 发货流程详解（重要）
@@ -295,10 +293,10 @@ commerce order ship --id order_789 --tracking DHL123458 --carrier DHL
 - `commerce refund approve` - 批准退款
 - `commerce refund reject` - 拒绝退款
 
-### 物流管理
-- `commerce shipping calculate` - 计算运费
-- `commerce shipping track` - 物流追踪
-- `commerce shipping update-status` - 更新物流状态
+### 物流状态
+- `commerce order tracking` - 查询物流跟踪和标签状态
+- `commerce order update-shipping-status` - 更新物流状态
+- `commerce easyship track` - 查询 Easyship 详细物流轨迹
 
 ### Easyship 集成
 - `commerce easyship couriers` - 查看可用快递公司
@@ -344,15 +342,6 @@ commerce order cancel \
 commerce order mark-delivered --id order_789
 ```
 
-### 计算运费
-```bash
-# 用户说："计算寄到美国纽约10001的运费，重量0.5kg"
-commerce shipping calculate \
-  --country US \
-  --postal-code 10001 \
-  --weight 0.5
-```
-
 ### 处理退款
 ```bash
 # 用户说："订单order_123要退款150美元"
@@ -367,8 +356,11 @@ commerce refund approve --id refund_456
 
 ### 物流追踪
 ```bash
-# 用户说："查询快递单号DHL123456的物流信息"
-commerce shipping track --tracking-number DHL123456
+# 用户说："查询订单order_123的物流信息"
+commerce order tracking --id order_123
+
+# 或查询 Easyship 详细轨迹
+commerce easyship track --order-id order_123
 ```
 
 ## 重要提示

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

@@ -58,9 +58,9 @@ done
 # 1. 查找目标商品
 commerce product list --query "T恤" --limit 50
 
-# 2. 批量更新价格和促销标签
-commerce product update --id prod_123 --price 79 --tags "featured,sale"
-commerce product update --id prod_456 --price 79 --tags "featured,sale"
+# 2. 批量更新价格和促销标签（设置原价显示折扣）
+commerce product update --id prod_123 --price 79 --original-price 99 --tags "featured,sale"
+commerce product update --id prod_456 --price 79 --original-price 99 --tags "featured,sale"
 ```
 
 ### 场景5：商品图片更新
@@ -73,6 +73,18 @@ commerce upload image --path ./new-photo.jpg  # 获得 media_new
 commerce product add-images --id prod_123 --media-id media_new
 ```
 
+### 场景6：创建促销商品
+**任务**: 创建带折扣显示的商品（显示划线价）
+```bash
+# 创建促销商品：售价79，原价99（显示划线价）
+commerce product create \
+  --title "夏日特惠T恤" \
+  --price 79 \
+  --original-price 99 \
+  --stock 100 \
+  --tags "sale"
+```
+
 ### 场景决策表
 
 | 用户需求 | 推荐命令 | 关键注意点 |
@@ -81,8 +93,24 @@ commerce product add-images --id prod_123 --media-id media_new
 | 多规格商品 | `product create` + `variant create` | 主商品设置基础价格，变体设置差异价 |
 | 批量上架 | 脚本循环 `product create` | 复用共享图片的media_id，避免重复上传 |
 | 更新价格 | `product update --price` | 如有变体，需逐个更新变体价格 |
+| 促销商品 | `product create --original-price` | `--original-price` 必须大于 `--price` |
 | 促销标签 | `product update --tags` | 用逗号分隔，保留原有标签 |
 | 图片更新 | `upload` + `add-images` | 先上传再关联，不要直接删除旧图 |
+| 删除商品 | `product delete` | **软删除**，商品状态变为 archived |
+| 下架商品 | `product update --status inactive` | 暂时隐藏，可随时恢复 |
+
+## 商品状态说明（重要）
+
+| 状态 | 含义 | 用户可能说 |
+|------|------|-----------|
+| `active` | 正常上架，买家可见 | "上架"、"发布" |
+| `inactive` | 暂时下架，买家不可见 | "下架"、"隐藏" |
+| `draft` | 草稿，未发布 | "草稿"、"暂存" |
+| `archived` | **已删除（软删除）**，数据保留 | "删除"、"移除" |
+
+**`product delete` = 软删除**：删除商品会将状态设为 `archived`，数据保留但不再显示。
+
+**已归档商品不需要再删除**：如果商品状态已经是 `archived`，告诉用户"商品已删除"。
 
 ## 卓越标准
 
@@ -184,9 +212,12 @@ commerce product create --title "T恤" --price 99 --stock 50  # 确保真实有5
 
 当用户说：
 - "创建XX商品，价格YY" → `commerce product create --title XX --price YY`
+- "创建XX商品，售价YY，原价ZZ" → `commerce product create --title XX --price YY --original-price ZZ`
+- "创建促销商品，价格79，划线价99" → `commerce product create --title XX --price 79 --original-price 99`
 - "上传商品图片" → `commerce upload image --path ./photo.jpg`
 - "添加商品变体" → `commerce variant create --product-id XX --sku YY`
 - "更新商品价格" → `commerce product update --id XX --price YY`
+- "设置商品原价/划线价" → `commerce product update --id XX --original-price YY`
 - "给商品打标签" → `commerce product update --id XX --tags "featured,new"`
 - "设置商品重量和尺寸" → `commerce product update --id XX --weight 0.5 --length 10 --width 8 --height 5`
 - "查看所有商品" → `commerce product list`

package/.claude/skills/scout/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: scout
-description: "Interactive Amazon product research consultant. Search products, analyze markets, and generate professional reports. ALWAYS use when user asks about: selling products (卖/开店), product ideas (产品/商品), market research (市场/竞品), evaluating business opportunities (生意/创业). Start with conversational exploration, then suggest comprehensive report generation. Uses 'scout search' and 'scout product' commands."
+description: "Interactive Amazon product research consultant with 1688 supplier sourcing. Search products, analyze markets, find suppliers, and generate professional reports. ALWAYS use when user asks about: selling products (卖/开店), product ideas (产品/商品), market research (市场/竞品), suppliers (供应商/厂家), sourcing (采购/进货/货源), evaluating business opportunities (生意/创业). Start with conversational exploration, then suggest comprehensive report generation. Uses 'scout search', 'scout product', and 'scout supplier-search' commands."
 ---
 
 # Optima Scout - AI Product Research
@@ -13,6 +13,9 @@ Use this skill when:
 - User asks about product pricing, ratings, sales data, or market trends
 - User wants to evaluate business opportunities or find products to sell
 - User needs detailed competitor analysis or listing quality assessment
+- User needs to find suppliers or manufacturers (e.g., "帮我找咖啡机供应商", "哪里进货")
+- User wants to source products from 1688/Alibaba China
+- User asks about wholesale prices, bulk purchasing costs, or profit margins (e.g., "成本多少", "批发价", "利润空间")
 
 ## Interaction Style: Conversational → Report
 
@@ -115,6 +118,38 @@ scout product ASIN
 - Images count - Assess listing quality (7 images is standard)
 - Specifications - May include BSR in multiple categories
 
+### 3. Search 1688 Suppliers: `scout supplier-search`
+
+Search for suppliers on 1688.com to find wholesale sources and manufacturing partners.
+
+**Syntax:**
+```bash
+scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
+```
+
+**Parameters:**
+- `KEYWORD`: Product keywords in Chinese (e.g., "咖啡机", "蓝牙耳机", "钛合金杯子")
+- `--limit`: Number of results (1-100, default: 20)
+- `--format`: Output format - `text` (human-readable) or `json` (for data processing)
+
+**Returns:**
+- Supplier list with product info, pricing, MOQ (minimum order quantity), supplier ratings
+- Price tiers for bulk ordering (e.g., "2~49台: ¥599", "≥100台: ¥429")
+- Supplier details: name, location, years in business, seller type (manufacturer vs. trader)
+- Tags: shipping policies (退货包运费), payment terms (先采后付), certifications (实力商家)
+
+**When to use:**
+- After Amazon market research - find potential suppliers for cost analysis
+- User asks about costs, margins, or sourcing
+- Calculating profit margins (Amazon price - 1688 wholesale cost)
+- Identifying manufacturing vs. trading suppliers
+- Before generating final report - include supplier data for complete analysis
+
+**Example:**
+```bash
+scout supplier-search "咖啡机" --limit 10
+```
+
 ## Research Workflow
 
 ### Interactive Research Flow (Recommended):
@@ -135,6 +170,22 @@ scout product ASIN
    - Specific competitor analysis
    - Alternative product categories
 
+**Phase 2.5: Supplier Sourcing (Optional but Recommended)**
+7. **Trigger**: User shows interest in profit margins, costs, or sourcing:
+   - "成本大概多少？" "批发价怎么样？" "利润空间大吗？"
+   - "哪里进货？" "供应商怎么找？"
+   - Or proactively suggest after market analysis: "要不要我帮你查一下供应商成本？"
+8. **Search 1688 Suppliers**:
+   ```bash
+   scout supplier-search "咖啡机" --limit 10
+   ```
+9. **Share Findings**:
+   - Wholesale price range (e.g., ¥429-599)
+   - MOQ (minimum order quantity)
+   - Profit margin calculation: Amazon price ($60-80) - 1688 cost (¥429 ≈ $60) - shipping ($10-15)
+   - Supplier quality indicators (years in business, certifications)
+10. **Ask**: "要不要我详细分析几个供应商？" or proceed to report
+
 **Phase 3: Report Generation (Proactive Suggestion)**
 7. **Gauge Completion** → After sufficient data gathering, **proactively suggest**:
    - "我已经收集了足够的数据，要不要我整理成一份完整的市场分析报告？"
@@ -347,6 +398,45 @@ scout product B0788F3R8X
   - Price positioning
   - Brand strength
 
+### Example 5: Complete Market Research + Supplier Sourcing
+**User**: "我想卖咖啡机，帮我做市场调研"
+
+**Phase 1 - Amazon Market Research:**
+```bash
+scout search "coffee maker" --limit 15
+scout product B08BHXG144  # Top seller analysis
+```
+
+**Assistant**: "咖啡机市场很活跃：
+- 价格区间：$30-150，主流在 $60-80
+- 头部产品月销 1000+ 件，需求强劲
+- 竞争激烈但市场容量大
+
+**现在帮你查一下 1688 供应商成本，看看利润空间**"
+
+**Phase 2 - Supplier Sourcing:**
+```bash
+scout supplier-search "咖啡机" --limit 10
+```
+
+**Assistant**: "找到供应商数据：
+- 批发价区间：¥120-580（约 $17-80）
+- 起订量：多数 2-10 台
+- 头部供应商：容凯严选工厂，¥429-599，起订 2 台
+
+**利润空间分析：**
+- Amazon 售价：$60-80
+- 1688 批发价：¥429（约 $60）
+- 运费+关税：约 $10-15
+- 毛利率：约 15-25%（扣除平台费用后）
+
+市场有需求，成本可控，利润空间合理。要详细分析吗？"
+
+**User**: "好的，生成报告吧"
+
+**Phase 3 - Generate Report with Supplier Data:**
+[Creates comprehensive report including both Amazon market analysis AND 1688 supplier costs]
+
 ## Output Format
 
 Commands return structured JSON with product data and metadata. Key fields:
@@ -446,6 +536,31 @@ Commands return structured JSON with product data and metadata. Key fields:
 - Offer follow-up analysis: "要不要看看相关品类？"
 - Point out data limitations honestly
 
+### 8. Amazon + 1688 Integrated Analysis
+**Principle:** Complete market research includes both demand analysis (Amazon) and supply chain research (1688).
+
+**When to search 1688:**
+- ✅ After identifying promising products on Amazon
+- ✅ User asks about costs, margins, or sourcing
+- ✅ Before generating final report (include supplier data for complete picture)
+- ✅ User explicitly asks about suppliers or wholesale prices
+
+**How to present:**
+- Compare Amazon prices vs. 1688 wholesale costs
+- Calculate rough profit margins (consider shipping, tariffs, platform fees)
+- Highlight MOQ constraints (minimum order quantity)
+- Identify manufacturing vs. trading suppliers (生产加工 vs. 贸易商)
+
+**Example flow:**
+1. Search Amazon → Identify $60-80 price point for coffee makers
+2. Search 1688 → Find ¥429 ($60) wholesale price, MOQ 2 units
+3. Calculate margin → ~20% after fees and shipping
+4. Recommendation → Feasible opportunity with reasonable margins
+
+**Proactive suggestion:**
+After sufficient Amazon research, proactively offer:
+"我已经分析了 Amazon 市场，要不要我帮你查一下 1688 供应商成本，看看利润空间？"
+
 ## Tips
 
 **Sales & Demand:**