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."
    )