@optima-chat/comfy-cli 0.5.1 → 0.6.0

package/.claude/settings.local.json

@@ -31,7 +31,10 @@
       "Bash(gh issue view:*)",
       "Bash(python3:*)",
       "Bash(git reset:*)",
-      "Bash(git checkout:*)"
+      "Bash(git checkout:*)",
+      "Bash(git branch:*)",
+      "Bash(gh run view:*)",
+      "WebFetch(domain:code.claude.com)"
     ],
     "deny": [],
     "ask": []

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

@@ -3,299 +3,116 @@ name: comfy-cli
 description: "ComfyUI CLI tool for AI agents. ALWAYS use when user wants to: generate images (生成图片/画图/图像/生成画), edit images (编辑图片/修改图片/图生图/改图), create videos (生成视频/图生视频/制作视频), manage ComfyUI workflows (工作流/ComfyUI). Uses 'comfy generate', 'comfy edit', 'comfy video' commands."
 ---
 
-# ComfyUI CLI - AI 图像与视频生成工具
+# ComfyUI CLI
 
-## 何时使用此 Skill
+## Instructions
 
-在以下情况使用此 Skill：
-- 用户想要从文本提示词生成图像（文生图）
-- 用户想要编辑或转换现有图像（图生图）
-- 用户想要从图像创建视频（图生视频）
-- 用户询问 ComfyUI 工作流、队列状态或模型
-- 用户提到：生成图片、画图、图像处理、视频生成、ComfyUI
+### 核心命令
 
-## 可用命令
-
-### 1. 生成图像：`comfy generate`
-
-使用 Stable Diffusion / FLUX 模型从文本提示词生成图像。
-
-**语法：**
-```bash
-comfy generate "提示词" [选项]
-```
-
-**参数：**
-- `提示词`: 要生成图像的文本描述
-- `--width <数字>`: 图像宽度（默认：1024）
-- `--height <数字>`: 图像高度（默认：1024）
-- `--no-wait`: 提交后立即返回，不等待完成
-- `--pretty`: 人类可读的表格格式输出（默认：JSON）
-
-**返回：**
-- 包含 `prompt_id`、`status`、`outputs`（图像文件路径）的 JSON
-- 默认行为：等待完成并显示实时进度
-
-**使用场景：**
-- 用户要求生成/创建图像
-- 用户提供图像描述
-- 文本生成图像
-
-### 2. 编辑图像：`comfy edit`
-
-使用文本提示词编辑或转换现有图像（图生图）。
-
-**语法：**
-```bash
-comfy edit <图像路径> "提示词" [选项]
-```
-
-**参数：**
-- `图像路径`: 输入图像文件的路径
-- `提示词`: 转换描述（例如："动漫风格"、"添加更多细节"）
-- `--no-wait`: 提交后立即返回，不等待完成
-- `--pretty`: 人类可读的表格格式输出（默认：JSON）
-
-**返回：**
-- 包含 `prompt_id`、`status`、`outputs`（编辑后图像文件路径）的 JSON
-- 默认行为：等待完成并显示实时进度
-
-**使用场景：**
-- 用户想要修改/编辑现有图像
-- 用户想要应用风格转换
-- 图像到图像的转换
-
-### 3. 创建视频：`comfy video`
-
-使用 I2V（图像到视频）模型从图像生成视频。
-
-**语法：**
-```bash
-comfy video <图像路径> [选项]
-```
-
-**参数：**
-- `图像路径`: 输入图像文件的路径
-- `-p, --prompt <文本>`: 运动描述提示词（可选）
-- `-n, --negative <文本>`: 负面提示词（可选）
-- `--width <数字>`: 视频宽度（默认：512）
-- `--height <数字>`: 视频高度（默认：512）
-- `--no-wait`: 提交后立即返回，不等待完成
-- `--pretty`: 人类可读的表格格式输出（默认：JSON）
-
-**返回：**
-- 包含 `prompt_id`、`status`、`outputs`（视频文件路径）的 JSON
-- 默认行为：等待完成并显示实时进度
-
-**使用场景：**
-- 用户想要为静态图像添加动画
-- 用户想要从图像创建视频
-- 图像到视频的生成
-
-### 4. 下载结果：`comfy download`
-
-将生成的图像/视频下载到本地目录。
-
-**语法：**
+**生成图像：**
 ```bash
-comfy download <PROMPT_ID> [选项]
+comfy generate "提示词" [--width 1024] [--height 1024] [--no-wait] [--pretty]
 ```
