@optima-chat/optima-agent 0.7.10 → 0.8.1

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

@@ -50,6 +50,7 @@ commerce merchant update [选项]
 | `--slug` | 店铺标识（影响 URL） |
 | `--description` | 店铺描述 |
 | `--default-currency` | 默认货币（USD, CNY 等） |
+| `--google-ads-customer-id` | Google Ads 客户 ID（10位数字） |
 
 ### 联系方式
 | 选项 | 说明 |

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

@@ -12,7 +12,8 @@ description: Order fulfillment and shipping management. Process orders, ship pac
 当用户说：
 - "查看待发货订单" → `commerce order list --status paid`
 - "订单XX发货" → 先查订单详情，根据 shipping_mode_used 决定发货方式（见下方流程）
-- "查询订单物流" / "运单标签好了吗" → `commerce order tracking --id XX`
+- "查询订单物流" / "包裹到哪了" → `commerce order tracking --id XX`
+- "运单标签好了吗" / "查标签" → `commerce order refresh-label --id XX`
 - "取消订单XX" → `commerce order cancel --id XX --yes`
 - "标记订单已送达" → `commerce order mark-delivered --id XX`
 - "处理退款" → `commerce refund create --order-id XX --amount YY`
@@ -32,7 +33,7 @@ description: Order fulfillment and shipping management. Process orders, ship pac
 2. **验证订单** - 检查库存、地址、特殊要求
 3. **批量打包** - 准备商品、包装材料、打印面单
 4. **标记发货** - 循环 `commerce order ship --id XX --tracking YY --carrier ZZ`
-5. **物流跟踪** - 定期 `commerce order tracking` 或 `commerce easyship track` 监控异常
+5. **物流跟踪** - 定期 `commerce order tracking` 监控异常
 6. **确认送达** - 签收后 `commerce order mark-delivered --id XX`
 
 ### 发货流程详解（重要）
@@ -101,9 +102,12 @@ commerce order ship --id <order-id> --easyship --courier-id <courier-id>
 | `failed` / `technical_failed` | 生成失败 | 告知用户需要检查 EasyShip 后台或重新发货 |
 
 **查询标签状态**：
+
+如果发货时 label_state 为 pending/generating，稍后使用 `order refresh-label` 从 Easyship 同步最新状态：
 ```bash
-commerce order tracking --id <order-id>
+commerce order refresh-label --id <order-id>
 ```
+返回最新的 `label_state` 和 `label_url`（如已生成）。
 
 **查看可用快递**：
 ```bash
@@ -182,10 +186,16 @@ AskUserQuestion:
       发货成功！运单号 ES123456789，快递公司 FedEx。
       运单标签正在生成中，稍后可以让我帮你查询。
 
-用户：查一下标签好了没
+用户：标签好了吗
+
+助手：[执行 Bash: commerce order refresh-label --id order_abc]
+      [检查返回结果中的 label_state 和 label_url]
 
-助手：[执行 Bash: commerce order tracking --id order_abc]
+      [情况A：label_state = "generated"，有 label_url]
       运单标签已生成，请下载打印后贴在包裹上：https://...
+
+      [情况B：label_state 仍为 "pending" 或 "generating"]
+      运单标签仍在生成中，请稍后再试。
 ```
 
 **场景2：固定运费订单**
@@ -282,7 +292,9 @@ commerce order ship --id order_789 --tracking DHL123458 --carrier DHL
 - `commerce order list` - 查看订单列表
 - `commerce order get` - 查看订单详情
 - `commerce order ship` - 标记订单发货
-- `commerce order tracking` - 查询物流跟踪和标签状态
+- `commerce order tracking` - 查询物流跟踪（含轨迹、预计送达）
+- `commerce order refresh-label` - 刷新 Easyship 运单标签状态
+- `commerce order update-shipping-status` - 更新物流状态
 - `commerce order cancel` - 取消订单
 - `commerce order complete` - 完成订单
 - `commerce order mark-delivered` - 标记已送达
@@ -294,15 +306,9 @@ commerce order ship --id order_789 --tracking DHL123458 --carrier DHL
 - `commerce refund approve` - 批准退款
 - `commerce refund reject` - 拒绝退款
 
