@optima-chat/comfy-cli 0.6.2 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -5,6 +5,93 @@ description: "ComfyUI CLI tool for AI agents. ALWAYS use when user wants to: gen
|
|
|
5
5
|
|
|
6
6
|
# ComfyUI CLI
|
|
7
7
|
|
|
8
|
+
## 典型场景
|
|
9
|
+
|
|
10
|
+
### 场景 1：快速生成单张图片
|
|
11
|
+
**用户需求**："帮我生成一张猫的图片"
|
|
12
|
+
**执行步骤**：
|
|
13
|
+
1. `comfy generate "a cute cat sitting on a couch"`
|
|
14
|
+
2. 等待完成（默认行为，显示进度）
|
|
15
|
+
3. 使用返回的 prompt_id 下载：`comfy download <prompt_id>`
|
|
16
|
+
|
|
17
|
+
### 场景 2：批量生成多张图片
|
|
18
|
+
**用户需求**："生成 3 张不同风格的产品图"
|
|
19
|
+
**执行步骤**：
|
|
20
|
+
1. 使用 `--no-wait` 提交多个任务
|
|
21
|
+
2. `comfy queue status` 查看进度
|
|
22
|
+
3. 完成后批量下载
|
|
23
|
+
|
|
24
|
+
### 场景 3：图片迭代优化
|
|
25
|
+
**用户需求**："这张图片不够好，帮我优化"
|
|
26
|
+
**执行步骤**：
|
|
27
|
+
1. 分析用户不满意的点（光线、风格、细节）
|
|
28
|
+
2. 使用 `comfy edit` 添加优化描述
|
|
29
|
+
3. 如需多次尝试，生成多个变体供用户选择
|
|
30
|
+
|
|
31
|
+
### 场景 4：图片生成视频
|
|
32
|
+
**用户需求**："把这张人物照片做成动态视频"
|
|
33
|
+
**执行步骤**：
|
|
34
|
+
1. `comfy video portrait.png --prompt "natural head movement"`
|
|
35
|
+
2. 注意视频推荐使用 512x512 分辨率
|
|
36
|
+
3. 下载后检查效果
|
|
37
|
+
|
|
38
|
+
## 质量标准
|
|
39
|
+
|
|
40
|
+
### 好的生成结果
|
|
41
|
+
- **图像清晰**：无模糊、无伪影
|
|
42
|
+
- **主体突出**：构图合理，主体居中或符合构图原则
|
|
43
|
+
- **光影自然**：避免过曝、过暗、不自然的阴影
|
|
44
|
+
- **提示词匹配**：生成内容符合用户描述
|
|
45
|
+
|
|
46
|
+
### 何时需要重新生成
|
|
47
|
+
- 用户明确表示不满意
|
|
48
|
+
- 生成结果与提示词严重不符
|
|
49
|
+
- 图像质量问题（模糊、伪影、扭曲）
|
|
50
|
+
- 需要尝试不同风格或角度
|
|
51
|
+
|
|
52
|
+
### 提示词建议
|
|
53
|
+
- **具体清晰**：`a golden retriever puppy` 优于 `a dog`
|
|
54
|
+
- **风格描述**：加入 `photorealistic`, `anime style`, `oil painting` 等
|
|
55
|
+
- **细节描述**：材质、光线、背景、氛围
|
|
56
|
+
- **英文提示词**：FLUX 模型对英文效果最好
|
|
57
|
+
|
|
58
|
+
## 常见问题
|
|
59
|
+
|
|
60
|
+
### 问题 1：生成任务提交后无法立即使用
|
|
61
|
+
**原因**：生成需要时间，默认会等待完成
|
|
62
|
+
**解决**：
|
|
63
|
+
- 默认行为会等待并显示进度
|
|
64
|
+
- 如使用 `--no-wait`，需用 `comfy workflow get <prompt_id>` 检查状态
|
|
65
|
+
- status 为 "completed" 后才能下载
|
|
66
|
+
|
|
67
|
+
### 问题 2：视频生成失败或超时
|
|
68
|
+
**原因**：分辨率过大或提示词复杂
|
|
69
|
+
**解决**：
|
|
70
|
+
- 视频推荐使用 512x512 分辨率
|
|
71
|
+
- 避免过长或复杂的提示词
|
|
72
|
+
- 检查服务器状态：`comfy system stats`
|
|
73
|
+
|
|
74
|
+
### 问题 3：生成结果不符合预期
|
|
75
|
+
**原因**：提示词不够具体或缺少细节
|
|
76
|
+
**解决**：
|
|
77
|
+
- 增加具体描述（颜色、材质、风格、光线）
|
|
78
|
+
- 使用参考风格词（如 "product photography", "cinematic"）
|
|
79
|
+
- 尝试生成多个变体（调整提示词细节）
|
|
80
|
+
|
|
81
|
+
### 问题 4：无法连接到 ComfyUI 服务器
|
|
82
|
+
**原因**：服务器未启动或地址配置错误
|
|
83
|
+
**解决**：
|
|
84
|
+
- 检查服务器状态：`comfy system stats`
|
|
85
|
+
- 查看配置：`comfy config list`
|
|
86
|
+
- 如使用本地服务器：`comfy config set server http://localhost:8188`
|
|
87
|
+
|
|
88
|
+
### 问题 5：下载的文件找不到
|
|
89
|
+
**原因**：未指定输出目录或忘记下载路径
|
|
90
|
+
**解决**：
|
|
91
|
+
- 默认保存到 `./output` 目录
|
|
92
|
+
- 使用 `-o` 指定输出路径
|
|
93
|
+
- 检查命令输出的文件路径
|
|
94
|
+
|
|
8
95
|
## Instructions
|
|
9
96
|
|
|
10
97
|
### 核心命令
|
|
@@ -146,9 +233,9 @@ comfy workflow get abc123
|
|
|
146
233
|
comfy download abc123
|
|
147
234
|
```
|
|
148
235
|
|
|
149
|
-
|
|
236
|
+
## 重要提示
|
|
150
237
|
|
|
151
|
-
- 默认连接到 `http://dev.optima.chat:8188
|
|
238
|
+
- 默认连接到 `http://dev.optima.chat:8188`
|
|
152
239
|
- 默认输出 JSON 格式，适合 AI 解析
|
|
153
240
|
- 使用 `--pretty` 获取人类可读输出
|
|
154
|
-
-
|
|
241
|
+
- 默认等待完成并显示实时进度
|