前言¶
在本地跑 ComfyUI 出圖時，常見的兩類問題是：一是你想讓 Agent 幫忙提交一個工作流、輪詢結果，但它並不認識 ComfyUI 的 HTTP API，得你自己複製 prompt ID 去查 history；二是你在局域網另一臺機器上裝了 ComfyUI，手動連一下還行，讓 Agent 自動生成圖片就斷了，因爲它不知道服務在哪、也不知道怎麼連。
下面介紹的 ComfyUI Control，就是用來解決「Agent 與 ComfyUI 之間的連接和控制」這件事的。
這是什麼¶
ComfyUI Control 是一個社區維護的 Skill，座標 @user_86d3f55f/comfyui-control，發佈者 user_86d3f55f，分類 ai-agent，當前版本 1.0.1，來源 community，標籤 requires_api_key=false（即不需要 API key）。
它做的事一句話概括：連接並控制本機或局域網內的 ComfyUI，通過 ComfyUI HTTP API 提交任務、查看狀態、出圖。適用場景是用戶想控制 localhost 或其他機器上的 ComfyUI、測試 ComfyUI URL、診斷連接失敗、檢查模型或節點、上傳輸入圖片、校驗 workflow JSON、提交 prompt、輪詢 history，或自動化圖像生成。
核心功能¶
根據資料，已覈實的能力包括：
- 連接與檢測：連接本機或局域網內的 ComfyUI，支持檢測連接是否可用、診斷連接失敗，也能用來測試 ComfyUI URL。
- 資源查看：查看當前 ComfyUI 加載了哪些模型和節點。
- 圖片上傳：上傳輸入圖片作爲圖生圖等流程的輸入。
- 工作流校驗：校驗 workflow JSON 是否有效。
- 預設工作流：生成 FLUX 文生圖、圖生圖、放大等工作流。
- 任務提交與出圖：通過 ComfyUI HTTP API 提交任務並出圖，支持輪詢 history 獲取結果。
- 無需 API key：
requires_api_key=false，不需要額外申請密鑰。
這些能力都圍繞 ComfyUI HTTP API 展開，本質是把「手動點 ComfyUI 界面」的操作，轉換成 Agent 能執行的 API 調用。
安裝與啓用¶
關於安裝方式：資料中未給出具體的安裝命令或目錄路徑，因此本節不展開安裝步驟。這類基於 SKILL.md 格式的 Skill，一般通過 SkillHub 平臺獲取後啓用，但具體命令需以官方頁面爲準。
啓用後，Agent 需要知道 ComfyUI 服務的地址。如果是本機，通常是 http://localhost:8188；如果是局域網另一臺機器，地址由你環境的部署決定。Skill 本身不固定地址，需要你在使用時指定。
典型用法¶
資料中未提供逐條可復現的命令示例，下面給出基於其能力的使用思路，命令細節以 ComfyUI HTTP API 官方文檔爲準。
- 先確認服務可達：在能訪問 ComfyUI 的機器上測試 URL，確認端口和服務正常，這一步用於排除「地址不對或服務沒起」的問題。
- 檢查模型與節點：服務連上後查看可用的模型和節點，確認目標工作流需要的模型已加載。
- 準備輸入：如果是圖生圖，先上傳輸入圖片；如果只是文生圖，可跳過。
- 生成或校驗工作流：用預設的 FLUX 文生圖 / 圖生圖 / 放大工作流，或直接傳入你自己的 workflow JSON 並校驗。
- 提交任務：通過 ComfyUI HTTP API 的
/prompt接口提交工作流，拿到 prompt ID。 - 輪詢結果：用 prompt ID 輪詢 history，等待生成完成後取回圖片。
上面每一步對應的是 ComfyUI 標準 HTTP 接口，Skill 的作用是讓 Agent 能按這套流程自動跑通，而不用你手動操作界面。
適用場景與注意¶
適合的人：已經在本地或局域網部署 ComfyUI、希望讓 Agent 自動提交工作流出圖的開發者；需要批量生成、自動化圖像生成流程的人；遇到連接問題需要定位是地址還是服務問題的場景。
需要注意的點：
- 服務地址要可達：本機用
localhost:8188，跨機器要用局域網地址，Agent 所在機器必須能訪問到該地址，否則連接會失敗。 - 不內置地址：Skill 不固定 ComfyUI 地址，地址由使用環境決定，跨機使用時要確認網絡和端口放通。
- 工作流兼容性：預設工作流針對 FLUX，如果你用的是其它模型或自定義工作流，需自行校驗 workflow JSON，節點缺失會導致提交失敗。
- 安裝命令未在資料中給出：本節的安裝步驟未能從官方資料覈實，啓用前請以官方頁面爲準。
結尾¶
ComfyUI Control 的價值在於：把 ComfyUI 的連接、資源查看、任務提交和輪詢這套流程封裝成 Agent 可調用的能力，讓「讓 Agent 自動出圖」這件事少一些手工操作。它不負責模型訓練或工作流設計，只負責把已有的 ComfyUI 服務接起來、跑起來。
官方地址：https://api.skillhub.cn/user_86d3f55f/comfyui-control