+- 从文本提示词生成图像
+- 默认等待完成并显示实时进度，返回 JSON
+- `--no-wait`: 提交后立即返回
+- `--pretty`: 人类可读的表格格式
 
-**参数：**
-- `PROMPT_ID`: 从 generate/edit/video 命令返回的提示词 ID
-- `-o, --output <目录>`: 输出目录（默认：./comfy-output）
-- `--pretty`: 人类可读的输出
-
-**返回：**
-- 包含已下载文件路径的 JSON
-
-### 5. 工作流管理
-
-**列出工作流历史：**
+**编辑图像：**
 ```bash
-comfy workflow list [--limit 10] [--pretty]
+comfy edit <图像路径> "提示词" [--no-wait] [--pretty]
 ```
+- 使用文本提示词编辑或转换现有图像
+- 支持风格转换、细节增强等
 
-**获取工作流结果：**
+**生成视频：**
 ```bash
-comfy workflow get <PROMPT_ID> [--pretty]
+comfy video <图像路径> [-p "运动描述"] [-n "负面提示"] [--width 512] [--height 512] [--no-wait] [--pretty]
 ```
+- 从图像生成视频（图生视频）
+- 可选运动描述和负面提示
 
-**提交自定义工作流：**
+**下载结果：**
 ```bash
-comfy workflow submit <工作流文件> [--pretty]
+comfy download <PROMPT_ID> [-o ./comfy-output] [--pretty]
 ```
+- 下载生成的图像/视频到本地目录
 
-### 6. 队列管理
-
-**检查队列状态：**
-```bash
-comfy queue status [--pretty]
-```
+### 工作流管理
 
-**清空队列：**
 ```bash
-comfy queue clear --confirm [--pretty]
+comfy workflow list [--limit 10] [--pretty]          # 列出历史
+comfy workflow get <PROMPT_ID> [--pretty]            # 获取结果
+comfy workflow submit <工作流文件> [--pretty]         # 提交自定义工作流
 ```
 
-**删除队列项：**
-```bash
-comfy queue delete <项目ID> [--pretty]
-```
+### 队列管理
 
-**中断当前执行：**
 ```bash
-comfy interrupt [--pretty]
+comfy queue status [--pretty]                        # 查看队列状态
+comfy queue clear --confirm [--pretty]               # 清空队列
+comfy queue delete <项目ID> [--pretty]               # 删除队列项
+comfy interrupt [--pretty]                           # 中断当前执行
 ```
 
-### 7. 模型管理
+### 模型管理
 
-**列出可用模型：**
 ```bash
-comfy model list [--type checkpoints|loras|vae|...] [--pretty]
+comfy model list [--type checkpoints|loras|vae|controlnet|upscale_models] [--pretty]
 ```
 
-**模型类型：**
-- `checkpoints`: Stable Diffusion / FLUX 检查点模型
-- `loras`: LoRA 模型
-- `vae`: VAE 模型
-- `controlnet`: ControlNet 模型
-- `upscale_models`: 放大模型
+### 系统信息
 
-### 8. 系统信息
-
-**获取系统状态：**
 ```bash
-comfy system stats [--pretty]
+comfy system stats [--pretty]                        # GPU/CPU/内存状态
 ```
 
-返回：GPU/CPU 使用率、内存、设备信息
-
-### 9. 配置
-
-**设置 ComfyUI 服务器地址（首次使用必需）：**
-```bash
-comfy config set server http://localhost:8188
-```
+### 配置
 
-**查看当前配置：**
 ```bash
-comfy config list [--pretty]
-```
-
-**其他配置选项：**
-```bash
-comfy config set timeout 30000
-comfy config set outputDir ./my-outputs
-```
-
-## 输出格式
-
-所有命令默认输出 **JSON 格式**（AI 友好，减少 50%+ token）：
-
-```json
-{
-  "success": true,
-  "data": {
-    "prompt_id": "abc123",
-    "status": "completed",
-    "outputs": ["./comfy-output/image_001.png"]
-  }
-}
+comfy config set server http://localhost:8188        # 设置服务器地址（首次必需）
+comfy config list [--pretty]                         # 查看当前配置
 ```
 
-使用 `--pretty` 标志获取带颜色的人类可读表格格式。
+### 输出格式
 
-## 工作流示例
+- **默认**：JSON 格式（AI 友好，减少 token）
+- **--pretty**：带颜色的表格格式（人类可读）
 
