@optima-chat/optima-agent 0.9.29 → 0.9.30

package/.claude/skills/gen/SKILL.md

@@ -305,7 +305,7 @@ gen task retry <task_id>          # 重试失败的任务
 |---|---|---|
 | `UPSTREAM_MAINTENANCE` | **不立即重试**。告知用户服务维护中，建议 5-10 分钟后再试 | "图片生成服务正在维护，建议 5-10 分钟后我再帮您试一次" |
 | `CONTENT_POLICY_VIOLATION` | **改写 prompt** 去掉敏感/违规元素，自动重试**最多 1 次**。仍失败再交给用户 | "您的描述触发了内容审核，我换个说法重试：……" |
-| `UPSTREAM_TIMEOUT` | 立即重试 1 次（静默） | （重试成功就别提；连续失败再说） |
+| `UPSTREAM_TIMEOUT` | 立即用链中**下一个**模型重试 1 次（链：`nano-banana-fast` → `nano-banana-pro` → `flux-kontext-max`）。两次都失败 → 告知用户，**禁止用 Python/本地库 fallback**（见反面示例最后一条） | "图片编辑服务暂时不可用，请稍后再试" |
 | `UPSTREAM_RATE_LIMITED` | 等 30 秒后重试 1 次 | "请求频率过高，稍等几十秒再试" |
 | `UPSTREAM_NETWORK` | 立即重试 1 次（静默） | （同 timeout） |
 | `PROVIDER_INSUFFICIENT_CREDITS` | **不重试**。明确告诉用户问题不在他、不在他的余额 | "生成服务后端额度不足（与您账户余额无关），已记录" |
@@ -319,9 +319,18 @@ gen task retry <task_id>          # 重试失败的任务
 4. `success: false`（CLI 本身报错）直接报给用户，不重试
 5. 没有 `error_code` 字段的旧版响应：当作 `UPSTREAM_UNKNOWN` 处理
 
+**注**：上面 `UPSTREAM_TIMEOUT` 表格里的 fallback 链顺序（fast → pro → flux-kontext-max）基于经验判断（pro 通常更稳定/质量更高，flux-kontext-max 是不同模型家族的兜底），不是数据驱动结论。待真实 P95/P99 数据回灌后再调整。
+
 ### 反面示例（不要这样做）
 
 ❌ 把 `"维护中"` 三个字直接砸给用户
 ❌ 任何失败都自动 retry 三五次造成账单浪费
 ❌ `CONTENT_POLICY_VIOLATION` 时换汤不换药地原 prompt 重试
 ❌ `PROVIDER_INSUFFICIENT_CREDITS` 时让用户去充值（这跟用户余额无关）
+❌ **任何 `gen` 命令失败后，在 sandbox 里 `pip install` 重 ML 推理库（rembg / onnxruntime / torch / segmentation-models 等）做 fallback** —— 纯像素操作（PIL / cv2 的 crop / paste / resize / 简单 alpha 通道处理）不在此列。真实事故：grsai 超时后 LLM 自己装 rembg → 内存不足被 kill → 反复重试 → 用户等 20 分钟才出图。失败必须**诚实告知用户**，不要在 sandbox 里"自己想办法"。
+
+### 正面示例（这样做对）
+
+✅ `nano-banana-fast` 超时 → 切 `-m nano-banana-pro` 重试 1 次（按 `UPSTREAM_TIMEOUT` 行的处理）
+✅ 两次都失败 → "图片编辑服务暂时不可用，请稍后再试" + 不再尝试，不写代码、不装包
+✅ 简单几何操作（crop / resize / paste / 拼图）→ 用 Python + PIL，不算 fallback（这本来就不需要 AI）

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

@@ -305,6 +305,35 @@ scout search "open ear earbuds" --limit 15 --format json > /tmp/scout-result.jso
 | `scout supplier-search "关键词" --limit N` | 1688 供应商搜索（关键词） | 计划/开发 |
 | `scout supplier-search-image "URL" --limit N` | 1688 供应商搜索（图片） | 计划/开发 |
 
+### 卖家精灵（关键词 + 广告 + 市场分析）
+
+| 命令 | 用途 | 阶段 |
+|------|------|------|
+| `scout sp keywords <ASIN>` | ASIN 流量关键词反查（含 PPC 竞价、自然/广告排名） | 计划 |
+| `scout sp keywords-mine <keyword>` | 关键词挖掘（搜索量/竞价/转化率/供需比） | 概念/计划 |
+| `scout sp keywords-order <ASIN>` | 出单关键词反查（转化类型：优质/平稳/流失/无效） | 计划 |
+| `scout sp keywords-research <keyword>` | 关键词市场分析（含品牌/ABA 数据） | 概念 |
+| `scout sp keywords-trends <keyword>` | 关键词历史趋势（2017-至今月度搜索量） | 概念/计划 |
+| `scout sp traffic-stats <ASIN>` | 流量关键词概览 | 计划 |
+| `scout sp traffic-source <ASIN>` | 流量来源结构（自然/广告/关联） | 计划 |
+| `scout sp traffic-listing <ASIN>` | 免费/付费流量分布 | 计划 |
+| `scout sp traffic-related <ASIN>` | 关联商品列表 | 计划 |
+| `scout sp traffic-extend <ASIN>` | 批量关键词拓展 | 计划 |
+| `scout sp predict <ASIN>` | 销量预测（14 个月） | 计划 |
+| `scout sp competitors <ASIN>` | 竞品查询（含销量/销额/利润） | 计划 |
+| `scout sp coupon <ASIN>` | 优惠趋势 | 计划 |
+| `scout sp category <keyword>` | 类目树搜索（支持关键词） | 概念 |
+| `scout sp market <nodeIdPath>` | 类目市场分析（规模/利润/FBA 占比） | 概念 |
+| `scout sp brands <nodeIdPath>` | 品牌集中度 | 概念/计划 |
+| `scout sp sellers <nodeIdPath>` | 卖家集中度 | 概念 |
+| `scout sp demand <nodeIdPath>` | 需求趋势 | 概念 |
+| `scout sp prices <nodeIdPath>` | 价格分布 | 概念 |
+| `scout sp google-trend <keyword>` | 谷歌趋势 | 概念 |
+| `scout sp aba-weekly <keyword>` | ABA 周数据 | 计划 |
+| `scout sp aba-monthly <keyword>` | ABA 月数据 | 计划 |
+
+注：market 类命令的 `<nodeIdPath>` 先通过 `scout sp category <关键词>` 查到。
+
 ### 费用提醒
 
 - `scout reviews` 每页约 $0.0075 Apify credits，`--all-stars --pages 10`（~500 条）约 $0.38

package/package.json

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