# Guía Operativa: Extracción de Prompts e Ideas desde Imágenes de Artistas y Waifusoreo

Este documento detalla el procedimiento y las herramientas disponibles en el ecosistema PlumLoom para analizar ilustraciones externas (procedentes de artistas, redes sociales o archivos de waifusoreo), extraer sus metadatos o etiquetas de Danbooru, y reutilizarlas en nuestros generadores de prompts y packs.

---

## 1. Objetivos
- Descubrir los tags exactos que componen una ilustración de referencia (estilo, iluminación, vestuario, anatomía, posturas).
- Alimentar nuestras bibliotecas de poses, escenas y ropa con referencias del mundo real.
- Automatizar la conversión de imágenes crudas en listas de prompts limpios compatibles con el checkpoint Illustrious y Stable Diffusion Forge Neo.

---

## 2. Métodos de Extracción Disponibles

### Método A: Extracción Local por IA (WD14 Tagger — *Recomendado y Automatizado*)
Nuestro motor incorpora el tagger basado en modelos ONNX optimizados para Danbooru (`SmilingWolf/wd-swinv2-tagger-v3`), capaz de leer cualquier imagen y devolver los tags con sus niveles de confianza.

1. **Ubicación de entrada:** Coloca las imágenes de referencia en la carpeta `Archivos/wd14/inbox/` (soporta subcarpetas como `SFW/` o `NSFW/`).
2. **Ejecución del motor:**
   ```bash
   python Engine/wd14_tagger.py
   ```
   *(Opcional: `--threshold 0.35` para mayor sensibilidad de tags o `--model eva02` para mayor precisión).*
3. **Resultado:** El script genera automáticamente los ficheros `.txt` con los tags ordenados por confianza en `Archivos/wd14/tags/`.
4. **Cosecha y Limpieza:** Para transformar esos tags brutos en wildcards o líneas de biblioteca limpiando la identidad del personaje y la basura, se procesan mediante:
   ```bash
   python Engine/wd14_harvest.py
   ```

### Método B: Búsqueda Inversa en Repositorios (SauceNAO / IQDB / Findit.moe)
Si la ilustración procede de un artista publicado en Pixiv, Twitter o plataformas de arte:
1. Sube la imagen a **SauceNAO** (`saucenao.com`) o **Findit.moe** (`findit.moe`).
2. Localiza el post original indexado en **Danbooru** o Gelbooru.
3. Copia los tags oficiales aprobados por la comunidad (personaje, copyright, artista, vestuario, meta) y utilízalos para enriquecer nuestro diccionario local o la base de datos de hashtags.

---

## 3. Flujo de Trabajo Integrado en PlumLoom

```
[ Imagen externa / Waifusoreo ] 
       │
       ├──► (A) WD14 Tagger (Local) ──► Archivos/wd14/tags/ ──► wd14_harvest.py ──► Bibliotecas / Wildcards
       │
       └──► (B) Búsqueda Inversa (SauceNAO / Danbooru) ──► Tags Oficiales ──► PromptBuilder / character_hashtags_db.json
```