Spaces:
Paused
Paused
File size: 4,087 Bytes
37d841f ec62aa2 37d841f ec62aa2 37d841f ec62aa2 37d841f ec62aa2 37d841f ec62aa2 98abdf7 ec62aa2 98abdf7 ec62aa2 37d841f ec62aa2 37d841f ec62aa2 37d841f ec62aa2 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 | """Validación de salida del LLM + plantillas deterministas (estilo chess.com).
Plantillas BREVE para jugadas rutinarias (Excelente/Buena): siempre deterministas,
no se llama al LLM. Plantillas FALLBACK para Brillante/Imprecisión/Error: se usan
si la salida del LLM falla la validación.
El entrenador SOLO comenta el patrón estratégico: no menciona números ni
recomienda jugadas (eso lo muestra Stockfish por separado en la UI).
"""
import re
# Comentarios breves deterministas: jugadas que no requieren LLM.
_BRIEF = {
"Excelente": "{move} es la mejor jugada en esta posición.",
"Buena": "{move} es sólida y mantiene el equilibrio.",
}
# Fallback para categorías que sí piden LLM (si la generación falla validación).
# Sin recomendación de jugada: la mejor jugada la muestra Stockfish en la UI.
_FALLBACK = {
"Brillante": "{move} es un hallazgo táctico que gana ventaja. ¡Muy bien encontrado!",
"Imprecisión": "{move} cede algo de ventaja posicional.",
"Error": "{move} entrega ventaja y debilita tu posición.",
}
def brief(move: dict, clasificacion: str) -> str:
"""Comentario corto determinista para jugadas no-interesantes (Excelente/Buena)."""
tmpl = _BRIEF.get(clasificacion, "Jugada procesada.")
return tmpl.format(move=move.get("move", ""))
_PREFIX_RE = re.compile(
r'^(?:Contexto[^\n]*\n?\s*)?' # línea de contexto si el modelo la repite
r'(?:Tendencia[^\n]*\n?\s*)?' # línea de tendencia si la repite
r'Jugada\s+(?:actual|\d+)\s*[(,][^\n)]*\)?\s*:?\s*\S+[.,]?\s*'
r'(?:Clasificaci[oó]n\s*:\s*\w+[.,]?\s*)?'
r'(?:Evaluaci[oó]n[^.]+\.\s*)?'
r'(?:Mejor jugada\s*:\s*\S+[.,]?\s*)?',
re.IGNORECASE,
)
# Por si el modelo solo repite la línea de contexto/tendencia, sin el resto.
_CONTEXT_RE = re.compile(r'^(?:Contexto|Tendencia)[^\n]*\n?\s*', re.IGNORECASE)
# Evaluaciones numéricas que el modelo pueda filtrar: "-1.2", "+0.3", "M3", "+M".
_EVAL_RE = re.compile(r'[+-]?\d+\.\d+|[+-]?M\d*|[+-]\d+')
# Muletillas que el modelo a veces antepone.
_FILLER_RE = re.compile(
r'\b(?:teniendo en cuenta|considerando|a pesar de(?:l)?|dado que)\b[^,.]*[,.]?\s*',
re.IGNORECASE,
)
# Caracteres CJK (chino/japonés/coreano y fullwidth). El base de Qwen a veces
# deriva a chino en generaciones largas; este filtro garantiza que eso NUNCA
# llegue al usuario aunque ocurra.
_CJK_RE = re.compile('[ -鿿-]')
def strip_cjk(text: str) -> str:
"""Si aparece un carácter CJK, corta el texto ahí y lo recorta a la última
oración completa (para no dejar una frase a medias)."""
m = _CJK_RE.search(text or "")
if not m:
return text
cortado = text[:m.start()]
fin = max(cortado.rfind('.'), cortado.rfind('!'), cortado.rfind('?'))
return (cortado[:fin + 1] if fin != -1 else cortado).strip()
def _limpiar(text: str) -> str:
"""Borra evaluaciones numéricas y muletillas que se hayan filtrado."""
text = strip_cjk(text)
text = _EVAL_RE.sub('', text)
text = _FILLER_RE.sub('', text)
# Limpia puntuación huérfana y espacios dobles que deja el borrado.
text = re.sub(r'\(\s*\)', '', text) # paréntesis vacíos
text = re.sub(r'\s+([,.;:!?])', r'\1', text) # espacio antes de puntuación
text = re.sub(r'[,;:]\s*(?=[.])', '', text) # coma pegada a punto
text = re.sub(r'\s{2,}', ' ', text)
text = text.strip(' ,;:.-').strip()
if text and not text.endswith(('.', '!', '?')):
text += '.'
return text
def validate(text: str, move: dict, clasificacion: str) -> str:
"""Valida la salida del LLM. Elimina prefijo de metadatos y números filtrados."""
text = (text or "").strip()
text = _PREFIX_RE.sub('', text).strip()
text = _CONTEXT_RE.sub('', text).strip()
text = _limpiar(text)
if len(text) < 15:
return _make_fallback(move, clasificacion)
return text
def _make_fallback(move: dict, clasificacion: str) -> str:
tmpl = _FALLBACK.get(clasificacion, "Jugada procesada.")
return tmpl.format(move=move.get("move", ""))
|