@optima-chat/optima-agent 0.8.0 → 0.8.2

package/.claude/settings.local.json

@@ -110,7 +110,10 @@
       "Bash(scout:*)",
       "WebFetch(domain:docs.scrapecreators.com)",
       "WebFetch(domain:scrapecreators.com)",
-      "Bash(gh auth status:*)"
+      "Bash(gh auth status:*)",
+      "Bash(optima-agent:*)",
+      "Bash(python3:*)",
+      "Bash(python3 -c \" import sys content = sys.stdin.read\\(\\) # Find flushMessageQueueSync idx = content.find\\(''flushMessageQueueSync''\\) # Get context around it lines = content.split\\(''\\\\n''\\) for i, line in enumerate\\(lines\\): if ''flushMessageQueueSync'' in line and ''private'' in line: for j in range\\(i, min\\(i+20, len\\(lines\\)\\)\\): print\\(f''{j+1}: {lines[j]}''\\) break \")"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/instagram/SKILL.md

@@ -13,6 +13,32 @@ description: Instagram influencer marketing and content research. Use when user
 - "搜索瑜伽相关的Reels" → `scout instagram reels "yoga" --limit 30`
 - "这个Reel为什么火" + URL → `scout instagram reel-insights <url>`
 - "看看XX发了什么内容" → `scout instagram creator-reels @username`
+- 用户发 Instagram Reel/帖子链接 → `scout instagram reel-insights "<url>"`
+- 用户发 Instagram 个人主页链接 → 提取 username → `scout instagram profile @username`
+
+---
+
+## URL 解析 - Instagram 链接处理
+
+用户经常直接贴 Instagram 链接。**不要用 WebFetch**（需要登录），按以下规则解析：
+
+| URL 特征 | 处理方式 | 调用命令 |
+|----------|---------|---------|
+| `instagram.com/reel/XXXX` | 完整 URL | `scout instagram reel-insights "<url>"` |
+| `instagram.com/p/XXXX` | 完整 URL | `scout instagram reel-insights "<url>"` |
+| `instagram.com/reels/XXXX` | 完整 URL | `scout instagram reel-insights "<url>"` |
+| `instagram.com/username` (无 /reel/ /p/) | 提取 username | `scout instagram profile @username` |
+
+**示例**：
+```bash
+# Reel / Post 链接 → 直接传入
+scout instagram reel-insights "https://www.instagram.com/reel/ABC123DEF/"
+
+# 个人主页 → 提取 username
+scout instagram profile @beautyguru
+```
+
+---
 
 ### 场景决策表
 

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

@@ -17,6 +17,7 @@ Use this skill when:
 - 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找到吗")
+- User shares an Amazon product link (e.g., amazon.com/dp/XXXX, amzn.to/XXXX)
 
 ## Interaction Style: Conversational → Report
 
@@ -36,6 +37,27 @@ Use this skill when:
 - User explicitly requests: "给我一份XX市场分析报告"
 - In this case, skip conversation and generate report directly
 
+## URL 解析 - Amazon 链接处理
+
+用户贴 Amazon 链接时，**不要用 WebFetch**（会被反爬拦截），提取 ASIN 后用 `scout product`：
+
+| URL 格式 | ASIN 位置 |
+|----------|----------|
+| `amazon.com/dp/XXXXXXXXXX` | `/dp/` 后 10 位 |
+| `amazon.com/gp/product/XXXXXXXXXX` | `/gp/product/` 后 10 位 |
+| `amzn.to/XXXX` (短链) | 用 `curl -sI "https://amzn.to/XXXX"` 从 Location header 获取完整 URL → 提取 ASIN |
+
+```bash
+# 1. 提取 ASIN → 获取产品详情
+scout product B08BHXG144
+
+# 2. 如果用户想了解市场竞争
+scout search "产品关键词" --limit 15
+
+# 3. 如果用户想找供应商
+scout supplier-search "中文关键词"
+```
+
 ## Quick Start - First Step
 
 When user asks about product opportunities or market research:

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/.claude/skills/tiktok/SKILL.md