-### 物流状态
-- `commerce order tracking` - 查询物流跟踪和标签状态
-- `commerce order update-shipping-status` - 更新物流状态
-- `commerce easyship track` - 查询 Easyship 详细物流轨迹
-
 ### Easyship 集成
 - `commerce easyship couriers` - 查看可用快递公司
 - `commerce easyship rates --order-id <id>` - 获取订单运费报价
-- `commerce easyship track --order-id <id>` - 跟踪 Easyship 运单
 
 ## 详细示例
 
@@ -358,10 +364,8 @@ commerce refund approve --id refund_456
 ### 物流追踪
 ```bash
 # 用户说："查询订单order_123的物流信息"
+# 返回物流轨迹（checkpoints）、预计送达时间、当前状态
 commerce order tracking --id order_123
-
-# 或查询 Easyship 详细轨迹
-commerce easyship track --order-id order_123
 ```
 
 ## 重要提示

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

@@ -1,6 +1,6 @@
 ---
 name: scout
-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."
+description: "Interactive Amazon product research consultant with 1688 supplier sourcing. Search products, analyze markets, find suppliers (by keyword or image), and generate professional reports. ALWAYS use when user asks about: selling products (卖/开店), product ideas (产品/商品), market research (市场/竞品), suppliers (供应商/厂家), sourcing (采购/进货/货源), image search (图片找货/以图搜货/找同款), evaluating business opportunities (生意/创业). Start with conversational exploration, then suggest comprehensive report generation. Uses 'scout search', 'scout product', 'scout supplier-search', and 'scout supplier-search-image' commands."
 ---
 
 # Optima Scout - AI Product Research
@@ -16,6 +16,7 @@ Use this skill when:
 - 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., "成本多少", "批发价", "利润空间")
+- User wants to find suppliers by product image (e.g., "这个图片能找到货源吗", "帮我找同款", "看图找货", "Amazon这个能在1688找到吗")
 
 ## Interaction Style: Conversational → Report
 
@@ -116,33 +117,60 @@ scout product ASIN
 - **Images count** - 7 is standard, fewer = poor optimization
 - **Specifications** - May include BSR in multiple categories
 
-### 3. Search 1688 Suppliers: `scout supplier-search`
+### 3. Search 1688 Suppliers (Keyword): `scout supplier-search`
 
-Search for suppliers on 1688.com to find wholesale sources and manufacturing partners.
+Search for suppliers on 1688.com using keywords.
 
 **Syntax:**
 ```bash
-scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
+scout supplier-search "KEYWORD" --limit NUMBER
 ```
 
 **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)
+- `--format`: Output format - `text` or `json`
 
 **Returns:**
-- Supplier list with product info, pricing, MOQ (minimum order quantity), supplier ratings
+- Supplier list with product info, pricing, MOQ, 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)
+- Supplier details: location, years in business, seller type
 - Tags: shipping policies (退货包运费), payment terms (先采后付), certifications (实力商家)
 
 **Key analysis:**
 - MOQ constraints (minimum order quantity)
-- Price tiers for bulk ordering
 - Supplier type: 生产加工 (manufacturer) vs. 经销批发 (trader)
 - Years in business (8+ years = established)
 - Return rate (lower = better, typical: 30-50%)
 
+### 4. Search 1688 Suppliers (Image): `scout supplier-search-image`
+
+Search for suppliers on 1688.com using product images - perfect for finding sources for products you see on Amazon, Shopify, or other platforms.
+
+**Syntax:**
+```bash
+scout supplier-search-image "IMAGE_URL" --limit NUMBER
+```
+
+**Parameters:**
+- `IMAGE_URL`: Product image URL (Amazon, Alibaba, or any accessible image URL)
+- `--limit`: Number of results (1-100, default: 20)
+- `--format`: Output format - `text` or `json`
+
+**Returns:** Same as `supplier-search` (supplier list, pricing, MOQ, ratings)
+
+**Use cases:**
+- Finding 1688 alternatives for Amazon/Shopify products
+- "找同款" / "看图找货" scenarios
+- Visual products where images are more descriptive than keywords
+- When user provides product image URL
+
+**Important notes:**
+- Works with images from any platform (Amazon, Alibaba, direct URLs)
+- Non-Alibaba images are automatically converted for 1688 search
+- If image is inaccessible (404, expired, auth-required), will return helpful error message
+- **Best practice**: Try both image and keyword search for comprehensive results
+
 ## Research Workflow
 
 ### Interactive Research Flow (Recommended):
