Comfy‑CLI – ComfyUI 生成媒体引擎的命令行助手

它是什么 – comfy‑cli 是一个基于 Python 的命令行界面，自动化了 ComfyUI 的整个生命周期，ComfyUI 是一个开源的视觉生成平台（文本到图像、视频等）。它允许你安装 ComfyUI、拉取自定义节点和模型文件、启动服务器、运行工作流，甚至将工作卸载到托管的 Comfy Cloud – 所有这些都可以从终端或脚本/代理中完成。

---

核心功能（根据 README 描述）

领域	CLI 的功能
安装	comfy install 下载最新的 ComfyUI 和可选的 ComfyUI‑Manager，设置虚拟环境，解析依赖（使用 uv 快速模式），并可以安装特定版本、PR，或跳过管理器。
更新	comfy update 刷新核心仓库、自定义节点或 CLI 本身。支持版本固定、自动暂存本地更改，以及用于 CI 可靠性的 --exit‑on‑fail 标志。
节点管理	`comfy node install
工作流执行	comfy run --workflow <file> 将 JSON 工作流发送到本地 ComfyUI 服务器（自动转换 UI 格式的 JSON）或 Comfy Cloud（--where cloud）。支持异步提交（prompt_id）、等待和下载结果。
生成快捷方式	comfy generate 直接调用合作伙伴图像/视频模型（Flux、DALL·E、Gemini 等），无需编写 JSON 工作流。
云集成	comfy cloud … 下的命令处理登录、信用/状态检查和作业管理（jobs wait、download）。
启动	comfy launch 在本地启动 UI，支持后台模式、额外的启动参数，或针对前端特定 PR。
代理友好性	每个命令都可以输出结构化的 --json 信封，使基于 LLM 的代理（Claude、Cursor 等）能够轻松解析输出并以编程方式驱动工具。
跨平台	适用于 Windows、macOS 和 Linux；可以使用系统 Python、虚拟环境或隔离的 pipx/uv 环境。
额外功能	Shell 自动补全、环境检查（comfy env）、VRAM/RAM 统计、模型释放，以及一组内置的“技能”，教代理如何使用 CLI。

---

谁可能使用它？

用户	为什么有帮助
开发者 / CI 管道	一键安装（comfy setup）、确定性更新和 JSON 友好的输出使自动化变得简单。
艺术家和爱好者	快速启动本地 ComfyUI 实例或在云端运行提示，无需折腾 Docker 或手动下载模型。
LLM 驱动的代理	结构化的 --json 响应和 comfy generate 快捷方式让 AI 助手直接从脚本调用图像模型。
研究人员	统一的依赖解析器（uv/--uv‑compile）加速安装许多通常有冲突 Python 包的自定义节点。

---

它如何融入 AI 生态系统

• ComfyUI 是一个基于节点的视觉生成框架，在本地运行扩散模型。comfy‑cli 是使安装、扩展和调用该框架变得轻松的粘合剂。
• 通过暴露云执行，该工具弥合了本地 GPU 密集型工作流和服务器端推理之间的差距（对没有 GPU 的用户有用）。
• CLI 的 JSON 模式和内置“技能”明确设计用于代理驱动的工作流，这是一种日益增长的模式，LLM 编排工具。

---

快速入门回顾（来自 README）

pip install comfy-cli          # 安装工具
comfy setup                    # 交互式向导（或 `comfy setup -y` 用于 CI）
comfy launch                   # 在本地启动 UI
comfy generate "a cat in space"   # 一行调用合作伙伴模型
comfy run --workflow my.json --where cloud   # 提交到 Comfy Cloud

---

底线 – comfy‑cli 是 ComfyUI 生成媒体栈的真正生产级 CLI，涵盖安装、节点管理、工作流执行和云卸载，特别关注自动化和 LLM 代理集成。