@optima-chat/optima-agent 0.8.37 → 0.8.39

package/.claude/settings.local.json

@@ -145,7 +145,8 @@
       "Bash(aws ecs:*)",
       "Bash(aws ecr:*)",
       "Bash(gh search:*)",
-      "Bash(npx tsc:*)"
+      "Bash(npx tsc:*)",
+      "Bash(find /Users/verypro/optima-agent -path */node_modules -prune -o -type f \\\\\\(-name *comfy* -o -name *gen* \\\\\\) -print)"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/{comfy → gen}/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: comfy
+name: gen
 description: "生成和编辑图片/视频/语音/虚拟试穿。使用场景：生成图片(generate images/生成图片/画图)、编辑图片(edit images/编辑图片/图生图/风格转换)、生成视频(create videos/图生视频)、文本转语音(TTS/语音合成/朗读)、语音识别(ASR/语音转文字/转录)、虚拟试穿(virtual try-on/试穿/换装/试衣)。"
 ---
 
-# 图像视频生成工具
+# AI 内容生成工具
 
 ## 图片生成
 
@@ -11,21 +11,21 @@ description: "生成和编辑图片/视频/语音/虚拟试穿。使用场景：
 
 ```bash
 # 文生图
-comfy image "提示词" -o /home/aiuser/project/result.png
+gen image "提示词" -o /home/aiuser/project/result.png
 
 # 图片编辑/风格转换
-comfy image "转成水彩风格" -i photo.png -o /home/aiuser/project/result.png
+gen image "转成水彩风格" -i photo.png -o /home/aiuser/project/result.png
 
 # 读取并描述结果
 Read /home/aiuser/project/result.png
 ```
 
-### comfy image 命令
+### gen image 命令
 
 统一的图像生成/编辑命令。
 
 ```bash
-comfy image <prompt> [options]
+gen image <prompt> [options]
 ```
 
 #### 参数
@@ -33,8 +33,8 @@ comfy image <prompt> [options]
 | 参数 | 说明 |
 |------|------|
 | `-i, --input <path>` | 输入图像（可多次使用，最多 8 张） |
-| `-W, --width <px>` | 输出宽度（默认 1024，必须是 16 的倍数） |
-| `-H, --height <px>` | 输出高度（默认 1024，必须是 16 的倍数） |
+| `-W, --width <px>` | 输出宽度（默认 1024，最大 2048） |
+| `-H, --height <px>` | 输出高度（默认 1024，最大 2048） |
 | `-o, --output <path>` | 输出目录或完整路径 |
 | `-s, --seed <number>` | 随机种子（可复现结果） |
 | `-f, --format <fmt>` | 输出格式：jpeg \| png |
@@ -44,14 +44,14 @@ comfy image <prompt> [options]
 #### 文生图
 
 ```bash
-comfy image "a cute fluffy cat sitting on a windowsill, natural lighting" -o /home/aiuser/project/cat.png
+gen image "a cute fluffy cat sitting on a windowsill, natural lighting" -o /home/aiuser/project/cat.png
 Read /home/aiuser/project/cat.png
 ```
 
 #### 图片风格转换
 
 ```bash
-comfy image "watercolor painting style, artistic brushstrokes" -i photo.jpg -o /home/aiuser/project/watercolor.png
+gen image "watercolor painting style, artistic brushstrokes" -i photo.jpg -o /home/aiuser/project/watercolor.png
 Read /home/aiuser/project/watercolor.png
 ```
 
@@ -60,7 +60,7 @@ Read /home/aiuser/project/watercolor.png
 将第一张图的风格应用到第二张图的内容上：
 
 ```bash
-comfy image "apply the artistic style from image 1 to the content of image 2" -i style.png -i content.png -o /home/aiuser/project/fusion.png
+gen image "apply the artistic style from image 1 to the content of image 2" -i style.png -i content.png -o /home/aiuser/project/fusion.png
 Read /home/aiuser/project/fusion.png
 ```
 
@@ -69,7 +69,7 @@ Read /home/aiuser/project/fusion.png
 从多张图中提取元素组合成新图：
 
 ```bash
-comfy image "The person from image 1 is petting the cat from image 2, in a cozy living room" -i person.jpg -i cat.jpg -o /home/aiuser/project/combined.png
+gen image "The person from image 1 is petting the cat from image 2, in a cozy living room" -i person.jpg -i cat.jpg -o /home/aiuser/project/combined.png
 ```
 
 #### 精确颜色控制
