@optima-chat/comfy-cli 0.5.0 → 0.5.1

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

@@ -3,195 +3,195 @@ 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 Image & Video Generation
+# ComfyUI CLI - AI 图像与视频生成工具
 
-## When to Use This Skill
+## 何时使用此 Skill
 
-Use this skill when:
-- User wants to generate images from text prompts (文生图)
-- User wants to edit or transform existing images (图生图)
-- User wants to create videos from images (图生视频)
-- User asks about ComfyUI workflows, queue status, or models
-- User mentions: 生成图片、画图、图像处理、视频生成、ComfyUI
+在以下情况使用此 Skill：
+- 用户想要从文本提示词生成图像（文生图）
+- 用户想要编辑或转换现有图像（图生图）
+- 用户想要从图像创建视频（图生视频）
+- 用户询问 ComfyUI 工作流、队列状态或模型
+- 用户提到：生成图片、画图、图像处理、视频生成、ComfyUI
 
-## Available Commands
+## 可用命令
 
-### 1. Generate Images: `comfy generate`
+### 1. 生成图像：`comfy generate`
 
-Generate images from text prompts using Stable Diffusion / FLUX models.
+使用 Stable Diffusion / FLUX 模型从文本提示词生成图像。
 
-**Syntax:**
+**语法：**
 ```bash
-comfy generate "PROMPT" [OPTIONS]
+comfy generate "提示词" [选项]
 ```
 
-**Parameters:**
-- `PROMPT`: Text description of the image to generate
-- `--width <number>`: Image width (default: 1024)
-- `--height <number>`: Image height (default: 1024)
-- `--no-wait`: Submit and return immediately without waiting for completion
-- `--pretty`: Human-readable table format output (default: JSON)
+**参数：**
+- `提示词`: 要生成图像的文本描述
+- `--width <数字>`: 图像宽度（默认：1024）
+- `--height <数字>`: 图像高度（默认：1024）
+- `--no-wait`: 提交后立即返回，不等待完成
+- `--pretty`: 人类可读的表格格式输出（默认：JSON）
 
-**Returns:**
-- JSON with `prompt_id`, `status`, `outputs` (image file paths)
-- Default behavior: waits for completion and shows real-time progress
+**返回：**
+- 包含 `prompt_id`、`status`、`outputs`（图像文件路径）的 JSON
+- 默认行为：等待完成并显示实时进度
 
-**When to use:**
-- User asks to generate/create images from text
-- User provides image description
-- Text-to-image generation
+**使用场景：**
+- 用户要求生成/创建图像
+- 用户提供图像描述
+- 文本生成图像
 
-### 2. Edit Images: `comfy edit`
+### 2. 编辑图像：`comfy edit`
 
-Edit or transform existing images with text prompts (Image-to-Image).
+使用文本提示词编辑或转换现有图像（图生图）。
 
-**Syntax:**
+**语法：**
 ```bash
-comfy edit <IMAGE_PATH> "PROMPT" [OPTIONS]
+comfy edit <图像路径> "提示词" [选项]
 ```
 
-**Parameters:**
-- `IMAGE_PATH`: Path to input image file
-- `PROMPT`: Transformation description (e.g., "anime style", "add more details")
-- `--no-wait`: Submit and return immediately without waiting for completion
-- `--pretty`: Human-readable table format output (default: JSON)
+**参数：**
+- `图像路径`: 输入图像文件的路径
+- `提示词`: 转换描述（例如："动漫风格"、"添加更多细节"）
+- `--no-wait`: 提交后立即返回，不等待完成
+- `--pretty`: 人类可读的表格格式输出（默认：JSON）
 
-**Returns:**
-- JSON with `prompt_id`, `status`, `outputs` (edited image file paths)
-- Default behavior: waits for completion and shows real-time progress
+**返回：**
+- 包含 `prompt_id`、`status`、`outputs`（编辑后图像文件路径）的 JSON
+- 默认行为：等待完成并显示实时进度
 
-**When to use:**
-- User wants to modify/edit an existing image
-- User wants to apply style transfer
-- Image-to-image transformation
+**使用场景：**
+- 用户想要修改/编辑现有图像
+- 用户想要应用风格转换
+- 图像到图像的转换
 
-### 3. Create Videos: `comfy video`
+### 3. 创建视频：`comfy video`
 
-Generate videos from images using I2V (Image-to-Video) models.
+使用 I2V（图像到视频）模型从图像生成视频。
 
-**Syntax:**
+**语法：**
 ```bash
-comfy video <IMAGE_PATH> [OPTIONS]
+comfy video <图像路径> [选项]
 ```
 