@@ -150,10 +178,7 @@ scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
 **Phase 1: Initial Discovery & Discussion**
 1. **Quick Market Scan** → Run 1-2 searches with key terms
 2. **Share Initial Findings** → Present key metrics (price range, competition level, demand signals)
-3. **Discuss with User** → Ask clarifying questions:
-   - "我发现市场上有 X 个竞品，价格区间是 $Y-Z，你的目标价位是多少？"
-   - "看起来高端保温款竞争少，要不要深入看看这个方向？"
-   - "你更关注哪些产品？我可以详细分析"
+3. **Discuss with User** → Ask clarifying questions about target price, market segment, priorities
 
 **Phase 2: Deep Dive & Refinement**
 4. **Targeted Analysis** → Based on user feedback, run `scout product` on relevant ASINs
@@ -161,25 +186,26 @@ scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
 6. **Iterate & Explore** → User may request different keywords, specific competitor analysis, or alternative product categories
 
 **Phase 2.5: Supplier Sourcing (Optional but Recommended)**
-7. **Trigger**: User shows interest in profit margins, costs, or sourcing:
+7. **Trigger**: User shows interest in costs/sourcing, or after market validation
    - "成本大概多少？" "批发价怎么样？" "利润空间大吗？"
    - "哪里进货？" "供应商怎么找？"
-   - Or proactively suggest after market analysis: "要不要我帮你查一下供应商成本？"
-8. **Search 1688 Suppliers**:
-   ```bash
-   scout supplier-search "咖啡机" --limit 10
-   ```
+   - "这个图片能找到货源吗？" "Amazon这个能在1688找到吗？"
+
+8. **Choose search method**:
+   - **With image**: `scout supplier-search-image "https://..."` ← More accurate for visual products
+   - **With keyword**: `scout supplier-search "产品关键词"`
+   - **Best practice**: Try both and compare results
+
 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)**
-11. **Gauge Completion** → After sufficient data gathering, **proactively suggest**:
-   - "我已经收集了足够的数据，要不要我整理成一份完整的市场分析报告？"
-   - "我可以生成一份详细报告，包括市场规模、竞品分析、进入策略和财务预测"
+11. **Gauge Completion** → After sufficient data, suggest: "要不要我整理成一份完整的市场分析报告？"
 12. **Generate Report** → Create comprehensive markdown report with all findings
 13. **Save & Iterate** → Offer to save report and refine based on feedback
 
@@ -187,12 +213,11 @@ scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
 
 ### Alternative: Quick Research Flow
 
-When user explicitly requests a report upfront ("给我一份XX市场分析报告"):
+When user explicitly requests a report upfront:
 1. Run 3-4 diverse keyword searches
 2. Analyze top 3-5 products with `scout product`
-3. Search 1688 suppliers for cost analysis
+3. Search 1688 suppliers (image + keyword)
 4. Generate comprehensive report directly
-5. Offer follow-up discussion after report delivery
 
 ### Multi-Keyword Research Strategy
 