@@ -77,13 +77,13 @@ comfy image "The person from image 1 is petting the cat from image 2, in a cozy
 使用 hex code 指定精确颜色：
 
 ```bash
-comfy image "a modern logo with brand color #02eb3c as the primary accent" -o /home/aiuser/project/logo.png
+gen image "a modern logo with brand color #02eb3c as the primary accent" -o /home/aiuser/project/logo.png
 ```
 
 #### 产品海报
 
 ```bash
-comfy image "Disney Pixar style 3D poster, [产品描述], cute character, vibrant gradient background, professional studio lighting" -W 1024 -H 1024 -o /home/aiuser/project/poster.png
+gen image "Disney Pixar style 3D poster, [产品描述], cute character, vibrant gradient background, professional studio lighting" -W 1024 -H 1024 -o /home/aiuser/project/poster.png
 ```
 
 ### 提示词指南（FLUX.2）
@@ -116,18 +116,18 @@ comfy image "Disney Pixar style 3D poster, [产品描述], cute character, vibra
 
 ```bash
 # 简单
-comfy image "a robot"
+gen image "a robot"
 
 # 添加风格
-comfy image "a friendly AI robot, cute cartoon style, bright colors, 3D render"
+gen image "a friendly AI robot, cute cartoon style, bright colors, 3D render"
 
 # 完整描述
-comfy image "Disney Pixar style 3D animated robot character, friendly cheerful expression, wearing headset, surrounded by floating icons, gradient purple-blue background, professional studio lighting, vibrant colors"
+gen image "Disney Pixar style 3D animated robot character, friendly cheerful expression, wearing headset, surrounded by floating icons, gradient purple-blue background, professional studio lighting, vibrant colors"
 ```
 
 ### 分辨率选择
 
-尺寸必须是 **16 的倍数**，最大支持 4MP（推荐 2MP 内）。
+最大 2048x2048。
 
 | 用途 | 分辨率 |
 |------|--------|
@@ -142,33 +142,29 @@ comfy image "Disney Pixar style 3D animated robot character, friendly cheerful e
 - 向用户描述图片内容（颜色、风格、构图、元素）
 - 验证是否符合用户要求
 
-#### 尺寸要求
-- 宽高必须是 16 的倍数
-- 最大 4MP，推荐 2MP 内
-
 #### 多图参考
 - 最多 8 张输入图
 
 ## 视频生成
 
-从静态图片生成视频（wan2.6-i2v），支持 720P/1080P，5-15 秒。
+从静态图片生成视频（wan2.6-i2v），支持 720P/1080P，5-10 秒。
 
 ```bash
-comfy video <图片路径> [options]
+gen video <图片路径> [options]
 ```
 
 ### 参数
 
 | 参数 | 说明 | 默认值 |
 |------|------|--------|
-| `-p, --prompt` | 运动/内容描述（最长 1500 字） | - |
-| `-n, --negative` | 负向提示词（最长 500 字） | - |
+| `-p, --prompt` | 运动/内容描述 | - |
+| `-n, --negative` | 负向提示词 | - |
 | `-o, --output <path>` | 输出目录或完整路径 | - |
 | `-r, --resolution` | 720P \| 1080P | 1080P |
-| `-d, --duration` | 5 \| 10 \| 15 秒 | 5 |
+| `-d, --duration` | 5 \| 10 秒 | 5 |
 | `--shot-type` | single \| multi（多镜头叙事） | single |
 | `--no-audio` | 禁用自动配音 | - |
-| `--audio-url <url>` | 自定义音频 URL（需先用 `commerce upload` 上传） | - |
+| `--audio-url <url>` | 自定义音频 URL | - |
 | `--no-prompt-extend` | 禁用智能改写 prompt | - |
 | `--watermark` | 添加 AI 生成水印 | - |
 | `--seed <number>` | 随机种子（可复现） | - |
@@ -177,46 +173,39 @@ comfy video <图片路径> [options]
 
 ```bash
 # 基础用法
-comfy video portrait.png --prompt "gentle smile, subtle head movement"
+gen video portrait.png --prompt "gentle smile, subtle head movement"
 
 # 10 秒 1080P 视频
-comfy video scene.png -d 10 -r 1080P --prompt "cinematic camera pan"
-
-# 多镜头叙事（15 秒故事性视频）
-comfy video story.png --shot-type multi -d 15 --prompt "a day in the life"
+gen video scene.png -d 10 -r 1080P --prompt "cinematic camera pan"
 
 # 静音视频
-comfy video product.png --no-audio --prompt "360 degree rotation"
-
-# 自定义音频（需先上传获取 URL）
-commerce upload file --path "/home/aiuser/music.mp3"
-# 返回 URL 后使用
-comfy video scene.png --audio-url "https://..." -o /home/aiuser/project/with-audio.mp4
+gen video product.png --no-audio --prompt "360 degree rotation"
 
 # 指定输出路径
-comfy video scene.png -o /home/aiuser/project/result.mp4 --prompt "camera zoom"
+gen video scene.png -o /home/aiuser/project/result.mp4 --prompt "camera zoom"
 Read /home/aiuser/project/result.mp4
 ```
 
 ### 注意事项
 