-**Parameters:**
-- `IMAGE_PATH`: Path to input image file
-- `-p, --prompt <text>`: Motion description prompt (optional)
-- `-n, --negative <text>`: Negative prompt (optional)
-- `--width <number>`: Video width (default: 512)
-- `--height <number>`: Video height (default: 512)
-- `--no-wait`: Submit and return immediately without waiting for completion
-- `--pretty`: Human-readable table format output (default: JSON)
+**参数：**
+- `图像路径`: 输入图像文件的路径
+- `-p, --prompt <文本>`: 运动描述提示词（可选）
+- `-n, --negative <文本>`: 负面提示词（可选）
+- `--width <数字>`: 视频宽度（默认：512）
+- `--height <数字>`: 视频高度（默认：512）
+- `--no-wait`: 提交后立即返回，不等待完成
+- `--pretty`: 人类可读的表格格式输出（默认：JSON）
 
-**Returns:**
-- JSON with `prompt_id`, `status`, `outputs` (video file paths)
-- Default behavior: waits for completion and shows real-time progress
+**返回：**
+- 包含 `prompt_id`、`status`、`outputs`（视频文件路径）的 JSON
+- 默认行为：等待完成并显示实时进度
 
-**When to use:**
-- User wants to animate a static image
-- User wants to create video from image
-- Image-to-video generation
+**使用场景：**
+- 用户想要为静态图像添加动画
+- 用户想要从图像创建视频
+- 图像到视频的生成
 
-### 4. Download Results: `comfy download`
+### 4. 下载结果：`comfy download`
 
-Download generated images/videos to local directory.
+将生成的图像/视频下载到本地目录。
 
-**Syntax:**
+**语法：**
 ```bash
-comfy download <PROMPT_ID> [OPTIONS]
+comfy download <PROMPT_ID> [选项]
 ```
 
-**Parameters:**
-- `PROMPT_ID`: The prompt ID returned from generate/edit/video commands
-- `-o, --output <dir>`: Output directory (default: ./comfy-output)
-- `--pretty`: Human-readable output
+**参数：**
+- `PROMPT_ID`: 从 generate/edit/video 命令返回的提示词 ID
+- `-o, --output <目录>`: 输出目录（默认：./comfy-output）
+- `--pretty`: 人类可读的输出
 
-**Returns:**
-- JSON with downloaded file paths
+**返回：**
+- 包含已下载文件路径的 JSON
 
-### 5. Workflow Management
+### 5. 工作流管理
 
-**List workflow history:**
+**列出工作流历史：**
 ```bash
 comfy workflow list [--limit 10] [--pretty]
 ```
 
-**Get workflow result:**
+**获取工作流结果：**
 ```bash
 comfy workflow get <PROMPT_ID> [--pretty]
 ```
 
-**Submit custom workflow:**
+**提交自定义工作流：**
 ```bash
-comfy workflow submit <WORKFLOW_FILE> [--pretty]
+comfy workflow submit <工作流文件> [--pretty]
 ```
 
-### 6. Queue Management
+### 6. 队列管理
 
-**Check queue status:**
+**检查队列状态：**
 ```bash
 comfy queue status [--pretty]
 ```
 
-**Clear queue:**
+**清空队列：**
 ```bash
 comfy queue clear --confirm [--pretty]
 ```
 
-**Delete queue item:**
+**删除队列项：**
 ```bash
-comfy queue delete <ITEM_ID> [--pretty]
+comfy queue delete <项目ID> [--pretty]
 ```
 
-**Interrupt current execution:**
+**中断当前执行：**
 ```bash
 comfy interrupt [--pretty]
 ```
 
-### 7. Model Management
+### 7. 模型管理
 
-**List available models:**
+**列出可用模型：**
 ```bash
 comfy model list [--type checkpoints|loras|vae|...] [--pretty]
 ```
 
-**Model types:**
-- `checkpoints`: Stable Diffusion / FLUX checkpoint models
-- `loras`: LoRA models
-- `vae`: VAE models
-- `controlnet`: ControlNet models
-- `upscale_models`: Upscaler models
+**模型类型：**
+- `checkpoints`: Stable Diffusion / FLUX 检查点模型
+- `loras`: LoRA 模型
+- `vae`: VAE 模型
+- `controlnet`: ControlNet 模型
+- `upscale_models`: 放大模型
 
-### 8. System Information
+### 8. 系统信息
 
-**Get system stats:**
+**获取系统状态：**
 ```bash
 comfy system stats [--pretty]
 ```
 
