名称： comfy-cli
描述： 用于安装、管理和运行 ComfyUI 实例的命令行工具。适用于设置 ComfyUI、启动服务器、安装/更新/调试自定义节点、从 CivitAI/HuggingFace 下载模型、管理工作区、运行 API 工作流，或使用二分法排查节点冲突。
元数据： {"clawdbot":{"emoji":"🎨","requires":{"bins":["comfy"]},"install":[{"id":"uv","kind":"uv","package":"comfy-cli","bins":["comfy"],"label":"安装 comfy-cli (uv)"}]}}

comfy-cli

用于管理 ComfyUI 安装、自定义节点和模型的命令行工具。

快速开始

comfy install                          # 安装 ComfyUI + ComfyUI-Manager
comfy launch                           # 启动 ComfyUI 服务器
comfy node install ComfyUI-Impact-Pack # 安装自定义节点
comfy model download --url "https://civitai.com/api/download/models/12345"

安装

comfy install                          # 交互式选择 GPU
comfy install --nvidia                 # NVIDIA GPU
comfy install --amd                    # AMD GPU (Linux ROCm)
comfy install --m-series               # Apple Silicon
comfy install --cpu                    # 仅 CPU
comfy install --restore                # 为现有安装恢复依赖
comfy install --pr 1234                # 安装特定 PR
comfy install --version latest         # 最新稳定版
comfy install --version 0.2.0          # 特定版本

GPU 选项：--nvidia, --amd, --intel-arc, --m-series, --cpu

CUDA 版本 (NVIDIA)：--cuda 12.9, --cuda 12.6, --cuda 12.4, --cuda 12.1, --cuda 11.8

其他标志：--skip-manager, --skip-torch-or-directml, --skip-requirement, --fast-deps

启动

comfy launch                           # 前台模式
comfy launch --background              # 后台模式
comfy launch -- --listen 0.0.0.0       # 向 ComfyUI 传递参数
comfy stop                             # 停止后台实例
comfy launch --frontend-pr 1234        # 测试前端 PR

工作区选择

全局标志（互斥）：

comfy --workspace /path/to/ComfyUI ... # 显式指定路径
comfy --recent ...                     # 上次使用的实例
comfy --here ...                       # 当前目录
comfy which                            # 显示选中的实例
comfy set-default /path/to/ComfyUI     # 设置默认实例

自定义节点

comfy node show                        # 列出已安装节点
comfy node simple-show                 # 简洁列表
comfy node install <name>              # 从注册表安装
comfy node install <name> --fast-deps  # 快速安装依赖
comfy node reinstall <name>            # 重新安装节点
comfy node uninstall <name>            # 移除节点
comfy node update all                  # 更新所有节点
comfy node disable <name>              # 禁用节点
comfy node enable <name>               # 启用节点
comfy node fix <name>                  # 修复节点依赖

快照：

comfy node save-snapshot               # 保存当前状态
comfy node save-snapshot --output snapshot.json
comfy node restore-snapshot snapshot.json
comfy node restore-dependencies        # 从节点恢复依赖

调试：

comfy node bisect                      # 二分查找损坏的节点
comfy node deps-in-workflow workflow.json  # 从工作流提取依赖
comfy node install-deps --workflow workflow.json  # 安装工作流依赖

发布：

comfy node init                        # 初始化脚手架
comfy node scaffold                    # 通过 cookiecutter 创建项目
comfy node validate                    # 发布前验证
comfy node pack                        # 打包节点
comfy node publish                     # 发布到注册表

模型

comfy model list                       # 列出可用模型
comfy model download --url <url>       # 从 URL 下载
comfy model remove <name>              # 移除模型

来源：CivitAI、Hugging Face、直接 URL

访问受限模型的令牌：
- --civitai-token 或配置 civitai_api_token
- --hf-token 或配置 hf_api_token

运行工作流

comfy run --workflow workflow_api.json
comfy run --workflow workflow.json --wait --verbose
comfy run --workflow workflow.json --host 192.168.1.10 --port 8188

需要运行中的 ComfyUI 实例。

ComfyUI-Manager

comfy manager disable-gui              # 在 UI 中隐藏管理器
comfy manager enable-gui               # 在 UI 中显示管理器
comfy manager clear                    # 清除启动操作

更新

comfy update all                       # 更新 ComfyUI 和所有节点
comfy update comfy                     # 仅更新 ComfyUI

其他命令

comfy env                              # 显示配置和路径
comfy --version                        # 打印 CLI 版本
comfy pr-cache list                    # 列出缓存的 PR 构建
comfy pr-cache clean                   # 清理过期缓存
comfy standalone                       # 创建独立的 Python 包
comfy tracking enable|disable          # 管理分析功能
comfy feedback                         # 提交反馈

配置

配置文件位置：
- Linux: ~/.config/comfy-cli/config.ini
- macOS: ~/Library/Application Support/comfy-cli/config.ini
- Windows: %APPDATA%\Local\comfy-cli\config.ini

配置项：default_workspace, default_launch_extras, civitai_api_token, hf_api_token

使用技巧

• --skip-prompt 用于非交互模式（CI/脚本）
• 后台模式会跟踪 PID，便于执行 comfy stop 进行清理
• 快照功能可保留精确的节点版本，确保可复现性
• comfy node bisect 使用二分法查找导致环境损坏的节点
• PR 缓存可避免重复构建已测试过的前端 PR