cli-anything-comfyui 是做什麼的？
透過 ComfyUI REST API 進行 AI 圖像生成工作流程管理。專為 AI 代理和進階使用者設計，無需圖形介面即可排隊工作流程、管理模型、下載生成圖像及監控生成佇列。
安裝
此 CLI 作為 cli-anything-comfyui 套件的一部分安裝：
pip install cli-anything-comfyui
前置需求：
- Python 3.10+
- ComfyUI 必須已安裝並在 http://localhost:8188 執行中
使用方式
基本指令
# 顯示說明
cli-anything-comfyui --help
# 啟動互動式 REPL 模式
cli-anything-comfyui repl
# 檢查伺服器狀態
cli-anything-comfyui system stats
# 以 JSON 輸出執行（供代理使用）
cli-anything-comfyui --json system stats
REPL 模式
啟動互動式工作階段以進行探索性使用：
cli-anything-comfyui repl
# 以標籤補全和歷史記錄互動輸入指令
指令群組
工作流程 (Workflow)
工作流程管理指令。
| 指令 | 說明 |
|---|---|
list | 列出已儲存的工作流程 |
load | 從 JSON 檔案載入工作流程 |
validate | 根據 ComfyUI 節點圖驗證工作流程 JSON |
佇列 (Queue)
生成佇列管理。
| 指令 | 說明 |
|---|---|
prompt | 排程工作流程以執行 |
status | 顯示目前佇列狀態（執行中與待處理） |
clear | 清除生成佇列 |
history | 顯示提示執行歷史 |
interrupt | 中斷目前正在執行的生成 |
模型 (Models)
模型探索指令。
| 指令 | 說明 |
|---|---|
checkpoints | 列出可用的檢查點模型 |
loras | 列出可用的 LoRA 模型 |
vaes | 列出可用的 VAE 模型 |
controlnets | 列出可用的 ControlNet 模型 |
node-info | 顯示特定節點類型的詳細資訊 |
list-nodes | 列出所有可用的節點類型 |
圖像 (Images)
生成的圖像管理。
| 指令 | 說明 |
|---|---|
list | 列出伺服器上生成的圖像 |
download | 下載特定生成的圖像 |
download-all | 從一個提示執行中下載所有圖像 |
系統 (System)
伺服器狀態與資訊。
| 指令 | 說明 |
|---|---|
stats | 顯示 ComfyUI 系統統計資料（GPU、CPU、記憶體） |
info | 顯示 ComfyUI 伺服器資訊與擴充功能 |
範例
檢查系統狀態
# 伺服器統計資料
cli-anything-comfyui system stats
# 伺服器資訊
cli-anything-comfyui system info
探索可用模型
# 列出檢查點
cli-anything-comfyui models checkpoints
# 列出 LoRA
cli-anything-comfyui models loras
# 列出所有節點類型
cli-anything-comfyui models list-nodes
排程並監控生成
# 排程工作流程
cli-anything-comfyui queue prompt --workflow my_workflow.json
# 檢查佇列狀態
cli-anything-comfyui queue status
# 檢視執行歷史
cli-anything-comfyui --json queue history
下載生成的圖像
# 列出生成的圖像
cli-anything-comfyui images list
# 下載特定圖像
cli-anything-comfyui images download --filename ComfyUI_00001_.png --output ./out.png
# 從一個提示中下載所有圖像
cli-anything-comfyui images download-all --prompt-id <id> --output-dir ./outputs
輸出格式
所有指令都支援雙重輸出模式：
- 人類可讀（預設）：表格、色彩、格式化文字
- 機器可讀（
--json標記）：結構化 JSON，供代理使用
# 人類輸出
cli-anything-comfyui system stats
# 供代理使用的 JSON 輸出
cli-anything-comfyui --json system stats
給 AI 代理的建議
程式化使用此 CLI 時：
- 一律使用
--json標記 以獲得可解析的輸出 - 檢查回傳碼 - 0 表示成功，非零表示錯誤
- 解析標準錯誤輸出 (stderr) 以取得失敗時的錯誤訊息
- 使用絕對路徑 進行所有檔案操作
- 在其他指令前先使用
system stats驗證 ComfyUI 是否在執行
更多資訊
- 完整文件：請參閱套件中的 README.md
- 測試覆蓋率：請參閱套件中的 TEST.md
- 方法論：請參閱 cli-anything-plugin 中的 HARNESS.md
版本
1.0.0