@optima-chat/optima-agent 0.5.0 → 0.5.1

package/.claude/settings.local.json

@@ -0,0 +1,83 @@
+{
+  "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:*)",
+      "Bash(gh issue view:*)",
+      "Bash(npx markdownlint-cli:*)",
+      "Bash(chmod:*)",
+      "Bash(npm whoami:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/.claude/skills/bi/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: bi
-description: "业务数据分析工具。使用场景：查看销售数据(sales/销售)、产品表现分析(product/产品)、趋势分析(trends/趋势)、综合分析(analytics/分析)。使用 bi-cli 命令。"
+description: "业务数据分析工具。使用场景：查看销售数据(sales/销售)、产品表现分析(product/产品)、趋势分析(trends/趋势)、高级分析(analytics/分析)、流量分析(traffic/流量)。使用 bi-cli 命令。"
 ---
 
 # BI 数据分析工具
@@ -9,54 +9,81 @@ description: "业务数据分析工具。使用场景：查看销售数据(sales
 
 **命令名称是 `bi-cli`，不是 `bi`**
 
-## 标准操作
+## 命令参考
+
+### 销售分析 (sales)
 
-### 查看销售数据
 ```bash
 bi-cli sales get [--days 7] [--pretty]
 ```
-返回销售汇总和每日明细：
-- 总收入、订单数、客单价、客户数
-- 每日销售分解
 
-### 产品表现分析
-```bash
-bi-cli product best-sellers [--limit 10] [--pretty]
-```
-返回畅销商品排行
+返回：总收入、订单数、客单价、客户数、每日明细
 
-### 趋势分析
-```bash
-bi-cli trends revenue --days 30 [--pretty]
-```
-返回收入趋势数据
+### 产品分析 (product)
 
-### 综合分析
 ```bash
-bi-cli analytics dashboard [--pretty]
-```
-返回仪表盘数据
+# 畅销商品
+bi-cli product best-sellers [--limit 10] [--sort revenue|quantity] [--pretty]
 
-## 完整命令列表
+# ABC 库存分析（帕累托）
+bi-cli product abc-analysis [--pretty]
 
-### 销售分析
-```bash
-bi-cli sales get [--days 7] [--pretty]
+# 价格区间分析
+bi-cli product price-analysis [--pretty]
+
+# 商品表现
+bi-cli product performance [--days 30] [--limit 20] [--pretty]
 ```
 
-### 产品分析
+### 趋势分析 (trends)
+
 ```bash
-bi-cli product best-sellers [--limit 10] [--pretty]
+# 收入趋势（含移动平均）
+bi-cli trends revenue [--days 30] [--granularity daily|hourly|weekly] [--pretty]
+
+# 订单热力图（按日/小时）
+bi-cli trends heatmap [--pretty]
+
+# 季节性模式
+bi-cli trends seasonality [--pretty]
+
+# 收入预测
+bi-cli trends forecast [--days 7] [--pretty]
 ```
 
-### 趋势分析
+### 高级分析 (analytics)
+
 ```bash
-bi-cli trends revenue --days 30 [--pretty]
+# 周期对比
+bi-cli analytics compare [--days 30] [--compare-to previous_period|previous_year] [--pretty]
+
+# 增长趋势
+bi-cli analytics growth [--period daily|weekly|monthly] [--pretty]
+
+# 客户群分析（LTV）
+bi-cli analytics cohort [--pretty]
+
+# 订单状态漏斗
+bi-cli analytics funnel [--days 30] [--pretty]
 ```
 
-### 综合分析
+### 流量分析 (traffic)
+
 ```bash
-bi-cli analytics dashboard [--pretty]
+# 流量概览
+bi-cli traffic overview [--days 30] [--product <uuid>] [--pretty]
+
+# 流量来源
+bi-cli traffic sources [--limit 10] [--pretty]
+
+# 转化漏斗
+bi-cli traffic funnel [--pretty]
+
+# 站内搜索分析
+bi-cli traffic search [--zero-results] [--pretty]
+
+# 热门页面
+bi-cli traffic pages [--limit 20] [--pretty]
 ```
 
 ## 工作流示例
@@ -68,10 +95,6 @@ bi-cli analytics dashboard [--pretty]
 bi-cli sales get --days 7 --pretty
 ```
 
-展示：
-- 总收入、订单数、客单价、客户数
-- 每日销售明细表格
-
 ### 示例 2：查看畅销商品
 用户："哪些商品卖得最好"
 
@@ -79,10 +102,6 @@ bi-cli sales get --days 7 --pretty
 bi-cli product best-sellers --limit 5 --pretty
 ```
 
-展示：
-- TOP5 商品排行
-- 销售额、销量、订单数
-
 ### 示例 3：收入趋势
 用户："收入趋势如何"
 
@@ -90,13 +109,23 @@ bi-cli product best-sellers --limit 5 --pretty
 bi-cli trends revenue --days 30 --pretty
 ```
 
-展示：
-- 30 天收入趋势
-- 增长率、环比数据
+### 示例 4：同比分析
+用户："和去年同期比怎么样"
+
+```bash
+bi-cli analytics compare --days 30 --compare-to previous_year --pretty
+```
+
+### 示例 5：流量来源
+用户："流量都从哪来的"
+
+```bash
+bi-cli traffic sources --limit 10 --pretty
+```
 
 ## 注意事项
 
 - 命令是 `bi-cli` 不是 `bi`
 - 默认输出 JSON 格式（AI 友好）
 - 使用 `--pretty` 获取彩色表格
-- 默认时间范围是最近 7 天
+- 默认时间范围是最近 7 天或 30 天（因命令而异）

package/.claude/skills/collection/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: collection
+description: 商品集合管理。创建、编辑集合，设置封面图，管理集合中的商品。当用户需要对商品进行分组、创建促销专区、管理商品分类、设置集合封面时使用。
+---
+
+## 概念
+
+Collection（集合）是商品的逻辑分组，用于在店铺中组织和展示商品。类似 Shopify 的 Collections。
+
+- 一个商品可以属于多个集合（多对多关系）
+- 集合支持层级结构（parent_id）
+- 集合通过 slug 在 URL 中标识，如 `/collections/summer-sale`
+
+## 结构
+
+```
+Collection
+├── 基本信息
+│   ├── name: 集合名称
+│   ├── slug: URL 标识（商户内唯一）
+│   └── description: 描述
+├── 显示设置
+│   ├── display_order: 显示顺序
+│   ├── is_active: 是否激活
+│   └── cover_media_id: 封面图
+├── 层级
+│   └── parent_id: 父集合（可选）
+├── SEO
+│   ├── meta_title: SEO 标题
+│   └── meta_description: SEO 描述
+└── 商品（多对多）
+    └── products: 集合中的商品列表
+```
+
+## 典型场景
+
+当用户说：
+- "查看所有集合" / "集合列表" → `commerce collection list`
+- "创建集合 XX" → `commerce collection create --name "XX" --slug xx`
+- "查看集合详情" → `commerce collection get --id xx`
+- "删除集合 XX" → `commerce collection delete --id xx --yes`
+- "把商品加到集合" → `commerce collection add-products --id xx --product-ids p1,p2`
+- "从集合移除商品" → `commerce collection remove-products --id xx --product-ids p1`
+- "查看集合里有哪些商品" → `commerce collection list-products --id xx`
+- "设置集合封面" / "给集合加封面图" → `commerce collection set-cover --id xx --path ./cover.jpg`
+
+## 命令参考
+
+### 集合 CRUD
+- `commerce collection list` - 列出所有集合
+- `commerce collection create --name <name> --slug <slug>` - 创建集合
+- `commerce collection get --id <id>` - 查看集合详情
+- `commerce collection update --id <id>` - 更新集合（支持 --name, --slug, --description 等）
+- `commerce collection delete --id <id> --yes` - 删除集合
+- `commerce collection set-cover --id <id>` - 设置封面图（支持 --media-id, --url, --path）
+
+### 商品管理
+- `commerce collection add-products --id <id> --product-ids <ids>` - 添加商品
+- `commerce collection remove-products --id <id> --product-ids <ids>` - 移除商品
+- `commerce collection list-products --id <id>` - 列出集合中的商品
+
+## 创建集合示例
+
+```bash
+# 创建促销集合（返回 id，用于后续操作）
+commerce collection create \
+  --name "Summer Sale 2024" \
+  --slug summer-sale-2024 \
+  --description "Hot deals for summer"
+# 输出: { "id": "coll_xxx", ... }
+
+# 添加商品到集合（使用返回的 id）
+commerce collection add-products \
+  --id coll_xxx \
+  --product-ids prod_123,prod_456,prod_789
+
+# 设置封面图
+commerce collection set-cover \
+  --id coll_xxx \
+  --path ./summer-sale-cover.jpg
+```
+
+## 注意事项
+
+- **slug 规范**：使用英文、数字、连字符，避免中文和特殊字符（影响 SEO 和 URL）
+- **删除确认**：删除操作需要 `--yes` 参数确认
+- **商品数量**：建议每个集合包含 5-30 个商品，过少显得空，过多难以浏览
+- **层级深度**：支持父子集合，但建议层级不超过 2 层

package/.claude/skills/comfy/SKILL.md

@@ -1,189 +1,205 @@
 ---
 name: comfy
-description: "使用 ComfyUI 生成和编辑图片/视频。使用场景：生成图片(generate images/生成图片/画图)、编辑图片(edit images/编辑图片/图生图)、生成视频(create videos/图生视频)。命令自动等待完成。下载时必须指定完整文件路径（包含文件名）。"
+description: "生成和编辑图片/视频。使用场景：生成图片(generate images/生成图片/画图)、编辑图片(edit images/编辑图片/图生图/风格转换)、生成视频(create videos/图生视频)。"
 ---
 
-# ComfyUI 图像视频生成工具
+# 图像视频生成工具
 
-## 标准工作流程
+## 图片生成
+
+### 标准工作流程
 
 ```bash
-# 步骤 1：生成图片（自动等待完成）
-comfy generate "提示词" --width 1024 --height 1024
+# 文生图
+comfy image "提示词" -o /home/aiuser/project/result.png
 
-# 步骤 2：下载（必须指定完整文件路径，包含文件名）
-comfy download <prompt_id> -o /用户/工作目录/文件名.png
+# 图片编辑/风格转换
+comfy image "转成水彩风格" -i photo.png -o /home/aiuser/project/result.png
 
-# 步骤 3：读取图片并向用户描述生成结果
-Read /用户/工作目录/文件名.png
+# 读取并描述结果
+Read /home/aiuser/project/result.png
 ```
 
-## 必须遵守的行为规则
-
-### 生成图片时
-1. 使用 `comfy generate "提示词"` - 命令会自动等待，不要手动检查状态
-2. 下载结果：`comfy download <prompt_id> -o <完整文件路径含文件名>`
-3. 使用 Read 工具读取下载的图片
-4. 向用户描述图片内容（颜色、风格、构图、元素）
+### comfy image 命令
 
-### 下载文件时
-- 必须指定完整文件路径，包含文件名
-- 必须使用用户的工作目录
-- 不能只指定目录（会导致 EISDIR 错误）
+统一的图像生成/编辑命令。
 
-示例：
 ```bash
-# 正确
-comfy download abc123 -o /Users/john/project/result.png
-
-# 错误 - 会失败
-comfy download abc123 -o /Users/john/project
+comfy image <prompt> [options]
 ```
 
-### 下载后
-- 始终使用 Read 工具查看生成的图片
-- 向用户描述图片内容
-- 验证是否符合用户要求
-- 如需改进，提供优化建议
+#### 参数
 
-## 命令说明
+| 参数 | 说明 |
+|------|------|
+| `-i, --input <path>` | 输入图像（可多次使用，最多 8 张） |
+| `-W, --width <px>` | 输出宽度（默认 1024，必须是 16 的倍数） |
+| `-H, --height <px>` | 输出高度（默认 1024，必须是 16 的倍数） |
+| `-o, --output <path>` | 输出目录或完整路径 |
+| `-s, --seed <number>` | 随机种子（可复现结果） |
+| `-f, --format <fmt>` | 输出格式：jpeg \| png |
 
-### 生成图片
-```bash
-comfy generate "提示词" [--width 1024] [--height 1024]
-```
-- 从文本提示词生成图片
-- 默认尺寸：1024x1024
-- 自动等待完成
-- 返回 prompt_id 用于下载
+### 工作流示例
 
-### 编辑图片
-```bash
-comfy edit <图片路径> "编辑描述"
-```
-- 根据文本提示词修改现有图片
-- 可以改变风格、添加元素、调整光线
-- 自动等待完成
+#### 文生图
 
-### 生成视频
 ```bash
-comfy video <图片路径> --prompt "运动描述" --width 512 --height 512
+comfy image "a cute fluffy cat sitting on a windowsill, natural lighting" -o /home/aiuser/project/cat.png
+Read /home/aiuser/project/cat.png
 ```
-- 从静态图片生成视频
-- 推荐分辨率：512x512
-- 可选：运动提示词和负向提示词
-- 自动等待完成
 
-### 下载结果
+#### 图片风格转换
+
 ```bash
-comfy download <prompt_id> -o <完整文件路径>
+comfy image "watercolor painting style, artistic brushstrokes" -i photo.jpg -o /home/aiuser/project/watercolor.png
+Read /home/aiuser/project/watercolor.png
 ```
-- 下载生成的文件到指定路径
-- 路径必须包含文件名和扩展名
-- 必须在用户的工作目录下
 
-## 工作流示例
+#### 多图风格融合
 
-### 示例 1：生成猫的图片
-用户："生成一张猫的图片"
+将第一张图的风格应用到第二张图的内容上：
 
 ```bash
-comfy generate "a cute fluffy cat sitting on a windowsill, natural lighting, high quality photograph"
-comfy download abc123 -o /Users/john/project/cat.png
-Read /Users/john/project/cat.png
+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
+Read /home/aiuser/project/fusion.png
 ```
-然后描述："我生成了一张猫的图片。图片展示了一只蓬松的小猫坐在窗台上，自然光线下。猫咪有【描述颜色、表情、细节】。"
 
-### 示例 2：迪士尼风格海报
-用户："给产品生成一张迪士尼风格的海报"
+#### 多图元素组合
+
+从多张图中提取元素组合成新图：
 
 ```bash
-comfy generate "Disney Pixar style movie poster, [产品描述], cute 3D character, vibrant gradient background, magical sparkles, professional studio quality, warm lighting" --width 1024 --height 1024
-comfy download def456 -o /Users/john/project/poster.png
-Read /Users/john/project/poster.png
+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
 ```
-然后描述海报的风格、颜色、角色、构图。
 
-### 示例 3：转换为动漫风格
-用户："把这张照片转成动漫风格"
+#### 精确颜色控制
+
+使用 hex code 指定精确颜色：
 
 ```bash
-comfy edit /Users/john/photos/portrait.jpg "anime style, vibrant colors, detailed, high quality"
-comfy download ghi789 -o /Users/john/project/portrait-anime.png
-Read /Users/john/project/portrait-anime.png
+comfy image "a modern logo with brand color #02eb3c as the primary accent" -o /home/aiuser/project/logo.png
 ```
-然后描述动漫风格转换的效果。
 
-### 示例 4：图片生成视频
-用户："把这张人像做成视频"
+#### 产品海报
 
 ```bash
-comfy video /Users/john/photos/portrait.png --prompt "natural facial expression, subtle head movement, smooth motion" --width 512 --height 512
-comfy download jkl012 -o /Users/john/project/portrait-video.mp4
+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
 ```
-视频文件无需读取，直接告知用户文件路径即可。
 
-## 提示词编写指南
+### 提示词指南（FLUX.2）
 
-### 结构
-- 具体明确："a golden retriever puppy playing in a garden" 而非 "a dog"
-- 包含风格："photorealistic"、"anime style"、"oil painting"、"Disney Pixar style"
-- 添加细节：材质、光线、背景、氛围
-- 使用英文以获得最佳效果（FLUX 模型对英文效果更好）
+#### 结构
+
+**Subject + Action + Style + Context**
+
+词序很重要，靠前的元素优先级更高。
+
+#### 长度建议
+
+| 长度 | 词数 | 适用场景 |
+|------|------|----------|
+| 短 | 10-30 | 快速概念探索 |
+| 中 | 30-80 | 大多数项目（推荐） |
+| 长 | 80+ | 复杂场景 |
+
+#### 最佳实践
+
+| 技巧 | 说明 | 示例 |
+|------|------|------|
+| 描述想要的 | 不支持负向提示词 | "sharp focus" 而非 "no blur" |
+| 精确颜色 | 使用 hex code | `"brand color #1a1a2e"` |
+| 文字渲染 | 用引号包裹文字 | `"The text 'OPEN' in red neon"` |
+| 摄影风格 | 指定相机/镜头 | `"shot on Fujifilm X-T5, 35mm f/1.4"` |
+| 多语言 | 用原生语言更地道 | 法语描述巴黎场景 |
+
+#### 示例对比
 
-### 示例
 ```bash
-# 简单提示词
-comfy generate "a robot"
+# 简单
+comfy image "a robot"
 
-# 添加风格和细节
-comfy generate "a friendly AI robot assistant, cute cartoon style, bright colors, 3D render, Pixar quality"
+# 添加风格
+comfy image "a friendly AI robot, cute cartoon style, bright colors, 3D render"
 
-# 完整详细描述
-comfy generate "Disney Pixar style 3D animated robot character, friendly cheerful expression, wearing headset, surrounded by floating icons, gradient purple-blue background, professional studio lighting, high quality render, vibrant colors"
+# 完整描述
+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"
 ```
 
-## 分辨率选择
+### 分辨率选择
+
+尺寸必须是 **16 的倍数**，最大支持 4MP（推荐 2MP 内）。
 
 | 用途 | 分辨率 |
 |------|--------|
-| 社交媒体图片 | 1024x1024 |
-| 宽屏壁纸 | 1920x1080 |
+| 社交媒体 | 1024x1024 |
+| 宽屏壁纸 | 1920x1088 |
 | 竖屏海报 | 768x1280 |
-| 视频生成 | 512x512 |
 
-## 错误预防
+### 生成规则
+
+#### 生成后
+- 使用 Read 工具查看生成的图片
+- 向用户描述图片内容（颜色、风格、构图、元素）
+- 验证是否符合用户要求
+
+#### 尺寸要求
+- 宽高必须是 16 的倍数
+- 最大 4MP，推荐 2MP 内
 
-### 不要做：
-- 生成后立即检查状态（还未入队）
-- 使用 sleep + 检查状态循环（命令会自动等待）
-- 下载时只指定目录（必须包含文件名）
-- 跳过读取生成的图片（用户需要看到描述）
+#### 多图参考
+- 最多 8 张输入图
 
-### 必须做：
-- 使用默认等待行为（不要添加 --no-wait）
-- 下载时指定完整文件路径
-- 读取生成的图片并描述给用户
-- 使用英文提示词以获得更好效果
-- 生成视频时使用 512x512 分辨率
+## 视频生成
 
-## 队列管理（如需要）
+从静态图片生成视频（wan2.6-i2v），支持 720P/1080P，5-15 秒。
 
 ```bash
-comfy queue status              # 查看队列状态
-comfy queue clear --confirm     # 清空队列
-comfy interrupt                 # 中断当前任务
+comfy video <图片路径> [options]
 ```
 
-## 系统信息（如需要）
+### 参数
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `-p, --prompt` | 运动/内容描述（最长 1500 字） | - |
+| `-n, --negative` | 负向提示词（最长 500 字） | - |
+| `-o, --output <path>` | 输出目录或完整路径 | - |
+| `-r, --resolution` | 720P \| 1080P | 1080P |
+| `-d, --duration` | 5 \| 10 \| 15 秒 | 5 |
+| `--shot-type` | single \| multi（多镜头叙事） | single |
+| `--no-audio` | 禁用自动配音 | - |
+| `--audio-url <url>` | 自定义音频 URL（需先用 `commerce upload` 上传） | - |
+| `--no-prompt-extend` | 禁用智能改写 prompt | - |
+| `--watermark` | 添加 AI 生成水印 | - |
+| `--seed <number>` | 随机种子（可复现） | - |
+
+### 示例
 
 ```bash
-comfy system stats             # GPU/CPU/内存状态
-comfy config list              # 查看配置
+# 基础用法
+comfy 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"
+
+# 静音视频
+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
+
+# 指定输出路径
+comfy video scene.png -o /home/aiuser/project/result.mp4 --prompt "camera zoom"
+Read /home/aiuser/project/result.mp4
 ```
 
-## 默认配置
+### 注意事项
 
-- 服务器：http://dev.optima.chat:8188
-- 修改服务器：`comfy config set server http://localhost:8188`
-- 输出格式：JSON（优化用于 AI 解析）
+- 输入图片：360-2000px，≤10MB，推荐 1080P 比例
+- 输出规格：30fps，MP4 (H.264)
+- 必须用 `-o` 指定输出路径