核心用法
ComfyUI Runner 是一个本地化图像生成工具，核心功能包括：
1. 工作流执行：通过 comfyui_run.py 脚本将 API 格式的 JSON 工作流提交至本地 ComfyUI 服务器（默认 127.0.0.1:8188），轮询直至完成并返回输出图像路径。
2. 动态工作流编辑：运行前需智能解析工作流 JSON，识别并修改关键节点：
- 提示词节点：查找
CLIPTextEncode、PrimitiveStringMultiline或标题含 "Prompt"/"positive" 的节点，注入用户描述的主体、风格、光照、质量等参数 - 风格节点：识别
StringConcatenate等拼接节点，处理风格前缀 - 随机种子：定位
KSampler、BasicGuider等采样器节点，设置随机种子确保生成多样性
3. 模型权重管理：download_weights.py 支持从 URL 批量下载模型文件，自动推断子目录（checkpoints/loras/vae 等），使用 pget 并行加速，支持 --overwrite 强制覆盖。
4. 服务器生命周期管理：检测安装状态，支持从源码克隆、venv 环境搭建到服务启动的全流程自动化。
显著优点
- 完全本地化：数据不出本机，隐私安全性高
- 工作流透明化：直接操作 JSON 节点，无黑箱封装，高级用户可精细控制每个生成参数
- 模型生态兼容：标准 ComfyUI 目录结构，支持 CivitAI、HuggingFace 等来源的任意模型
- 灵活的输入处理：支持文件路径、原始 JSON、URL 列表等多种输入形式
潜在缺点与局限性
- 环境依赖重：需 Python 3、venv、PyTorch 及 CUDA/ROCm 等深度学习运行时，首次部署门槛高
- 硬件要求苛刻：Stable Diffusion XL 级别模型需 8GB+ VRAM，复杂工作流可能耗尽资源
- 节点识别不确定性：工作流结构由用户定义，自动识别 prompt/sampler 节点存在误判风险
- 无内置审查：生成内容不受过滤，可能产出 NSFW 或版权敏感图像
- 单实例限制：脚本绑定 127.0.0.1:8188，不支持多服务器负载均衡
适合人群
- 具备 Linux/macOS 命令行经验的技术用户
- 需要隐私敏感图像生成（医疗、法律、商业机密场景）
- 已拥有 RTX 3060 12GB 或更高级别显卡的工作站用户
- 愿意投入时间学习 ComfyUI 节点式工作流的设计师与开发者
常规风险
| 风险类别 | 具体描述 | 缓解措施 |
|---------|---------|---------|
| 模型安全 | 下载的 `.safetensors` 可能携带恶意 pickle 载荷 | 优先使用官方来源，启用 `--no-pget` 时校验文件哈希 |
| 生成合规 | 本地运行无内容过滤，可能生成违规图像 | 用户需自行承担内容责任，建议商业场景叠加外部审核 |
| 资源耗尽 | 大分辨率生成导致 OOM 或系统冻结 | 工作流中预设保守的 latent 尺寸，监控显存使用 |
| 路径遍历 | 脚本处理用户提供的文件路径 | 确保 `--base` 参数限定在用户主目录内，不跟随符号链接 |