Bridge 图像生成技能: gs2-sdxl (GS-2 SDXL) + gs1-flux (GS-1 FLUX)

gs1-flux/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: gs1-flux
+description: 调用 GS-1 (192.168.9.113) ComfyUI FLUX.1-dev 图像生成 — txt2img/img2img/填充。GGUF Q5_K_S 模型,V100 双卡。触发:FLUX 出图、高质量图片、复杂构图、产品图、图生图、局部重绘、inpaint。
+version: 1.0.0
+author: 9Webs
+license: internal
+platforms: [linux]
+triggers:
+  - 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)
+
+```bash
+python3 ~/.hermes/skills/gs1-flux/scripts/flux_txt2img.py "prompt here" [--steps 20] [--seed -1]
+# 输出: /tmp/flux_out/flux_*.png
+```
+
+## 健康检查
+
+```bash
+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 对提示词敏感,直接写详细英文描述;负向提示基本不需要
+
+## 服务端排障
+
+```bash
+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