bridge-skills/gs1-flux/SKILL.md

name, description, version, author, license, platforms, triggers

name	description	version	author	license	platforms	triggers
gs1-flux	调用 GS-1 (192.168.9.113) ComfyUI FLUX.1-dev 图像生成 — txt2img/img2img/填充。GGUF Q5_K_S 模型,V100 双卡。触发:FLUX 出图、高质量图片、复杂构图、产品图、图生图、局部重绘、inpaint。	1.0.0	9Webs	internal	linux	FLUX flux1 高质量出图 ComfyUI inpaint 局部重绘 图生图

GS-1 FLUX.1-dev 图像生成 (ComfyUI API)

用 GS-1 的 ComfyUI + FLUX.1-dev (GGUF Q5_K_S) 生成高质量图片。直连 192.168.9.113:8188 即可。

服务拓扑

项	值
节点	GS-1 = 192.168.9.113 (2× Tesla V100-SXM2-16GB)
ComfyUI	http://192.168.9.113:8188 (v0.25.0)
UNet	flux1-dev-Q5_K_S.gguf (GGUF, V100 无 bf16 用 Q5)
填充模型	flux1-fill-dev-Q5_K_S.gguf (inpaint/局部重绘)
CLIP	t5-v1_1-xxl-encoder-Q5_K_M.gguf + clip_l.safetensors (type=flux)
VAE	ae.safetensors

调用方式 (ComfyUI REST API)

1. POST /prompt 提交 API 格式工作流 (见 workflows/flux_txt2img.json),返回 prompt_id
2. 轮询 GET /history/{prompt_id} 直到 status.completed == true
3. 取图 GET /view?filename=<name>&type=output 下载 PNG

参考参数 (已实测)

• steps 20 (18-28 均可;GGUF 量化,步数低会糊)
• cfg 1.0 (FLUX 用 cfg≈1 + guidance;标准 KSampler 下 cfg 1.0 即可)
• 1024×1024 (FLUX 原生;V100 16GB 上限约 1024,超高会 OOM)
• sampler euler / scheduler simple, seed 可固定
• 耗时约 100-120 秒/张 (V100 无 flash-attention;首次调用含模型加载更慢)

脚本 (scripts/flux_txt2img.py)

python3 ~/.hermes/skills/gs1-flux/scripts/flux_txt2img.py "prompt here" [--steps 20] [--seed -1]
# 输出: /tmp/flux_out/flux_*.png

健康检查

curl -s http://192.168.9.113:8188/system_stats | head -c 200   # 返回 JSON = 正常
curl -s http://192.168.9.113:8188/object_info/UnetLoaderGGUF | grep -o 'flux1[^"]*'  # 模型在位
curl -s http://192.168.9.113:8188/queue | python3 -c "import json,sys; d=json.load(sys.stdin); print('running:', len(d['queue_running']), 'pending:', len(d['queue_pending']))"

排障

• 提交 400 → 工作流节点错误,读 node_errors 详情 (常见: CLIPTextEncodeFlux 需 clip_l/t5xxl/guidance 三个输入)
• 长时间不出图 → 查队列 queue 是否堆积;单实例顺序执行,批量任务排队
• OOM → 降到 768×768 或减少 batch
• 换风格/复杂提示 → FLUX 对提示词敏感,直接写详细英文描述;负向提示基本不需要

服务端排障

sshpass -p 'Tt123456!' ssh admin9webs@192.168.9.113 'systemctl --user status comfyui* --no-pager | head -20'

陷阱

1. Q5_K_S 量化:图片质量略低于 fp8/bf16,但 V100 无 bf16 只能跑 GGUF;复杂文字/人脸注意检查。
2. 每次约 2 分钟:批量任务要轮询串行,不要并发提交同实例。
3. 图片在 ComfyUI output 目录 (~/ComfyUI/output/),推荐客户端用 /view 下载,不依赖服务端目录。
4. Flux Fill (flux1-fill-dev) 用于局部重绘/inpaint,需配合 mask 工作流。

相关

• SDXL 出图用 gs2-sdxl 技能 (GS-2 :7861/:7862,快但质量略低)
• 配图策略: 快速草图用 SDXL,最终成品/复杂构图用 FLUX