-Returns: GPU/CPU usage, memory, device info
+返回：GPU/CPU 使用率、内存、设备信息
 
-### 9. Configuration
+### 9. 配置
 
-**Set ComfyUI server address (required for first use):**
+**设置 ComfyUI 服务器地址（首次使用必需）：**
 ```bash
 comfy config set server http://localhost:8188
 ```
 
-**View current config:**
+**查看当前配置：**
 ```bash
 comfy config list [--pretty]
 ```
 
-**Other config options:**
+**其他配置选项：**
 ```bash
 comfy config set timeout 30000
 comfy config set outputDir ./my-outputs
 ```
 
-## Output Format
+## 输出格式
 
-All commands default to **JSON output** (AI-friendly, reduces 50%+ tokens):
+所有命令默认输出 **JSON 格式**（AI 友好，减少 50%+ token）：
 
 ```json
 {
@@ -204,238 +204,238 @@ All commands default to **JSON output** (AI-friendly, reduces 50%+ tokens):
 }
 ```
 
-Use `--pretty` flag for human-readable table format with colors.
+使用 `--pretty` 标志获取带颜色的人类可读表格格式。
 
-## Workflow Examples
+## 工作流示例
 
-### Example 1: Quick Image Generation
-**User**: "帮我生成一张猫的图片"
+### 示例 1：快速生成图像
+**用户**："帮我生成一张猫的图片"
 
-**Assistant**:
+**助手**：
 ```bash
 comfy generate "a cute cat"
 ```
 
-**Result**: Returns JSON with `prompt_id` and `outputs` containing image file paths. Default behavior waits for completion and shows real-time progress via WebSocket.
+**结果**：返回包含 `prompt_id` 和 `outputs`（包含图像文件路径）的 JSON。默认行为等待完成并通过 WebSocket 显示实时进度。
 
-### Example 2: High-Resolution Image
-**User**: "生成一张 1920x1080 的风景画"
+### 示例 2：高分辨率图像
+**用户**："生成一张 1920x1080 的风景画"
 
-**Assistant**:
+**助手**：
 ```bash
 comfy generate "beautiful landscape with mountains and lake" --width 1920 --height 1080
 ```
 
-### Example 3: Image Style Transfer
-**User**: "把这张图片改成动漫风格"
+### 示例 3：图像风格转换
+**用户**："把这张图片改成动漫风格"
 
-**Assistant** (assuming user uploaded `photo.jpg`):
+**助手**（假设用户上传了 `photo.jpg`）：
 ```bash
 comfy edit photo.jpg "anime style"
 ```
 
-### Example 4: Image Editing with Details
-**User**: "给这张照片添加更多细节，提高质量"
+### 示例 4：添加细节的图像编辑
+**用户**："给这张照片添加更多细节，提高质量"
 
-**Assistant**:
+**助手**：
 ```bash
 comfy edit photo.jpg "add more details, enhance quality, 4k resolution"
 ```
 
-### Example 5: Video Creation
-**User**: "用这张人物图片生成一个视频"
+### 示例 5：视频创建
+**用户**："用这张人物图片生成一个视频"
 
-**Assistant**:
+**助手**：
 ```bash
 comfy video portrait.png --prompt "smooth motion, natural movement"
 ```
 
-### Example 6: Non-blocking Generation
-**User**: "生成一张图片，不用等完成"
+### 示例 6：非阻塞生成
+**用户**："生成一张图片，不用等完成"
 
-**Assistant**:
+**助手**：
 ```bash
 comfy generate "sunset over ocean" --no-wait
 ```
 
-Returns immediately with `prompt_id`. Check status later with:
+立即返回 `prompt_id`。稍后检查状态：
 ```bash
 comfy workflow get <prompt_id>
 ```
 
-### Example 7: Batch Image Generation
-**User**: "帮我生成 3 张不同的猫的图片"
+### 示例 7：批量图像生成
+**用户**："帮我生成 3 张不同的猫的图片"
 
-**Assistant**:
+**助手**：
 ```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
 ```
 
-Then check queue status:
+然后检查队列状态：
 ```bash
 comfy queue status
 ```
 
-### Example 8: Workflow with Model Check
-**User**: "检查一下有哪些可用的模型，然后生成图片"
+### 示例 8：检查模型后生成
+**用户**："检查一下有哪些可用的模型，然后生成图片"
 
-**Assistant**:
+**助手**：
 ```bash
-# First check available models
+# 首先检查可用模型
 comfy model list --type checkpoints
 
-# Then generate with appropriate prompt
+# 然后使用适当的提示词生成
 comfy generate "a beautiful portrait"
 ```
 