-- 输入图片：360-2000px，≤10MB，推荐 1080P 比例
-- 输出规格：30fps，MP4 (H.264)
-- 可用 `-o` 指定输出路径，默认保存到 `./comfy-output/`
+- 输入图片：推荐 1080P 比例，≤10MB
+- 最大时长 10 秒
+- 输出：30fps，MP4 (H.264)
+- 默认保存到 `./gen-output/`
 
 ## 虚拟试穿 (Virtual Try-On)
 
 使用 FASHN AI tryon-v1.6 将服装穿到人物照片上。
 
 ```bash
-comfy tryon <人物照片> <服装照片> [options]
+gen tryon <人物照片> <服装照片> [options]
 ```
 
 ### 参数
 
 | 参数 | 说明 | 默认值 |
 |------|------|--------|
-| `-o, --output <path>` | 输出文件路径 | `./comfy-output/tryon_{timestamp}.png` |
+| `-o, --output <path>` | 输出文件路径 | `./gen-output/tryon_{timestamp}.png` |
 | `-c, --category <type>` | 服装类别：auto \| tops \| bottoms \| one-pieces | auto |
 | `-m, --mode <mode>` | 生成模式：performance \| balanced \| quality | quality |
 | `--garment-type <type>` | 服装照片类型：auto \| flat-lay \| model | auto |
@@ -227,44 +216,40 @@ comfy tryon <人物照片> <服装照片> [options]
 ### 示例
 
 ```bash
-# 基本用法 - 本地图片试穿
-comfy tryon person.jpg garment.jpg -o /home/aiuser/project/result.png
+# 基本用法
+gen tryon person.jpg garment.jpg -o /home/aiuser/project/result.png
 Read /home/aiuser/project/result.png
 
 # 使用 URL 图片
-comfy tryon https://example.com/model.jpg https://example.com/dress.jpg -o /home/aiuser/project/result.png
+gen tryon https://example.com/model.jpg https://example.com/dress.jpg -o /home/aiuser/project/result.png
 
 # 指定服装类别和快速模式
-comfy tryon person.jpg top.jpg -c tops -m performance -o /home/aiuser/project/result.png
+gen tryon person.jpg top.jpg -c tops -m performance -o /home/aiuser/project/result.png
 
 # 生成多张结果
-comfy tryon person.jpg dress.jpg -n 4 -c one-pieces -o /home/aiuser/project/result.png
-
-# 使用种子复现结果
-comfy tryon person.jpg garment.jpg --seed 42 -o /home/aiuser/project/result.png
+gen tryon person.jpg dress.jpg -n 4 -c one-pieces -o /home/aiuser/project/result.png
 ```
 
 ### 注意事项
 
 - 支持本地图片路径和 URL
 - 服装类别：auto (自动检测), tops (上装), bottoms (下装), one-pieces (连体)
-- 三种模式价格相同（1 credit/张），quality 效果最好
-- 推荐图片高度不超过 2000px，比例 2:3，JPEG 95% 质量
-- 可用 `-o` 指定输出路径，默认保存到 `./comfy-output/`
+- 三种模式：performance (~7s), balanced (~9s), quality (~13s)
+- 默认保存到 `./gen-output/`
 
 ## 语音合成 (TTS)
 
 使用 DashScope qwen3-tts-flash 将文本转为语音。
 
 ```bash
-comfy tts <文本> [options]
+gen tts <文本> [options]
 ```
 
 ### 参数
 
 | 参数 | 说明 | 默认值 |
 |------|------|--------|
-| `-o, --output <path>` | 输出文件路径 | `./comfy-output/tts_{timestamp}.wav` |
+| `-o, --output <path>` | 输出文件路径 | `./gen-output/tts_{timestamp}.wav` |
 | `--voice <name>` | 声音名称 | Cherry |
 | `--voices` | 列出可用声音 | - |
 | `--play` | 生成后自动播放 | - |
@@ -278,27 +263,28 @@ comfy tts <文本> [options]
 
 ```bash
 # 中文语音合成
-comfy tts "你好，欢迎使用语音合成功能" -o /home/aiuser/project/hello.wav
+gen tts "你好，欢迎使用语音合成功能" -o /home/aiuser/project/hello.wav
 
 # 指定男声
-comfy tts "Hello, welcome!" --voice Ethan -o /home/aiuser/project/greeting.wav
+gen tts "Hello, welcome!" --voice Ethan -o /home/aiuser/project/greeting.wav
 
 # 生成后播放
-comfy tts "测试语音" --play -o /home/aiuser/project/test.wav
+gen tts "测试语音" --play -o /home/aiuser/project/test.wav
 ```
 
 ### 注意事项
 
 - 输出格式为 WAV
+- 最大 5000 字符
 - 支持中、英、日、韩、法、德等 10 种语言（自动检测）
