@optima-chat/optima-agent 0.4.1 → 0.4.2

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

@@ -1,189 +1,169 @@
 ---
 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 /工作目录/result.png
 
-# 步骤 2：下载（必须指定完整文件路径，包含文件名）
-comfy download <prompt_id> -o /用户/工作目录/文件名.png
+# 图片编辑/风格转换
+comfy image "转成水彩风格" -i photo.png -o /工作目录/result.png
 
-# 步骤 3：读取图片并向用户描述生成结果
-Read /用户/工作目录/文件名.png
+# 读取并描述结果
+Read /工作目录/result.png
 ```
 
-## 必须遵守的行为规则
+## comfy image 命令
 
-### 生成图片时
-1. 使用 `comfy generate "提示词"` - 命令会自动等待，不要手动检查状态
-2. 下载结果：`comfy download <prompt_id> -o <完整文件路径含文件名>`
-3. 使用 Read 工具读取下载的图片
-4. 向用户描述图片内容（颜色、风格、构图、元素）
+统一的图像生成/编辑命令。
 
-### 下载文件时
-- 必须指定完整文件路径，包含文件名
-- 必须使用用户的工作目录
-- 不能只指定目录（会导致 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 /Users/john/project/cat.png
+Read /Users/john/project/cat.png
 ```
-- 从静态图片生成视频
-- 推荐分辨率：512x512
-- 可选：运动提示词和负向提示词
-- 自动等待完成
 
-### 下载结果
+### 图片风格转换
+
 ```bash
-comfy download <prompt_id> -o <完整文件路径>
+comfy image "watercolor painting style, artistic brushstrokes" -i photo.jpg -o /Users/john/project/watercolor.png
+Read /Users/john/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 /Users/john/project/fusion.png
+Read /Users/john/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 /Users/john/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 /Users/john/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 /Users/john/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 |
-
-## 错误预防
-
-### 不要做：
-- 生成后立即检查状态（还未入队）
-- 使用 sleep + 检查状态循环（命令会自动等待）
-- 下载时只指定目录（必须包含文件名）
-- 跳过读取生成的图片（用户需要看到描述）
-
-### 必须做：
-- 使用默认等待行为（不要添加 --no-wait）
-- 下载时指定完整文件路径
-- 读取生成的图片并描述给用户
-- 使用英文提示词以获得更好效果
-- 生成视频时使用 512x512 分辨率
+| 视频输入 | 512x512 |
 
-## 队列管理（如需要）
+## 视频生成
 
 ```bash
-comfy queue status              # 查看队列状态
-comfy queue clear --confirm     # 清空队列
-comfy interrupt                 # 中断当前任务
+comfy video <图片路径> --prompt "运动描述" --width 512 --height 512
 ```
 
-## 系统信息（如需要）
+从静态图片生成视频，推荐分辨率 512x512。
 
 ```bash
-comfy system stats             # GPU/CPU/内存状态
-comfy config list              # 查看配置
+comfy video /Users/john/portrait.png --prompt "natural facial expression, subtle head movement" --width 512 --height 512
+comfy download <prompt_id> -o /Users/john/project/video.mp4
 ```
 
-## 默认配置
+## 必须遵守的规则
+
+### 生成后
+- 使用 Read 工具查看生成的图片
+- 向用户描述图片内容（颜色、风格、构图、元素）
+- 验证是否符合用户要求
+
+### 尺寸要求
+- 宽高必须是 16 的倍数
+- 最大 4MP，推荐 2MP 内
 
-- 服务器：http://dev.optima.chat:8188
-- 修改服务器：`comfy config set server http://localhost:8188`
-- 输出格式：JSON（优化用于 AI 解析）
+### 多图参考
+- 最多 8 张输入图
+
+## 系统命令
+
+```bash
+comfy queue status                  # 队列状态
+comfy interrupt                     # 中断任务
+```

package/package.json

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