@@ -201,138 +226,77 @@ When user explicitly requests a report upfront ("给我一份XX市场分析报
 scout search "titanium cup" --limit 15
 scout search "titanium mug" --limit 15
 scout search "titanium tumbler" --limit 10
-scout search "camping titanium" --limit 10
 ```
 
 **Why multiple keywords:**
 - Different keywords reveal different market segments
-- Find niche opportunities (e.g., "insulated titanium" vs "camping titanium")
-- Cross-validate market size across searches
-- Discover related products and categories
-
-## Complete Example: Interactive Research Session
-
-**User**: "我想开个店卖钛合金杯子，你觉得合适吗"
-
-**Assistant Phase 1 - Initial Scan:**
-```bash
-scout search "titanium cup" --limit 15
-scout search "titanium mug" --limit 10
-```
-
-**Assistant**: "我先快速看了一下钛合金杯子市场：
-- 市场上有约 50+ 个竞品
-- 价格区间：$15-90，主要集中在 $20-30
-- 头部产品月销约 200 件（看 'recent_sales' 数据）
-- 竞争适中，评论数多在 50-200 之间
-
-我注意到两个方向：
-1. 低价位单层杯（$15-25）- 竞争激烈
-2. 高端保温款（$60-90）- 产品很少
-
-**你更倾向哪个价位段？或者你的目标客户群是什么？**"
-
-**User**: "我想做中高端的，质量好的"
-
-**Assistant Phase 2 - Targeted Deep Dive:**
-```bash
-scout product B0CTKWJDXX  # TOAKS - 中端爆款
-scout product B0DNCMN3NX  # KOYASU - 高端保温款
-scout product B083NLR6BF  # usharedo - 低价参考
-```
+- Find niche opportunities
+- Cross-validate market size
+- Discover related products
 
-**Assistant**: "我详细分析了 3 个代表性产品：
+## Usage Examples
 
-**TOAKS (中端爆款)**
-- BSR #530 → 月销约 250 件
-- 评分 4.7，87% 五星好评
-- 用户最爱：超轻、品质好、无金属味
-- 主要抱怨：散热快（无保温）、无盖子
+### Example 1: Interactive Research (Keyword-based)
 
-**KOYASU (高端保温)**
-- 双层保温，$89.99
-- 评论少（18 条）但 4.8 高分
-- 这个方向竞争少！
-
-**发现机会点：**
-保温款市场几乎空白，但用户需求很强（很多人在评论里说希望有保温功能）。
-
-**要不要我再看看 'titanium tumbler' 这个关键词，专门找保温方向的竞品？**"
-
-**User**: "好的，你看看"
-
-**Assistant Phase 3 - Refined Search:**
-```bash
-scout search "titanium tumbler" --limit 10
-```
+**User**: "我想开个店卖钛合金杯子，你觉得合适吗"
 
-**Assistant**: "找到了！titanium tumbler 搜索结果更聚焦保温款，竞品只有 5-6 个，价格 $60-110。
+**Flow:**
+1. Run `scout search "titanium cup"` + `scout search "titanium mug"`
+2. Share: "市场有50+竞品，价格$15-90，主要在$20-30。头部产品月销约200件。两个方向：低价位($15-25)竞争激烈，高端保温款($60-90)产品很少。你更倾向哪个？"
+3. User: "中高端的，质量好的"
+4. Run `scout product` on 3 representative ASINs (B0CTKWJDXX, B0DNCMN3NX, B083NLR6BF)
+5. Share: "TOAKS中端爆款BSR#530，月销250件，87%五星。用户最爱：超轻、品质好、无金属味。主要抱怨：散热快（无保温）。KOYASU高端保温$89.99，评论少但4.8分。保温款市场几乎空白！"
+6. User: "好的，你看看"
+7. Run `scout search "titanium tumbler"`
+8. Share: "titanium tumbler竞品只5-6个，$60-110。现在查供应商成本？"
+9. Run `scout supplier-search "钛合金保温杯"`
+10. Share: "批发价区间：¥180-450（约$25-65），起订量多数50-100个。头部供应商：8年工厂，¥280批发价。**利润分析**：Amazon售价$70-90，1688成本¥280（约$40），运费+关税约$15，总成本约$55，**毛利率25-40%**。"
+11. Suggest report generation
 
-**现在帮你查一下 1688 供应商成本，看看利润空间？**"
+### Example 2: Image-Based Supplier Search
 
-**User**: "好的"
+**User**: "我在Amazon看到这个蓝牙耳机很火，帮我找1688供应商 https://m.media-amazon.com/images/..."
 
-**Assistant Phase 2.5 - Supplier Sourcing:**
+**Flow:**
 ```bash
-scout supplier-search "钛合金保温杯" --limit 10
+scout supplier-search-image "https://m.media-amazon.com/images/..." --limit 20
 ```
 
-**Assistant**: "找到供应商数据：
-- 批发价区间：¥180-450（约 $25-65）
-- 起订量：多数 50-100 个
-- 头部供应商：8年工厂，¥280 批发价，起订 50 个
-
-**利润空间分析：**
-- Amazon 售价：$70-90
-- 1688 批发价：¥280（约 $40）
-- 运费+关税：约 $15
-- 总成本：约 $55
-- 毛利率：约 25-40%
-
-我现在收集了足够的数据：
-- 4 个关键词搜索
-- 5 个产品深度分析
-- 供应商成本分析
-- 明确的市场空白（保温款）
-
-**要不要我把这些整理成一份完整的市场分析报告？可以包括：**
-- 市场规模和竞争格局
-- 头部产品深度拆解
-- 保温款机会分析
-- 进入策略（定价、差异化、供应链）
-- 财务预测"
+**Response**: "通过图片搜索找到15个供应商：
 
-**User**: "好的，生成报告吧"
+**TOP 3 推荐：**
+1. 深圳某电子厂（8年工厂）
+   - 批发价：¥45-68 | Amazon售价：$89.99
+   - 起订量：50件 | 评分：4.8★
+   - **利润空间：~40-50%**
 
-**Assistant Phase 4 - Generate Report:**
-[Creates comprehensive report: `钛合金杯子市场分析报告.md`]
+2. 东莞某科技（5年工厂）
+   - 批发价：¥38-55 | 起订量：100件
+   - 标签：退货包运费、7天包换
 
-**Assistant**: "报告已生成！核心结论：
-✅ 适合进入，但需专注中高端保温款（$60-90）
-✅ 避开低价位红海，填补保温功能空白
-✅ 预计首年净利润 $17k，ROI 76%
+3. [...]
 
-报告已保存为 `钛合金杯子市场分析报告.md`，需要补充哪些信息吗？"
+要详细对比这几个供应商吗？"
 
-## Competitor Analysis Checklist
+### Example 3: Competitor Analysis
 
-When user asks to analyze a specific product (e.g., "帮我分析一下这个产品 B0788F3R8X"), follow this analysis framework:
+**User**: "帮我分析这个产品 B0788F3R8X"
 
+**Action:**
 ```bash
 scout product B0788F3R8X
 ```
 
 **Analysis Checklist:**
 - ✅ **BSR & Market Position**
-  - Check BSR in specifications
-  - Estimate sales volume from BSR
+  - Check BSR in specifications → estimate sales volume
   - Compare with category averages
 - ✅ **Customer Satisfaction**
   - Rating breakdown (five-star %, one-star %)
   - Total reviews count (market maturity indicator)
   - Review trends over time
 - ✅ **Listing Quality**
-  - Images count (7 is standard)
+  - Images count (7 is standard, fewer = poor optimization)
   - Feature bullets count and quality
   - Product description completeness
   - A+ content presence
@@ -349,37 +313,42 @@ scout product B0788F3R8X
 
 ## Analysis Framework
 
-### Market Viability Assessment
+### Market Viability Quick Reference
 
 | 指标 | 优秀市场 | 正常市场 | 风险市场 |
 |------|---------|---------|---------|
 | 竞品数量 | 10-50 | 5-10 或 50-100 | <5 或 >100 |
-| 头部产品评论数 | 100-1000 | 50-100 或 1000-5000 | <50 或 >5000 |
-| 价格区间 | 宽（有差异化空间） | 中等 | 窄（价格战） |
-| BSR 范围 | 1K-10K | 10K-50K | >50K |
+| 头部评论数 | 100-1000 | 50-100 或 1K-5K | <50 或 >5K |
+| 价格区间 | 宽（差异化） | 中等 | 窄（价格战） |
+| BSR范围 | 1K-10K | 10K-50K | >50K |
+| 进入难度 | 适中 | 需差异化 | 很难或需求不明 |
+
+### Key Metrics
+
+**BSR (Best Seller Rank):**
+- <1K = 月销500+件 | 1K-10K = 100-500件 | 10K-50K = 20-100件 | >50K = <20件
 
-**决策逻辑**：
-- **优秀市场** = 有需求、有空间、竞争适中
-- **正常市场** = 需要差异化或资源投入
-- **风险市场** = 需求不明或红海竞争
+**Rating Breakdown:**
+- 70%+ five-star = 优秀 | 60-70% = 正常 | <60% = 质量问题 | 10%+ one-star = 严重问题
+
+**Market Maturity:**
+- ratings_total >1000 = 成熟 | 100-1000 = 发展中 | <100 = 新兴/小众
 
-### Demand Indicators
+**Demand Signals:**
 
-**High Demand Signals:**
-- ✅ "10K+ bought in past month" 标签
-- ✅ 多个产品 ratings_total > 500
-- ✅ BSR < 10,000 in category
+High Demand:
+- ✅ "10K+ bought in past month"
+- ✅ 多个产品 ratings_total >500
+- ✅ BSR <10K
 - ✅ 搜索结果超过 30 个相关产品
 
-**Low Demand Signals:**
+Low Demand:
 - ⚠️ 少于 10 个搜索结果
 - ⚠️ 头部产品 ratings_total < 50
 - ⚠️ BSR > 100,000
 - ⚠️ 没有 "bought in past month" 标签
 
-### Competitive Landscape
-
-**进入难度评估：**
+**Entry Difficulty Assessment:**
 
 | 维度 | 容易进入 | 中等难度 | 困难进入 |
 |------|---------|---------|---------|
@@ -388,15 +357,14 @@ scout product B0788F3R8X
 | 价格竞争 | 差异化定价 | 价格区间宽 | 价格战 |
 | 评分分布 | <4.5 平均分 | 4.5-4.7 | >4.7（难超越） |
 
-### Report Generation Guidelines
+### Report Generation
 
-**When to suggest report:**
-- ✅ 3+ searches completed with diverse keywords
-- ✅ 3-5 products analyzed in detail (with BSR, reviews, etc.)
-- ✅ User asks synthesizing questions: "所以你觉得呢？" "值得做吗？" "总结一下"
-- ✅ Clear opportunity or risk identified that should be documented
+**When to suggest:**
+- 3+ searches + 3-5 product analyses completed
+- User asks: "所以你觉得呢？" "值得做吗？" "总结一下"
+- Clear opportunity/risk identified that should be documented
 
-**How to suggest report (use this natural template):**
+**How to suggest (use this natural template):**
 ```
 "我已经分析了 X 个搜索和 Y 个竞品，发现了一些有意思的模式。
 
@@ -420,74 +388,36 @@ scout product B0788F3R8X
 - Offer report again later if more data gathered
 
 **Report must include:**
-- **Executive Summary** - 核心结论前置（适合进入？风险是什么？）
-- **Market Analysis** - 基于搜索数据的市场概况
-- **Competitor Deep-Dive** - 基于 product details 的竞品分析（BSR, rating breakdown, top reviews insights）
-- **Opportunity Assessment** - SWOT 或机会/挑战分析
-- **Entry Strategy** - 产品定位、定价、差异化策略
-- **Financial Projections** (optional) - 如果用户需要投资决策
-- **Supplier Analysis** (if Phase 2.5 completed) - 1688 供应商、成本、利润空间
+- Executive Summary（核心结论前置：适合进入？风险是什么？）
+- Market Analysis（基于搜索数据的市场概况）
+- Competitor Deep-Dive（基于product details的竞品分析：BSR, rating breakdown, top reviews insights）
+- Opportunity Assessment（SWOT 或机会/挑战分析）
+- Entry Strategy（产品定位、定价、差异化策略）
+- Supplier Analysis (if Phase 2.5 completed)（1688供应商、成本、利润空间）
 
-**Report naming:**
-- Save as: `{产品类型}市场分析报告.md`
-- Example: `钛合金杯子市场分析报告.md`
-
-## Key Metrics Quick Reference
-
-**BSR (Best Seller Rank):**
-- < 1,000 = 月销 500+ 件
-- 1,000-10,000 = 月销 100-500 件
-- 10,000-50,000 = 月销 20-100 件
-- > 50,000 = 月销 <20 件
-
-**Rating Breakdown:**
-- 70%+ five-star = 优秀产品质量
-- 60-70% five-star = 正常水平
-- <60% five-star = 质量问题或期望不符
-- 10%+ one-star = 严重质量问题
-
-**Market Maturity:**
-- ratings_total >1000 = 成熟市场
-- ratings_total 100-1000 = 发展中市场
-- ratings_total <100 = 新兴市场或小众
-
-**Listing Quality:**
-- 7 images = 标准
-- 5+ feature bullets = 完整
-- A+ content = 专业卖家
+**Report naming:** `{产品类型}市场分析报告.md`
 
 ## Cross-Skill Integration
 
 **TikTok/Instagram → Scout → Supplier 完整链路：**
 
-1. **TikTok/Instagram** - 发现趋势产品
-   ```bash
-   scout tiktok trending --has-product
-   # 或
-   scout instagram reels "产品关键词"
-   ```
-
-2. **Scout (Amazon)** - 验证市场需求
+1. **Discover** (TikTok/Instagram) → Find trending products
+2. **Validate** (Scout Amazon) → Verify market demand
    ```bash
    scout search "product name" --limit 15
    scout product <top_asin>
    ```
-
-3. **Scout (1688)** - 找供应商和成本
+3. **Source** (Scout 1688) → Find suppliers and cost
    ```bash
-   scout supplier-search "产品关键词" --limit 10
-   ```
+   # Method A: Image search (recommended for visual match)
+   scout supplier-search-image "https://amazon-image-url"
 
-4. **决策** - 综合分析：
-   - TikTok/Instagram 验证内容热度
-   - Amazon 验证购买需求和竞争
-   - 1688 验证供应链和利润空间
-   - 三者都通过 → 值得做
+   # Method B: Keyword search
+   scout supplier-search "产品关键词"
 
-**Proactive suggestion after cross-skill analysis:**
-"我已经分析了：
-- TikTok 内容热度（X 个热门视频）
-- Amazon 市场需求（价格 $Y, BSR Z）
-- 1688 供应商成本（批发价 ¥W，起订 Q 个）
+   # Best: Try both
+   ```
+4. **Decide** →综合分析三者数据，都通过→值得做
 
-要不要生成一份完整的产品机会分析报告？"
+**Proactive suggestion after cross-skill analysis:**
+"我已经分析了TikTok热度、Amazon市场需求、1688供应商成本。要不要生成一份完整的产品机会分析报告？"

package/.claude/skills/shipping/SKILL.md

@@ -129,7 +129,7 @@ commerce shipping-zone delete --id <区域ID> --yes
 
 ## Easyship 集成
 
-Easyship 提供实时国际运费报价和物流追踪。
+Easyship 提供实时国际运费报价。
 
 ### 查看可用快递
 ```bash
@@ -162,10 +162,8 @@ commerce easyship validate-address \
 ```
 
 ### 物流追踪
-```bash
-# 查询 Easyship 运单详细轨迹
-commerce easyship track --order-id <订单ID>
-```
+
+物流追踪功能已统一到 `commerce order tracking` 命令（见 order skill）。
 
 ---
 
@@ -192,7 +190,6 @@ commerce easyship track --order-id <订单ID>
 - `commerce easyship get-origin` - 查看发货地址
 - `commerce easyship validate-origin` - 验证发货地址
 - `commerce easyship validate-address` - 验证买家地址
-- `commerce easyship track` - 物流追踪
 
 **更新发货地址**用 `commerce merchant update --origin-*`（见 merchant skill）
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.7.10",
+  "version": "0.8.1",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",
@@ -42,11 +42,11 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.1.55",
+    "@optima-chat/ads-cli": "latest",
     "@optima-chat/bi-cli": "latest",
     "@optima-chat/comfy-cli": "latest",
     "@optima-chat/commerce-cli": "latest",
-    "@optima-chat/ads-cli": "latest",
-    "@optima-chat/scout-cli": "latest",
+    "@optima-chat/scout-cli": "^0.8.0",
     "open": "^10.1.0",
     "ws": "^8.18.3",
     "zod": "^3.23.8"