-- 可用 `-o` 指定输出路径，默认保存到 `./comfy-output/`
+- 默认保存到 `./gen-output/`
 
 ## 语音识别 (ASR)
 
 使用 Groq Whisper 将语音转为文字。
 
 ```bash
-comfy asr <音频文件> [options]
+gen asr <音频文件> [options]
 ```
 
 ### 参数
@@ -312,13 +298,26 @@ comfy asr <音频文件> [options]
 
 ```bash
 # 自动检测语言
-comfy asr /home/aiuser/project/recording.mp3
+gen asr /home/aiuser/project/recording.mp3
 
 # 指定语言提示（提高准确率）
-comfy asr /home/aiuser/project/recording.wav --language zh
+gen asr /home/aiuser/project/recording.wav --language zh
 ```
 
 ### 注意事项
 
 - 支持 mp3, wav, m4a, ogg, webm 格式
 - 文件大小限制 25MB
+
+## 任务管理
+
+所有生成命令会自动等待完成。如需查看历史或管理任务：
+
+```bash
+gen task list                     # 查看所有任务
+gen task list --type image        # 按类型过滤
+gen task list --status failed     # 按状态过滤
+gen task get <task_id>            # 查看任务详情
+gen task cancel <task_id>         # 取消任务
+gen task retry <task_id>          # 重试失败的任务
+```

package/.claude/skills/logistics/SKILL.md

@@ -151,6 +151,30 @@ logistics address validate --address '<JSON Address>'
 
 所有命令支持 `--pretty` 参数输出人类可读格式。
 
+### JD 走货限制知识
+
+**货物类型限制**（不同专线支持不同 cargo type）：
+- 普货线：仅接 general
+- 带电线：接 battery + general
+- 服装线：接 clothing + general
+- 化妆品线：接 cosmetic
+- 系统会自动根据产品 cargo_type 过滤不可用专线
+
+**品牌限制**：部分国际品牌在 JD 禁运列表中，系统自动检查
+
+**PGA 管控**：部分商品（食品、药品等）受 PGA 管控，系统做关键词初筛
+
+**偏远邮编**：US 部分邮编为偏远无服务区域，JD 不提供服务
+
+### AI 发货决策树
+
+```
+卖家说"发货" → 查 getRates
+  ├── 有可用方案 → AskUserQuestion 展示方案让卖家选择
+  ├── JD 无方案但有 EasyShip → 告知原因，建议使用其他物流或手动发货
+  └── 全部无方案 → 告知原因 + 建议手动发货
+```
+
 ## 不确定用什么命令？
 
 运行 `logistics --help` 查看所有子命令。

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

@@ -45,10 +45,28 @@ description: Order fulfillment and shipping management. Process orders, ship pac
 
 | shipping_mode_used | 含义 | 发货方式 |
 |--------------------|------|----------|
-| `easyship` | 买家选择了动态运费快递 | 可选自动发货 或 手动发货 |
-| `fixed` | 买家使用固定运费 | 只能手动发货 |
-| `free` | 全球免运费 | 只能手动发货 |
-| 空/null | 历史订单 | 只能手动发货 |
+| `easyship` | 买家选择了动态运费快递（DYNAMIC） | 自动发货 / 指定方案 / 手动 |
+| `fixed` | 买家使用固定运费 | 指定方案 / 手动 |
+| `free` | 全球免运费 | 指定方案 / 手动 |
+| 空/null | 历史订单 | 指定方案 / 手动 |
+
+#### 发货流程
+
+卖家说"发货" → 查订单 → AskUserQuestion "如何发货？"
+
+**DYNAMIC 订单**（买家已选物流方案，有 selected_courier_id）:
+- 选项 1: 使用买家选择的物流方案 → `commerce order ship --id <order-id> --auto`
+- 选项 2: 使用其他系统物流方案 → 先 `logistics rates query` 查报价 → AskUserQuestion 展示方案 → 卖家选 → `commerce order ship --id <order-id> --rate-id <selected-rate-id>`
+- 选项 3: 自己处理 → 卖家提供 tracking number → `commerce order ship --id <order-id> --tracking <number> [--carrier <name>]`
+
+**FREE/FIXED 订单**（无 selected_courier_id）:
+- 选项 1: 使用系统物流 → 先 `logistics rates query` 查报价 → AskUserQuestion 展示方案 → 卖家选 → `commerce order ship --id <order-id> --rate-id <selected-rate-id>`
+- 选项 2: 自己处理 → 卖家提供 tracking number → `commerce order ship --id <order-id> --tracking <number> [--carrier <name>]`
+
+三种 CLI 路径：
+- `--auto`：仅 DYNAMIC 默认方案（使用买家 checkout 时选的 courier）
+- `--rate-id <id>`：任意模式，卖家/AI 指定方案
+- `--tracking <number>`：手动发货
 
 #### 发货决策规则（必须严格遵守）
 