-### Example 9: Complete Workflow
-**User**: "生成一张图片，编辑它，然后生成视频"
+### 示例 9：完整工作流
+**用户**："生成一张图片，编辑它，然后生成视频"
 
-**Assistant**:
+**助手**：
 ```bash
-# 1. Generate base image
+# 1. 生成基础图像
 comfy generate "a portrait of a woman"
-# Output: ./comfy-output/image_001.png
+# 输出：./comfy-output/image_001.png
 
-# 2. Edit the image
+# 2. 编辑图像
 comfy edit ./comfy-output/image_001.png "add cinematic lighting"
-# Output: ./comfy-output/image_002.png
+# 输出：./comfy-output/image_002.png
 
-# 3. Create video from edited image
+# 3. 从编辑后的图像创建视频
 comfy video ./comfy-output/image_002.png --prompt "slow motion, cinematic"
-# Output: ./comfy-output/video_001.mp4
+# 输出：./comfy-output/video_001.mp4
 ```
 
-## Best Practices
+## 最佳实践
 
-### 1. Output Format Selection
-- **Default (JSON)**: Best for AI agents, programmatic parsing, reduces tokens
-- **Pretty mode**: Best for human inspection, debugging, visual feedback
-- Use `--pretty` when user explicitly wants to see formatted output
+### 1. 输出格式选择
+- **默认（JSON）**：最适合 AI 代理、编程解析，减少 token
+- **Pretty 模式**：最适合人工检查、调试、视觉反馈
+- 当用户明确要求查看格式化输出时使用 `--pretty`
 
-### 2. Wait Strategy
-- **Default (wait)**: Recommended for interactive workflows, shows real-time progress
-- **--no-wait**: Use when submitting multiple jobs, batch processing, or time-consuming operations
-- After `--no-wait`, use `comfy workflow get <prompt_id>` to check completion
+### 2. 等待策略
+- **默认（wait）**：推荐用于交互式工作流，显示实时进度
+- **--no-wait**：用于提交多个任务、批处理或耗时操作
+- 使用 `--no-wait` 后，用 `comfy workflow get <prompt_id>` 检查完成状态
 
-### 3. Error Handling
-- Always check `success` field in JSON response
-- If error occurs, check:
-  1. ComfyUI server is running: `comfy system stats`
-  2. Server address is correct: `comfy config list`
-  3. Queue is not stuck: `comfy queue status`
+### 3. 错误处理
+- 始终检查 JSON 响应中的 `success` 字段
+- 如果发生错误，检查：
+  1. ComfyUI 服务器是否运行：`comfy system stats`
+  2. 服务器地址是否正确：`comfy config list`
+  3. 队列是否卡住：`comfy queue status`
 
-### 4. Performance Optimization
-- Use appropriate image sizes (1024x1024 for SD, 512x512 for videos)
-- Consider `--no-wait` for batch operations
-- Check system resources before large generations: `comfy system stats`
+### 4. 性能优化
+- 使用适当的图像尺寸（SD 用 1024x1024，视频用 512x512）
+- 批量操作时考虑使用 `--no-wait`
+- 大型生成前检查系统资源：`comfy system stats`
 
-### 5. First-time Setup
-Always configure server address before first use:
+### 5. 首次设置
+首次使用前务必配置服务器地址：
 ```bash
 comfy config set server http://localhost:8188
 ```
 
-## Common Patterns
+## 常用模式
 
-### Pattern 1: Generate and Download
+### 模式 1：生成并下载
 ```bash
-# Generate image
+# 生成图像
 comfy generate "a cat" --no-wait
-# Returns: { "prompt_id": "abc123" }
+# 返回：{ "prompt_id": "abc123" }
 
-# Download result later
+# 稍后下载结果
 comfy download abc123
 ```
 
-### Pattern 2: Iterative Editing
+### 模式 2：迭代编辑
 ```bash
-# Start with base image
+# 从基础图像开始
 comfy generate "a portrait"
 
-# Edit step 1
+# 编辑步骤 1
 comfy edit output_001.png "add dramatic lighting"
 
-# Edit step 2
+# 编辑步骤 2
 comfy edit output_002.png "increase contrast"
 ```
 
-### Pattern 3: Queue Management
+### 模式 3：队列管理
 ```bash
-# Submit multiple jobs
+# 提交多个任务
 comfy generate "cat" --no-wait
 comfy generate "dog" --no-wait
 comfy generate "bird" --no-wait
 
-# Check queue
+# 检查队列
 comfy queue status
 
-# If needed, clear queue
+# 如需要，清空队列
 comfy queue clear --confirm
 ```
 
