Spaces:
Paused
Paused
File size: 6,092 Bytes
8ccac0b 732a0d4 8ccac0b 37d841f 98abdf7 37d841f 8ccac0b 37d841f ec62aa2 8ccac0b 37d841f 732a0d4 37d841f 8ccac0b ec62aa2 732a0d4 8ccac0b 37d841f ec62aa2 98abdf7 ec62aa2 732a0d4 ec62aa2 732a0d4 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 103 104 105 106 107 108 109 110 111 112 113 114 115 | from modules.analysis.classifier import classify
from modules.transcription.validator import translate_move_en_es
# El entrenador SOLO comenta el patrón estratégico. La mejor jugada y la
# evaluación numérica las muestra Stockfish por separado en la UI, así que el
# modelo NO debe mencionarlas (de hecho no se las pasamos en el prompt).
SYSTEM = (
"Eres un entrenador de ajedrez serio y didáctico, con un registro claro y "
"profesional, como un buen profesor. Comentas las jugadas de tu alumno "
"hablándole de 'tú' en una o dos oraciones precisas, explicando con rigor "
"pero en lenguaje accesible la idea estratégica detrás de la jugada (control "
"del centro, seguridad del rey, actividad de las piezas, iniciativa, "
"estructura de peones). Mantén un tono sobrio y respetuoso: SIN exclamaciones "
"efusivas, SIN emojis y SIN jerga ni coloquialismos. La prioridad es que la "
"explicación sea correcta, concisa y fácil de entender. "
"Reglas estrictas: responde SIEMPRE en español (nunca en otro idioma); NO "
"menciones números ni evaluaciones; NO recomiendes ninguna jugada "
"alternativa; nada de muletillas. Lo esencial es la idea estratégica "
"expresada con claridad."
)
# Clasificaciones que cuentan como "mala jugada" para detectar tendencia.
_MALAS = {"Imprecisión", "Error"}
_BUENAS = {"Brillante", "Excelente", "Buena"}
def _tendencia(history: list, max_n: int = 4) -> str:
"""Resume la tendencia reciente en lenguaje natural (sin tokens de jugadas).
En vez de pasar el historial crudo (que el modelo copiaba textual), le
damos una señal de alto nivel: si viene fallando o jugando bien. Así el
comentario considera la tendencia sin filtrar nombres de jugadas.
"""
recientes = [classify(h.get("diferencia_cp", 0)) for h in history[-max_n:]]
if not recientes:
return "Tendencia: es de las primeras jugadas, aún no hay patrón."
malas = sum(1 for c in recientes if c in _MALAS)
if malas >= 2:
return "Tendencia: el jugador viene cometiendo varias imprecisiones seguidas."
if malas == 0 and all(c in _BUENAS for c in recientes):
return "Tendencia: el jugador venía jugando con precisión."
return "Tendencia: el juego venía equilibrado, sin un patrón marcado."
def _fase(numero: int) -> str:
"""Fase aproximada de la partida según el número de jugada. Señal simple y
CONSISTENTE entre entrenamiento e inferencia, para que el modelo no hable de
'el final' en pleno medio juego (bug observado en la v1)."""
if numero <= 10:
return "apertura"
if numero <= 25:
return "medio juego"
return "final"
def build(move: dict, clasificacion: str, history: list | None = None) -> str:
color_str = "Blancas" if move["color"] == "white" else "Negras"
# La jugada llega en SAN inglés (board.san); el modelo debe verla en español
# para no mezclar idiomas en su respuesta.
jugada_es = translate_move_en_es(move["move"])
return (
f"{_tendencia(history or [])}\n"
f"Fase: {_fase(move.get('number', 0))}.\n"
f"Jugada actual ({color_str}): {jugada_es}, clasificada como {clasificacion}. "
f"Explica en una oración el mérito o el problema estratégico de esta jugada."
)
# ── EXPANDIDO (botón "Explicar" / texto largo) ────────────────────────────────
# Rol distinto al corto: aquí SÍ puede nombrar la mejor jugada (que entrega
# Stockfish) y explicar el porqué en 2-4 oraciones. Regla dura: solo la jugada
# que se le pasa, nunca inventar. Es un SYSTEM aparte para no mezclar reglas
# contradictorias con el corto.
SYSTEM_EXPANDIDO = (
"Eres el mismo entrenador de ajedrez, serio y didáctico, y ahora EXPLICAS el "
"error con calma y en palabras SENCILLAS, pensando en un jugador principiante o "
"intermedio que quiere entender qué hizo mal. En 2 a 4 oraciones: (1) expón con "
"claridad qué problema tuvo su jugada, (2) indícale qué jugada era mejor —solo la "
"que se te indica— y por qué le convenía, y (3) cierra con una lección breve y "
"fácil de recordar. Evita tecnicismos innecesarios; usa lenguaje cotidiano pero "
"preciso. Reglas CRÍTICAS: usa ÚNICAMENTE la jugada que se te indica como mejor "
"jugada (NUNCA inventes otra); y si se te dan datos de lo que esa jugada logra (a "
"qué pieza ataca, qué casilla domina...), úsalos TAL CUAL y NO añadas piezas, "
"casillas ni amenazas que no se te hayan dado. No menciones evaluaciones "
"numéricas. Responde SIEMPRE en español, nunca en otro idioma. Mantén un tono "
"sobrio y profesional, sin exclamaciones ni jerga; lo primero es que el alumno "
"ENTIENDA su error."
)
def build_expandido(move: dict, clasificacion: str, history: list | None = None,
mejor_es: str | None = None, detalle: str | None = None) -> str:
color_str = "Blancas" if move["color"] == "white" else "Negras"
# La jugada jugada llega en SAN inglés; se traduce para que coincida con la
# mejor jugada (mejor_es) y el modelo no mezcle notaciones/idiomas.
jugada_es = translate_move_en_es(move["move"])
base = (
f"{_tendencia(history or [])}\n"
f"Fase: {_fase(move.get('number', 0))}.\n"
f"Jugada actual ({color_str}): {jugada_es}, clasificada como {clasificacion}. "
)
if clasificacion == "Brillante":
return base + "Explica con palabras sencillas por qué esta jugada fue tan buena."
if mejor_es:
dato = f", que {detalle}" if detalle else ""
return base + (
f"La mejor jugada era {mejor_es}{dato}. Explica con palabras sencillas "
f"qué estuvo mal en tu jugada, por qué {mejor_es} era mejor (usa ese "
f"dato), y deja una lección corta y fácil de recordar."
)
return base + (
"Explica con palabras sencillas qué estuvo mal en esta jugada, qué idea "
"era mejor, y deja una lección corta."
)
|