@@ -60,30 +78,35 @@ description: Order fulfillment and shipping management. Process orders, ship pac
 
 **步骤3**：根据字段值决定下一步操作：
 
-- **如果 `shipping_mode_used = "easyship"`**：
+- **如果 `shipping_mode_used = "easyship"`（DYNAMIC 订单）**：
   1. **必须**使用 AskUserQuestion 工具询问用户
-  2. 提供两个选项让用户选择
+  2. 提供三个选项：使用买家方案（--auto）、选择其他方案（--rate-id）、手动发货（--tracking）
   3. **禁止**直接询问运单号
   4. 等待用户选择后再执行对应命令
 
 - **如果 `shipping_mode_used = "fixed"` 或 `"free"` 或字段为空**：
-  1. 询问用户提供运单号。快递公司名称为**可选**，如果用户未提供，后端会根据运单号自动检测
-  2. 用户提供运单号后即可执行发货命令，无需等待用户补充 carrier
-  3. **即使用户提供了快递公司名称，发货时也统一不传 carrier**，让后端根据运单号自动检测并存储准确的快递公司名称（人类可读，如 "SF Express"、"UPS"）。发货成功后对比响应中的 carrier 与用户所说的：
+  1. **必须**使用 AskUserQuestion 工具询问用户
+  2. 提供两个选项：使用系统物流（--rate-id）、手动发货（--tracking）
+  3. 如果用户选择系统物流，先 `logistics rates query` 查报价，再用 AskUserQuestion 展示可用方案
+  4. 如果用户选择手动发货：询问运单号，快递公司名称为**可选**
+  5. **即使用户提供了快递公司名称，发货时也统一不传 carrier**，让后端根据运单号自动检测并存储准确的快递公司名称（人类可读，如 "SF Express"、"UPS"）。发货成功后对比响应中的 carrier 与用户所说的：
      - 一致 → 正常告知
      - 不一致 → 告知用户："您提供的是 XX，系统根据运单号识别为 YY，已按识别结果记录。如有误请告知。"
 
-#### Easyship 自动发货
+#### 系统物流发货
 
-**适用场景**：`shipping_mode_used = "easyship"` 且用户选择使用 Easyship
+**适用场景**：任意 shipping_mode_used，用户选择使用系统物流
 
 **命令**：
 ```bash
-# 使用买家选择的快递（推荐）
+# DYNAMIC 订单 — 使用买家选择的快递（推荐）
 commerce order ship --id <order-id> --auto
 
-# 或指定其他 Easyship 支持的快递
+# DYNAMIC 订单 — 指定其他快递
 commerce order ship --id <order-id> --auto --courier-id <courier-id>
+
+# 任意模式 — 使用指定的物流方案（先查 logistics rates query）
+commerce order ship --id <order-id> --rate-id <rate-id>
 ```
 
 **返回结果包含**：
@@ -95,7 +118,7 @@ commerce order ship --id <order-id> --auto --courier-id <courier-id>
 
 **运单标签处理（重要）**：
 
-运单标签是用户必须打印并贴在包裹上的快递单。Easyship 生成标签需要几秒到几分钟。
+运单标签是用户必须打印并贴在包裹上的快递单。物流服务生成标签需要几秒到几分钟。
 
 **发货后根据 label_state 处理**：
 
@@ -103,11 +126,11 @@ commerce order ship --id <order-id> --auto --courier-id <courier-id>
 |-------------|------|----------|
 | `generated` / `printed` | 标签已生成 | 提供 `label_url` 让用户下载打印 |
 | `pending` / `generating` | 标签生成中 | 告知用户「标签正在生成，稍后可以让我帮你查询」 |
-| `failed` / `technical_failed` | 生成失败 | 告知用户需要检查 EasyShip 后台或重新发货 |
+| `failed` / `technical_failed` | 生成失败 | 告知用户需要检查物流服务后台或重新发货 |
 
 **查询标签状态**：
 
-如果发货时 label_state 为 pending/generating，稍后使用 `order refresh-label` 从 Easyship 同步最新状态：
+如果发货时 label_state 为 pending/generating，稍后使用 `order refresh-label` 同步最新状态：
 ```bash
 commerce order refresh-label --id <order-id>
 ```
@@ -166,64 +189,68 @@ commerce order mark-delivered --id <order-id>
 
 #### 发货场景示例对话
 