-## Tips
+## 提示
 
-**Server Connection:**
-- Default server: `http://localhost:8188`
-- For remote servers: `comfy config set server http://remote-ip:8188`
-- Check connection: `comfy system stats`
+**服务器连接：**
+- 默认服务器：`http://localhost:8188`
+- 远程服务器：`comfy config set server http://remote-ip:8188`
+- 检查连接：`comfy system stats`
 
-**Model Selection:**
-- ComfyUI automatically uses default checkpoint model
-- Check available models: `comfy model list --type checkpoints`
-- For custom workflows, use: `comfy workflow submit custom.json`
+**模型选择：**
+- ComfyUI 自动使用默认检查点模型
+- 检查可用模型：`comfy model list --type checkpoints`
+- 自定义工作流：`comfy workflow submit custom.json`
 
-**Output Files:**
-- Default output directory: `./comfy-output/`
-- Change with: `comfy config set outputDir ./my-outputs`
-- Downloaded files retain original ComfyUI filenames
+**输出文件：**
+- 默认输出目录：`./comfy-output/`
+- 修改：`comfy config set outputDir ./my-outputs`
+- 下载的文件保留原始 ComfyUI 文件名
 
-**Real-time Progress:**
-- Default wait mode shows progress via WebSocket
-- Progress includes: node execution, current step, percentage
-- Use `--no-wait` to skip progress monitoring
+**实时进度：**
+- 默认等待模式通过 WebSocket 显示进度
+- 进度包括：节点执行、当前步骤、百分比
+- 使用 `--no-wait` 跳过进度监控
 
-**Interruption:**
-- Stop current generation: `comfy interrupt`
-- Clear pending jobs: `comfy queue clear --confirm`
+**中断：**
+- 停止当前生成：`comfy interrupt`
+- 清空待处理任务：`comfy queue clear --confirm`
 
-**JSON Parsing:**
-- All JSON responses follow consistent structure
-- Check `success` field first
-- Access data via `data` field
-- Errors include `error` field with details
+**JSON 解析：**
+- 所有 JSON 响应遵循一致的结构
+- 首先检查 `success` 字段
+- 通过 `data` 字段访问数据
+- 错误包含带详细信息的 `error` 字段
 
-## Configuration
+## 配置
 
-Config file location: `~/.comfy-cli/config.json`
+配置文件位置：`~/.comfy-cli/config.json`
 
-**Available settings:**
-- `server`: ComfyUI server address (required)
-- `timeout`: Request timeout in milliseconds (default: 30000)
-- `autoConnect`: Auto-connect to WebSocket (default: true)
-- `outputDir`: Default output directory (default: `./comfy-output`)
+**可用设置：**
+- `server`: ComfyUI 服务器地址（必需）
+- `timeout`: 请求超时时间（毫秒，默认：30000）
+- `autoConnect`: 自动连接到 WebSocket（默认：true）
+- `outputDir`: 默认输出目录（默认：`./comfy-output`）
 
-## Troubleshooting
+## 故障排除
 
-**"Connection refused" error:**
-- Ensure ComfyUI is running: Check browser at http://localhost:8188
-- Verify server address: `comfy config list`
-- Test connection: `comfy system stats`
+**"Connection refused" 错误：**
+- 确保 ComfyUI 正在运行：在浏览器检查 http://localhost:8188
+- 验证服务器地址：`comfy config list`
+- 测试连接：`comfy system stats`
 
-**"Workflow failed" error:**
-- Check error details in JSON response
-- Verify model files are available: `comfy model list`
-- Check ComfyUI console logs
+**"Workflow failed" 错误：**
+- 检查 JSON 响应中的错误详情
+- 验证模型文件可用：`comfy model list`
+- 检查 ComfyUI 控制台日志
 
-**Slow generation:**
-- Check GPU availability: `comfy system stats`
-- Reduce image resolution
-- Check queue: `comfy queue status`
+**生成缓慢：**
+- 检查 GPU 可用性：`comfy system stats`
+- 降低图像分辨率
+- 检查队列：`comfy queue status`
 
-**Missing output files:**
-- Check output directory: `comfy config list`
-- Verify generation completed: `comfy workflow get <prompt_id>`
-- Use `comfy download <prompt_id>` to re-download
+**输出文件丢失：**
+- 检查输出目录：`comfy config list`
+- 验证生成已完成：`comfy workflow get <prompt_id>`
+- 使用 `comfy download <prompt_id>` 重新下载

package/package.json

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