SuperAPI AI 工具集

comfyui-operator

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:comfyui-operator 用于操作本地 ComfyUI 实例,实现服务启动、资源查询与图像生成。

主要能力:保证 ComfyUI 正在运行;查询安装中可用的工作流、LoRA 与 Checkpoint;通过 API 工作流配合动态 JSON 覆盖来排队提示词,并下载生成的图像。

使用方式:脚本依赖 requests 与 websocket-client,可用 pip install -r requirements.txt 安装。默认假定 ComfyUI 安装在 C:\ComfyUI_windows_portable,若该目录不存在需先向用户确认正确路径。三个脚本:start_comfyui.py 确保服务运行并可访问 API,用法 python scripts/start_comfyui.py [--comfyui_path "path/to/comfyui"];list_resources.py 列出模型与 API 格式工作流,用法 python scripts/list_resources.py [--comfyui_path "path/to/comfyui"] [--output "resources.json"];generate_image.py 加载基础 JSON 工作流、经 WebSocket API 覆盖节点并保存图像,用法 python scripts/generate_image.py --workflow_path "path/to/base_api_workflow.json" [--output_dir "path/to/save/images"] [--overrides_file "path/to/overrides.json"] --overrides '{"3": {"inputs": {"seed": 12345}}, "6": {"inputs": {"text": "A beautiful sunset..."}}}' [--comfyui_path "path/to/comfyui"] [--server "127.0.0.1:8188"]。

交互规则:用户请求模糊时不要猜测工作流,先运行 list_resources.py 列出可用工作流并让用户选择;生成文件时必须用 --output 与 --output_dir 显式指定用户工作区目录,list_resources.py 默认保存到 <active_workspace>/.comfyui/resources.json,generate_image.py 默认保存到 <active_workspace>/.comfyui/outputs/。用户指定具体主题时,先列出工作流再做模糊匹配,兼容拼写变体。

覆盖说明:--overrides 的键为工作流节点 ID。KSampler 通常为 "3",改种子用 {"3": {"inputs": {"seed": <random_number>}}};CLIP Text Encode 通常为 "6",改提示词用 {"6": {"inputs": {"text": "<your_prompt>"}}}。默认不要改动基础工作流的种子,仅在用户明确要求新种子或批量生成同一提示词时注入随机种子。覆盖文本提示词时不要盲目整体替换,应先读取原工作流 JSON 并追加关键词,因为工作流常含角色名、风格与质量等基线标签;若需大幅偏离基础提示词,应先征得用户确认。Windows 终端传 JSON 易有引号转义问题,建议将复杂覆盖写入临时 JSON 文件并用 --overrides_file 传入。脚本会自动检测服务运行在 8188 还是 8000 端口,默认输出目录为当前工作目录。

限制:资料未提供收费、价格、平台支持范围与生成效果等信息。