-**场景1：Easyship 订单**
+**场景1：DYNAMIC 订单（买家已选物流方案）**
 ```
 用户：订单 order_abc 发货
 
 助手：[执行 Bash: commerce order get --id order_abc]
-      [发现 shipping_mode_used = "easyship"]
+      [发现 shipping_mode_used = "easyship"，有 selected_courier_id]
       [使用 AskUserQuestion 工具]
 
 AskUserQuestion:
-  question: "该订单使用 Easyship 运费模式，请选择发货方式"
+  question: "该订单买家已选择物流方案，请选择发货方式"
   options:
-    - label: "Easyship 自动发货（推荐）"
-      description: "自动生成运单号和标签，使用买家选择的快递"
+    - label: "使用买家选择的物流方案（推荐）"
+      description: "自动生成运单号和标签，使用买家 checkout 时选的快递"
+    - label: "选择其他系统物流方案"
+      description: "查询可用物流方案，选择后创建运单"
     - label: "手动填写运单号"
-      description: "使用其他快递公司，需要提供运单号"
+      description: "自己处理物流，需要提供运单号"
 
-用户：[选择 Easyship 自动发货]
+用户：[选择使用买家方案]
 
 助手：[执行 Bash: commerce order ship --id order_abc --auto]
       [检查返回结果中的 label_state]
-
-      [情况A：label_state = "generated"，有 label_url]
-      发货成功！运单号 ES123456789，快递公司 FedEx。
-      运单标签已生成，请下载打印后贴在包裹上：https://...
-      物流信息同步中，稍后可以让我帮你查询物流状态。
-
-      [情况B：label_state = "pending" 或 "generating"]
       发货成功！运单号 ES123456789，快递公司 FedEx。
-      运单标签正在生成中，稍后可以让我帮你查询标签和物流状态。
-
-用户：标签好了吗
-
-助手：[执行 Bash: commerce order refresh-label --id order_abc]
-      [检查返回结果中的 label_state 和 label_url]
-
-      [情况A：label_state = "generated"，有 label_url]
       运单标签已生成，请下载打印后贴在包裹上：https://...
-
-      [情况B：label_state 仍为 "pending" 或 "generating"]
-      运单标签仍在生成中，请稍后再试。
 ```
 
-**场景2：固定运费/免运费订单（手动发货）**
+**场景2：FREE/FIXED 订单（使用系统物流）**
 ```
 用户：订单 order_xyz 发货
 
 助手：[执行 Bash: commerce order get --id order_xyz]
-      [发现 shipping_mode_used = "fixed" 或 "free"]
-      请提供运单号（快递公司可选，系统会自动识别）。
+      [发现 shipping_mode_used = "fixed"，无 selected_courier_id]
+      [使用 AskUserQuestion 工具]
 
-用户：单号 SF123456
+AskUserQuestion:
+  question: "该订单使用固定运费模式，请选择发货方式"
+  options:
+    - label: "使用系统物流"
+      description: "查询可用物流方案，选择后自动创建运单和标签"
+    - label: "手动填写运单号"
+      description: "自己处理物流，需要提供运单号"
 
-助手：[执行 Bash: commerce order ship --id order_xyz --tracking SF123456]
-      发货成功！运单号 SF123456，快递公司顺丰速运（自动识别）。
-      随时可以让我帮你查询物流状态。
+用户：[选择系统物流]
+
+助手：[执行 Bash: logistics rates query --origin '...' --destination '...' --items '...']
+      [查到 3 个可用方案]
+      [使用 AskUserQuestion 展示方案]
+
+AskUserQuestion:
+  question: "以下是可用的物流方案，请选择"
+  options:
+    - label: "Standard Shipping (7-15 days) - ¥72.00 CNY"
+    - label: "Economy Shipping (15-25 days) - ¥45.00 CNY"
+    - label: "Express Shipping (3-7 days) - ¥128.00 CNY"
+
+用户：[选择 Standard Shipping]
+
+助手：[执行 Bash: commerce order ship --id order_xyz --rate-id rate_abc123]
+      发货成功！运单号 JD123456789。
 ```
 
-**场景3：用户直接提供运单号发货**
+**场景3：手动发货（用户直接提供运单号）**
 ```
 用户：订单 order_abc 发货，单号 YT9876543210
 
@@ -365,16 +392,14 @@ commerce order list --status paid --limit 50
 # 步骤1：先获取订单信息，检查 shipping_mode_used
 commerce order get --id order_123
 
-# 步骤2a：如果 shipping_mode_used = "easyship"，询问用户选择后
-# 用户选择 Easyship 自动发货
+# DYNAMIC 订单 — 使用买家选择的方案
 commerce order ship --id order_123 --auto
 
-# 步骤2b：如果用户选择手动发货，或 shipping_mode_used = "fixed"/"free"
-# 只需提供运单号，carrier 可选
-commerce order ship --id order_123 --tracking DHL123456
+# 任意模式 — 指定物流方案（先查 logistics rates query 获取 rate-id）
+commerce order ship --id order_123 --rate-id rate_abc123
 
-# 或同时指定 carrier
-commerce order ship --id order_123 --tracking DHL123456 --carrier DHL
+# 手动发货 — 只需提供运单号，carrier 可选
+commerce order ship --id order_123 --tracking DHL123456
 ```
 
 ### 取消订单

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

