docs(tools): record RD style-LoRA trigger-word map for reproducible ideation prompts

2026-08-14 21:31:42 -07:00
parent 1bf5b9d11e
commit d7f4276881
1 changed files with 73 additions and 0 deletions
@@ -0,0 +1,73 @@
+# Retro Diffusion style LoRAs — trigger-word reference
+
+Local record of the RD style-LoRA trigger words, for reproducible ComfyUI
+ideation prompts without round-tripping to comfy-dev. Canonical source is
+`catalog/loras.yaml` on the ComfyUI box (irv-ml1); this is m03-dev's working
+copy (from comfy-dev, thread 01M01PKJ5EAR…, 2026-08-15).
+
+**Licensing (operator directive):** these weights are copyrighted,
+licensed-for-use, **not-for-export** — fleet-internal only, no
+redistribution / publish / serve. Ideation OUTPUT stays `_ph` placeholder
+per the game asset policy. This file records trigger STRINGS (not weights),
+but treat the whole capability as internal.
+
+**How triggers work:** prepend the trigger token to the prompt to activate
+the LoRA's trained style. Coverage = share of the LoRA's training captions
+that led with that token (higher = more reliable). Derived from each LoRA's
+kohya `ss_tag_frequency`.
+
+## Reliable (coverage ≥ 85%)
+
+| ComfyUI `lora_name` | trigger | coverage |
+|---|---|---|
+| `rd/1bit.safetensors` | `pixel1biticons` | 100% |
+| `rd/flatshading.safetensors` | `pixelflat64` | 100% |
+| `rd/frontfacing.safetensors` | `pixelfurniture64` | 100% |
+| `rd/gameboy.safetensors` | `gameboy64` | 100% |
+| `rd/gameboyadvance.safetensors` | `gba64` | 100% |
+| `rd/gamecharacters.safetensors` | `duelystchar` | 100% |
+| `rd/gameicons.safetensors` | `pixelicons64` | 100% |
+| `rd/isometric.safetensors` | `isometric` | 100% |
+| `rd/modern.safetensors` | `svportrait64` | 85% |
+| `rd/neogeo.safetensors` | `neogeo64` | 100% |
+| `rd/nes.safetensors` | `nes64` | 94% |
+| `rd/playstation.safetensors` | `psone` | 100% |
+| `rd/snes.safetensors` | `snes64` | 87% |
+| `rd/tiling.safetensors` | `pixelmcblocks64` | 100% |
+| `rd/tiling16.safetensors` | `pixelmcblocks64` | 99% |
+| `rd/tiling32.safetensors` | `pixelmcblocks64` | 100% |
+| `rd/topdown.safetensors` | `pixelbuildings64` | 94% |
+
+## Weak-but-distinctive (verify on first use)
+
+| ComfyUI `lora_name` | trigger | coverage |
+|---|---|---|
+| `rd/simplegeometric.safetensors` | `pixelflatoutlined` | 38% (coined token, likely real) |
+
+## No trigger — style-from-weights, just load
+
+- `rd/gamecharactersanime.safetensors`
+- `rd/gamecharactersretro.safetensors`
+- `rd/industrial.safetensors`
+- `rd/nashorkimitems.safetensors`
+- `rd/segagenesis.safetensors`
+- `rd/uipanel.safetensors`
+
+(24 total: 17 reliable + 1 weak + 6 untriggered.)
+
+## Gotchas
+
+- **All three `tiling*` LoRAs share `pixelmcblocks64`** — the token does NOT
+  encode tile size (the weights do). Do NOT substitute `pixelmcblocks16/32`.
+- **`isometric` / `psone` triggers disagree with their vendor stems**
+  (`isopixel64-v2`, `psone64-v1`). Caption token recorded here leads 100%;
+  if either underperforms, try the stem form as a fallback.
+
+## For the U R M03 first batch
+
+Likely-relevant: `duelystchar` (gamecharacters) and `gamecharactersretro` /
+`gamecharactersanime` (no trigger) for M03/grunt/burster sprites;
+`frontfacing` (`pixelfurniture64` — note: furniture-trained, verify on a
+character) and `topdown` (`pixelbuildings64`) for camera; console-palette
+LoRAs (`nes64`, `gameboy64`, …) for the hi-bit palette exploration.
+Render at 512, downscale to 32/48px targets (model resolution floor).