@@ -70,6 +70,35 @@ scout tiktok trending --region UK --time-period 7d --limit 20
 - "这个视频数据怎么样" + URL → `scout tiktok video-insights <url>`
 - "TikTok热门话题" → `scout tiktok hashtags`
 - "看看XX网红推广什么产品" → `scout tiktok creator-products @username`
+- 用户发 TikTok Shop 产品链接 → 提取 productId → `scout tiktok shop-product <productId>`
+- 用户发 TikTok 视频链接 → `scout tiktok video-insights "<url>"`
+- 用户发 TikTok 达人主页链接 → 提取 username → `scout tiktok creator-products @username`
+
+---
+
+## URL 解析 - TikTok 链接处理
+
+用户经常直接贴 TikTok 链接。**不要用 WebFetch**（会被登录墙拦截），按以下规则解析：
+
+| URL 特征 | 提取内容 | 调用命令 |
+|----------|---------|---------|
+| 含 `/product/` 或 `productId=` | productId (数字) | `scout tiktok shop-product <productId>` |
+| 含 `/@user/video/` | 完整 URL | `scout tiktok video-insights "<url>"` |
+| `vm.tiktok.com/XXXX` 或 `tiktok.com/t/XXXX` | 完整 URL | `scout tiktok video-insights "<url>"` |
+| `tiktok.com/@username` (无 /video/) | username | `scout tiktok creator-products @username` |
+
+**示例**：
+```bash
+# 产品链接 → 提取 productId
+# https://www.tiktok.com/view/product/1729991116834247323
+scout tiktok shop-product 1729991116834247323
+
+# 视频链接 → 直接传入（支持各种格式，API 自动解析）
+scout tiktok video-insights "https://www.tiktok.com/@user/video/7456789012345"
+
+# 达人主页 → 提取 username
+scout tiktok creator-products @username --sort popular --limit 30
+```
 
 ---
 

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,CA6GxC"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,CA+HxC"}

package/dist/src/system-prompt.js

@@ -58,6 +58,24 @@ export function getSystemPrompt() {
 4. **提供上下文** - 执行结果后给出简要说明和后续建议
 5. **错误时诊断** - 遇到错误时分析原因并给出解决方案
 
+## 链接处理规则
+
+当用户发送电商平台链接时，**不要用 WebFetch 访问**（会被反爬拦截），提取标识符后调用对应的 scout CLI 命令：
+
+| URL 特征 | 提取内容 | 调用命令 |
+|----------|---------|---------|
+| \`amazon.com/dp/XXXX\` 或 \`/gp/product/XXXX\` | ASIN (10位字母数字) | \`scout product <ASIN>\` |
+| \`amzn.to/XXXX\` (短链) | 用 \`curl -sI\` 获取重定向 URL → 提取 ASIN | \`scout product <ASIN>\` |
+| \`tiktok.com\` 含 \`/product/XXXX\` | productId (数字) | \`scout tiktok shop-product <productId>\` |
+| \`tiktok.com/@user/video/XXXX\` | 完整 URL | \`scout tiktok video-insights "<url>"\` |
+| \`vm.tiktok.com/XXXX\` 或 \`tiktok.com/t/XXXX\` | 完整 URL | \`scout tiktok video-insights "<url>"\` |
+| \`tiktok.com/@username\` (无 /video/) | username | \`scout tiktok creator-products @username\` |
+| \`instagram.com/reel/XXXX\` 或 \`/p/XXXX\` | 完整 URL | \`scout instagram reel-insights "<url>"\` |
+| \`instagram.com/username\` (无 /reel/ /p/) | username | \`scout instagram profile @username\` |
+| \`1688.com/offer/XXXX\` | 请用户描述产品或从 URL 路径提取关键词 | \`scout supplier-search "关键词"\` |
+
+**重要**：这些平台有反爬机制，WebFetch 必然失败。始终使用 scout CLI 获取数据。
+
 ## 输出风格
 
 - 简洁明了，不废话

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;;;;;;;;;aASI,OAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsF9B,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;;;;;;;;;aASI,OAAO,IAAI,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwG9B,CAAC;AACF,CAAC"}

package/package.json

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