@@ -335,6 +335,19 @@ commerce product add-images --id prod_123 --media-id media_red,media_blue
 commerce product get --id prod_123
 ```
 
+### 物流属性引导（物理产品）
+
+创建 `requires_shipping: true` 的物理产品时：
+
+1. **重量**：引导卖家填写准确重量（影响所有物流报价准确性）
+2. **cargo_type**：根据产品标题/描述自动推断（默认 general），向卖家确认
+   - 推断方式："根据产品信息，我推断这是普通商品，对吗？"（不要直接问"含电池吗？"）
+   - 可选值：general（普货）、battery（带电）、liquid（液体）、cosmetic（化妆品）、clothing（服装）、powder（粉末）、wood（木制品）
+   - 这是通用物流属性，不需要提及任何具体物流商
+3. **brand**：引导填写品牌（可选，用于物流限制检查）
+4. 用户可跳过，但告知"会影响物流方案选择和报价准确性"
+5. 数字产品跳过整个物流属性流程
+
 ## 重要提示
 
 - **国际化策略** - 平台默认语言是英文（en-US）。当用户同时提供中英文内容时，用英文创建商品，中文通过 `i18n` skill 添加翻译。当用户要求"国际化"时，确保英文在主表，其他语言通过 i18n 添加。详见 i18n skill。

package/dist/bin/gen.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/gen-cli";
+//# sourceMappingURL=gen.d.ts.map

package/dist/bin/gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen.d.ts","sourceRoot":"","sources":["../../bin/gen.ts"],"names":[],"mappings":";AACA,OAAO,sBAAsB,CAAC"}

package/dist/bin/gen.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/gen-cli";
+//# sourceMappingURL=gen.js.map

package/dist/bin/gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen.js","sourceRoot":"","sources":["../../bin/gen.ts"],"names":[],"mappings":";AACA,OAAO,sBAAsB,CAAC"}

package/dist/src/agent.d.ts

@@ -11,7 +11,7 @@ export declare class OptimaAgent {
      * @param prompt 用户输入
      * @param chatOptions 选项，包括 streamFormat: 'delta' | 'content'
      */
-    chat(prompt: string, chatOptions?: ChatOptions): AsyncGenerator<import("@anthropic-ai/claude-agent-sdk").SDKUserMessage | import("@anthropic-ai/claude-agent-sdk").SDKAssistantMessage | import("@anthropic-ai/claude-agent-sdk").SDKResultSuccess | import("@anthropic-ai/claude-agent-sdk").SDKResultError | import("@anthropic-ai/claude-agent-sdk").SDKSystemMessage | import("@anthropic-ai/claude-agent-sdk").SDKPartialAssistantMessage | import("@anthropic-ai/claude-agent-sdk").SDKCompactBoundaryMessage | import("@anthropic-ai/claude-agent-sdk").SDKStatusMessage | import("@anthropic-ai/claude-agent-sdk").SDKLocalCommandOutputMessage | import("@anthropic-ai/claude-agent-sdk").SDKHookStartedMessage | import("@anthropic-ai/claude-agent-sdk").SDKHookProgressMessage | import("@anthropic-ai/claude-agent-sdk").SDKHookResponseMessage | import("@anthropic-ai/claude-agent-sdk").SDKToolProgressMessage | import("@anthropic-ai/claude-agent-sdk").SDKAuthStatusMessage | import("@anthropic-ai/claude-agent-sdk").SDKTaskNotificationMessage | import("@anthropic-ai/claude-agent-sdk").SDKTaskStartedMessage | import("@anthropic-ai/claude-agent-sdk").SDKTaskProgressMessage | import("@anthropic-ai/claude-agent-sdk").SDKFilesPersistedEvent | import("@anthropic-ai/claude-agent-sdk").SDKToolUseSummaryMessage | import("@anthropic-ai/claude-agent-sdk").SDKRateLimitEvent | import("@anthropic-ai/claude-agent-sdk").SDKElicitationCompleteMessage | import("@anthropic-ai/claude-agent-sdk").SDKPromptSuggestionMessage | {
+    chat(prompt: string, chatOptions?: ChatOptions): AsyncGenerator<import("@anthropic-ai/claude-agent-sdk").SDKUserMessage | import("@anthropic-ai/claude-agent-sdk").SDKAssistantMessage | import("@anthropic-ai/claude-agent-sdk").SDKResultSuccess | import("@anthropic-ai/claude-agent-sdk").SDKResultError | import("@anthropic-ai/claude-agent-sdk").SDKSystemMessage | import("@anthropic-ai/claude-agent-sdk").SDKPartialAssistantMessage | import("@anthropic-ai/claude-agent-sdk").SDKCompactBoundaryMessage | import("@anthropic-ai/claude-agent-sdk").SDKStatusMessage | import("@anthropic-ai/claude-agent-sdk").SDKAPIRetryMessage | import("@anthropic-ai/claude-agent-sdk").SDKLocalCommandOutputMessage | import("@anthropic-ai/claude-agent-sdk").SDKHookStartedMessage | import("@anthropic-ai/claude-agent-sdk").SDKHookProgressMessage | import("@anthropic-ai/claude-agent-sdk").SDKHookResponseMessage | import("@anthropic-ai/claude-agent-sdk").SDKToolProgressMessage | import("@anthropic-ai/claude-agent-sdk").SDKAuthStatusMessage | import("@anthropic-ai/claude-agent-sdk").SDKTaskNotificationMessage | import("@anthropic-ai/claude-agent-sdk").SDKTaskStartedMessage | import("@anthropic-ai/claude-agent-sdk").SDKTaskProgressMessage | import("@anthropic-ai/claude-agent-sdk").SDKFilesPersistedEvent | import("@anthropic-ai/claude-agent-sdk").SDKToolUseSummaryMessage | import("@anthropic-ai/claude-agent-sdk").SDKRateLimitEvent | import("@anthropic-ai/claude-agent-sdk").SDKElicitationCompleteMessage | import("@anthropic-ai/claude-agent-sdk").SDKPromptSuggestionMessage | {
         type: "text_delta";
         delta: {
             text: string;

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

package/dist/src/system-prompt.js

@@ -35,7 +35,7 @@ export function getSystemPrompt() {
 - **collection** - 商品集合管理（分组、促销专区）
 - **homepage** - 店铺首页配置（Banner、集合展示）
 - **product-page** - 商品详情页配置
-- **comfy** - 图像/视频生成
+- **gen** - 图像/视频/语音生成
 - **markdown-pdf** - Markdown 转 PDF（文档导出、报告生成）
 - **ffmpeg** - 音视频处理（格式转换、压缩、提取音频）
 - **ads** - Google Ads 广告投放
@@ -51,7 +51,7 @@ export function getSystemPrompt() {
 示例：
 - 用户："查看我的店铺信息" - 使用 Skill 工具加载 "merchant"
 - 用户："帮我创建一个商品" - 使用 Skill 工具加载 "product"
-- 用户："生成一张产品图片" - 使用 Skill 工具加载 "comfy"
+- 用户："生成一张产品图片" - 使用 Skill 工具加载 "gen"
 - 用户："包裹到哪了" / "查物流" - 使用 Skill 工具加载 "order"
 - 用户："连接我的 Shopify 店铺" / "看看 Shopify 商品" - 使用 Skill 工具加载 "shopify"
 
@@ -74,6 +74,17 @@ export function getSystemPrompt() {
   4. 3 次均失败后，告知用户："认证已过期，请刷新页面后重试"，**停止重试**
 - 不要尝试通过 login/logout 修复认证问题
 
+## 额度不足处理
+
+当工具返回 \`INSUFFICIENT_CREDITS\` 错误时：
+- 告知用户当前积分不足，无法完成本次操作
+- 引导用户查看用量明细：[查看用量明细](action://usage)
+- 告知用户可以**购买积分**或**升级计划**来获取更多额度
+- **不要重试**，等用户充值后再操作
+
+**回复示例**：
+- "积分不足，无法生成图片。您可以 [查看用量明细](action://usage) 了解当前额度，通过购买积分或升级计划来继续使用。"
+
 ## 链接处理规则
 
 当用户发送电商平台链接时，**不要用 WebFetch 访问**（会被反爬拦截），先用 Skill 工具加载对应技能，再按技能中的 URL 解析规则执行命令：

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2I9B,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsJ9B,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.8.37",
+  "version": "0.8.39",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",
@@ -9,7 +9,7 @@
     "optima": "./dist/bin/optima.js",
     "commerce": "./dist/bin/commerce.js",
     "bi-cli": "./dist/bin/bi-cli.js",
-    "comfy": "./dist/bin/comfy.js",
+    "gen": "./dist/bin/gen.js",
     "google-ads": "./dist/bin/google-ads.js",
     "scout": "./dist/bin/scout.js",
     "sentinel": "./dist/bin/sentinel.js",
@@ -48,7 +48,7 @@
     "@anthropic-ai/claude-agent-sdk": "^0.2.63",
     "@optima-chat/ads-cli": "latest",
     "@optima-chat/bi-cli": "latest",
-    "@optima-chat/comfy-cli": "latest",
+    "@optima-chat/gen-cli": "latest",
     "@optima-chat/commerce-cli": "latest",
     "@optima-chat/scout-cli": "latest",
     "@optima-chat/sentinel-cli": "latest",