-### 示例 1：快速生成图像
-**用户**："帮我生成一张猫的图片"
+## Examples
 
-**助手**：
+### 示例 1：生成图像
 ```bash
 comfy generate "a cute cat"
 ```
-
-**结果**：返回包含 `prompt_id` 和 `outputs`（包含图像文件路径）的 JSON。默认行为等待完成并通过 WebSocket 显示实时进度。
+返回包含 `prompt_id` 和 `outputs`（图像文件路径）的 JSON
 
 ### 示例 2：高分辨率图像
-**用户**："生成一张 1920x1080 的风景画"
-
-**助手**：
 ```bash
-comfy generate "beautiful landscape with mountains and lake" --width 1920 --height 1080
+comfy generate "beautiful landscape with mountains" --width 1920 --height 1080
 ```
 
 ### 示例 3：图像风格转换
-**用户**："把这张图片改成动漫风格"
-
-**助手**（假设用户上传了 `photo.jpg`）：
 ```bash
 comfy edit photo.jpg "anime style"
 ```
 
-### 示例 4：添加细节的图像编辑
-**用户**："给这张照片添加更多细节，提高质量"
-
-**助手**：
-```bash
-comfy edit photo.jpg "add more details, enhance quality, 4k resolution"
-```
-
-### 示例 5：视频创建
-**用户**："用这张人物图片生成一个视频"
-
-**助手**：
+### 示例 4：视频生成
 ```bash
 comfy video portrait.png --prompt "smooth motion, natural movement"
 ```
 
-### 示例 6：非阻塞生成
-**用户**："生成一张图片，不用等完成"
-
-**助手**：
-```bash
-comfy generate "sunset over ocean" --no-wait
-```
-
-立即返回 `prompt_id`。稍后检查状态：
-```bash
-comfy workflow get <prompt_id>
-```
-
-### 示例 7：批量图像生成
-**用户**："帮我生成 3 张不同的猫的图片"
-
-**助手**：
-```bash
-comfy generate "a cute cat sitting" --no-wait
-comfy generate "a cat playing with toys" --no-wait
-comfy generate "a cat sleeping on a couch" --no-wait
-```
-
-然后检查队列状态：
+### 示例 5：批量生成（非阻塞）
 ```bash
+comfy generate "a cat sitting" --no-wait
+comfy generate "a cat playing" --no-wait
+comfy generate "a cat sleeping" --no-wait
 comfy queue status
 ```
 
-### 示例 8：检查模型后生成
-**用户**："检查一下有哪些可用的模型，然后生成图片"
-
-**助手**：
-```bash
-# 首先检查可用模型
-comfy model list --type checkpoints
-
-# 然后使用适当的提示词生成
-comfy generate "a beautiful portrait"
-```
-
-### 示例 9：完整工作流
-**用户**："生成一张图片，编辑它，然后生成视频"
-
-**助手**：
+### 示例 6：完整工作流
 ```bash
-# 1. 生成基础图像
+# 1. 生成图像
 comfy generate "a portrait of a woman"
 # 输出：./comfy-output/image_001.png
 
@@ -303,139 +120,27 @@ comfy generate "a portrait of a woman"
 comfy edit ./comfy-output/image_001.png "add cinematic lighting"
 # 输出：./comfy-output/image_002.png
 
-# 3. 从编辑后的图像创建视频
-comfy video ./comfy-output/image_002.png --prompt "slow motion, cinematic"
+# 3. 生成视频
+comfy video ./comfy-output/image_002.png --prompt "slow motion"
 # 输出：./comfy-output/video_001.mp4
 ```
 
