核心用法
comfy-cli 是 ComfyUI 生态的官方命令行管理工具，旨在解决 AI 绘画工作流部署中的环境配置复杂、依赖冲突频繁、节点版本碎片化等痛点。核心功能覆盖完整生命周期：
安装部署：一键完成 ComfyUI 本体安装，自动识别 NVIDIA/AMD/Intel Arc/Apple Silicon 等硬件平台，支持 CUDA 版本精准指定与特定 PR/版本锁定。--restore 模式可为现有安装修复依赖。
节点管理：围绕 Custom Nodes 提供完整工具链——从 install/uninstall/update 基础操作，到 save-snapshot/restore-snapshot 实现环境快照与回滚，bisect 二分查找故障节点解决冲突，deps-in-workflow 从工作流反向提取依赖。内置脚手架支持节点开发、验证与 Registry 发布。
模型管理：打通 CivitAI 与 Hugging Face 双平台，支持 Token 鉴权下载 gated 模型，统一管理模型目录。
工作流执行：通过 comfy run 直接调用 API 工作流 JSON，支持远程主机与等待/日志选项，便于 CI/CD 集成。
显著优点
- 硬件适配全面：覆盖主流 GPU 与 CPU 方案，CUDA 版本细粒度控制
- 故障排查专业：
bisect与快照机制显著降低节点冲突诊断成本 - 生态整合深度：原生对接 ComfyUI-Manager、CivitAI、Hugging Face
- 开发友好：节点发布全流程支持，降低社区贡献门槛
潜在局限
- 依赖 Python/uv 环境，Windows 用户可能需额外配置
- 部分高级功能（如
--fast-deps）依赖实验性解析器，稳定性待验证 - Registry 节点质量参差不齐，
comfy node install不保证节点可用性
适合人群
ComfyUI 重度用户、AI 绘画工作流开发者、需要批量部署或版本锁定的团队/实验室。
常规风险
- 执行
update all或快照恢复时可能引入破坏性变更，建议配合版本控制 - 模型下载涉及第三方平台 Token，需妥善保管 API Key
- 背景模式 (
--background) 需手动comfy stop，存在僵尸进程风险