核心用法
comfy-cli 是 ComfyUI 的官方命令行管理工具，提供从安装到运维的全生命周期管理能力。核心功能包括：
1. 环境部署：通过 comfy install 支持 NVIDIA/AMD/Intel/Apple Silicon/CPU 多平台一键安装，可指定 CUDA 版本和 ComfyUI 版本
2. 服务管理：comfy launch 启动服务（支持前后台模式），comfy stop 停止后台实例
3. 节点管理：完整的自定义节点生命周期管理，包括安装、更新、禁用、修复依赖，以及 bisect 二分排查故障节点
4. 模型管理：集成 CivitAI 和 HuggingFace 下载，支持 Token 认证的私有模型
5. 工作流执行：comfy run 直接运行 API 格式工作流，支持远程主机调用
6. 环境隔离：通过 --workspace、、--recent、、--here 实现多实例切换管理
显著优点
- 一站式管理：覆盖安装、启动、节点、模型、运行全流程，无需记忆多个工具
- 智能依赖处理：
--fast-deps加速安装，，restore-dependencies从工作流自动提取依赖 - 故障排查利器：
bisect命令通过二分法快速定位冲突节点，解决 ComfyUI 生态常见的节点兼容性问题 - 可复现环境：快照功能保存完整节点状态，便于团队协作和版本回滚
- 开发者友好：内置节点脚手架、验证和发布流程，降低自定义节点开发门槛
潜在缺点与局限性
- 外部依赖重：实际功能完全依赖独立安装的
comfy-cli二进制工具，本 Skill 仅为文档包装 - GPU 环境复杂：不同 GPU 厂商的安装参数差异大，新手易混淆 CUDA 版本选择
- 网络依赖：模型下载依赖 CivitAI/HuggingFace，国内用户可能需配置代理
- 无内置监控：缺乏资源占用监控、自动重启等生产级运维能力
- 工作流格式限制：
comfy run仅支持 API 格式 JSON，普通 UI 工作流需先转换
适合的目标群体
- AI 绘画创作者：需要快速搭建 Stable Diffusion 工作流环境
- ComfyUI 开发者：频繁安装调试自定义节点的插件开发者
- MLOps 工程师：需要批量部署、自动化运行 ComfyUI 工作流
- 技术型设计师：希望用代码管理 AI 绘画 pipeline 的专业用户
使用风险
- 第三方工具风险：
comfy-cli本身为社区工具，虽由 ComfyUI 生态维护，但更新频繁可能引入回归问题 - 模型来源安全：从 CivitAI 下载的模型文件需自行校验，存在恶意文件上传风险
- Token 泄露风险：配置的 API Token 以明文存储在本地配置文件
- 资源占用：ComfyUI 本身显存/内存消耗大，后台模式需关注系统资源
- 节点冲突：第三方节点生态庞杂，更新后可能出现依赖冲突需手动修复