-## 最佳实践
-
-### 1. 输出格式选择
-- **默认（JSON）**：最适合 AI 代理、编程解析，减少 token
-- **Pretty 模式**：最适合人工检查、调试、视觉反馈
-- 当用户明确要求查看格式化输出时使用 `--pretty`
-
-### 2. 等待策略
-- **默认（wait）**：推荐用于交互式工作流，显示实时进度
-- **--no-wait**：用于提交多个任务、批处理或耗时操作
-- 使用 `--no-wait` 后，用 `comfy workflow get <prompt_id>` 检查完成状态
-
-### 3. 错误处理
-- 始终检查 JSON 响应中的 `success` 字段
-- 如果发生错误，检查：
-  1. ComfyUI 服务器是否运行：`comfy system stats`
-  2. 服务器地址是否正确：`comfy config list`
-  3. 队列是否卡住：`comfy queue status`
-
-### 4. 性能优化
-- 使用适当的图像尺寸（SD 用 1024x1024，视频用 512x512）
-- 批量操作时考虑使用 `--no-wait`
-- 大型生成前检查系统资源：`comfy system stats`
-
-### 5. 首次设置
-首次使用前务必配置服务器地址：
-```bash
-comfy config set server http://localhost:8188
-```
-
-## 常用模式
-
-### 模式 1：生成并下载
+### 示例 7：检查状态和下载
 ```bash
-# 生成图像
-comfy generate "a cat" --no-wait
+# 非阻塞提交
+comfy generate "sunset" --no-wait
 # 返回：{ "prompt_id": "abc123" }
 
-# 稍后下载结果
-comfy download abc123
-```
-
-### 模式 2：迭代编辑
-```bash
-# 从基础图像开始
-comfy generate "a portrait"
-
-# 编辑步骤 1
-comfy edit output_001.png "add dramatic lighting"
+# 稍后检查状态
+comfy workflow get abc123
 
-# 编辑步骤 2
-comfy edit output_002.png "increase contrast"
+# 下载结果
+comfy download abc123
 ```
 
-### 模式 3：队列管理
-```bash
-# 提交多个任务
-comfy generate "cat" --no-wait
-comfy generate "dog" --no-wait
-comfy generate "bird" --no-wait
-
-# 检查队列
-comfy queue status
-
-# 如需要，清空队列
-comfy queue clear --confirm
-```
+### 重要提示
 
-## 提示
-
-**服务器连接：**
-- 默认服务器：`http://localhost:8188`
-- 远程服务器：`comfy config set server http://remote-ip:8188`
-- 检查连接：`comfy system stats`
-
-**模型选择：**
-- ComfyUI 自动使用默认检查点模型
-- 检查可用模型：`comfy model list --type checkpoints`
-- 自定义工作流：`comfy workflow submit custom.json`
-
-**输出文件：**
-- 默认输出目录：`./comfy-output/`
-- 修改：`comfy config set outputDir ./my-outputs`
-- 下载的文件保留原始 ComfyUI 文件名
-
-**实时进度：**
-- 默认等待模式通过 WebSocket 显示进度
-- 进度包括：节点执行、当前步骤、百分比
-- 使用 `--no-wait` 跳过进度监控
-
-**中断：**
-- 停止当前生成：`comfy interrupt`
-- 清空待处理任务：`comfy queue clear --confirm`
-
-**JSON 解析：**
-- 所有 JSON 响应遵循一致的结构
-- 首先检查 `success` 字段
-- 通过 `data` 字段访问数据
-- 错误包含带详细信息的 `error` 字段
-
-## 配置
-
-配置文件位置：`~/.comfy-cli/config.json`
-
-**可用设置：**
-- `server`: ComfyUI 服务器地址（必需）
-- `timeout`: 请求超时时间（毫秒，默认：30000）
-- `autoConnect`: 自动连接到 WebSocket（默认：true）
-- `outputDir`: 默认输出目录（默认：`./comfy-output`）
-
-## 故障排除
-
-**"Connection refused" 错误：**
-- 确保 ComfyUI 正在运行：在浏览器检查 http://localhost:8188
-- 验证服务器地址：`comfy config list`
-- 测试连接：`comfy system stats`
-
-**"Workflow failed" 错误：**
-- 检查 JSON 响应中的错误详情
-- 验证模型文件可用：`comfy model list`
-- 检查 ComfyUI 控制台日志
-
-**生成缓慢：**
-- 检查 GPU 可用性：`comfy system stats`
-- 降低图像分辨率
-- 检查队列：`comfy queue status`
-
-**输出文件丢失：**
-- 检查输出目录：`comfy config list`
-- 验证生成已完成：`comfy workflow get <prompt_id>`
-- 使用 `comfy download <prompt_id>` 重新下载
+- 首次使用前必须配置服务器地址：`comfy config set server http://localhost:8188`
+- 默认输出 JSON 格式，适合 AI 解析
+- 使用 `--pretty` 获取人类可读输出
+- 默认等待完成并显示实时进度，使用 `--no-wait` 跳过等待

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/comfy-cli",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "A CLI tool for ComfyUI designed for LLM interactions",
   "type": "module",
   "main": "dist/index.js",