File size: 8,252 Bytes
8ccac0b
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
116
117
118
"""Generación de lenguaje natural por plantillas (Experimento A — TA-003).

Cada patrón detectado mapea a un par de comentarios deterministas en español
(neutro, tuteo) con tono de entrenador y SIN recomendar jugadas (la mejor jugada
la muestra Stockfish por separado en la UI). Dos niveles:
  - corto:     1–2 líneas, siempre visible junto al avatar.
  - expandido: contexto de las jugadas previas que llevaron a este momento.

Categoría académica: NLG basada en plantillas (template-based generation).
"""

_PLANTILLAS = {
    "caida_brusca": {
        "corto": "Venías llevando bien la partida y aquí rompes el ritmo; cuidado con regalar lo que construiste.",
        "expandido": "Tus últimas jugadas venían siendo sólidas, pero esta marca una caída brusca respecto a ese nivel. No es un problema de toda la partida sino un descuido puntual: frena, respira y retoma el plan que te venía funcionando.",
    },
    "deterioro_sostenido": {
        "corto": "Llevas {racha} jugadas cediendo terreno de forma sostenida; esta agrava el patrón.",
        "expandido": "No es un error aislado: tu evaluación viene bajando jugada tras jugada (ya acumulas {imprecisiones} imprecisiones y {errores} errores en la partida). La tendencia es de deterioro progresivo, así que conviene cortar la inercia y reordenar la posición antes de que el desgaste se vuelva decisivo.",
    },
    "rey_sin_enrocar": {
        "corto": "Tu rey lleva varias jugadas sin enrocar y quedó expuesto en el centro.",
        "expandido": "Vienes demorando el enroque y tu rey sigue en el centro, donde es vulnerable. Antes de seguir con otros planes, ponlo a salvo: la seguridad del rey es una prioridad de la apertura, y este error lo confirma.",
    },
    "sin_desarrollo": {
        "corto": "Tus piezas siguen dormidas; llevas jugadas sin sacarlas al juego.",
        "expandido": "Las jugadas previas descuidaron el desarrollo: tus caballos y alfiles siguen en casa. Sin piezas activas cuesta crear amenazas o defenderte; prioriza sacar las menores en vez de mover lo mismo dos veces.",
    },
    "cede_centro": {
        "corto": "Vienes cediendo el control del centro jugada tras jugada.",
        "expandido": "A lo largo de las últimas jugadas fuiste perdiendo presencia en el centro (d4/e4/d5/e5). Quien domina el centro dicta el juego; recupera esas casillas con peones o piezas antes de que tu rival se asiente ahí.",
    },
    "avance_enroque": {
        "corto": "Estás empujando los peones que protegen a tu rey y debilitas su refugio.",
        "expandido": "Adelantar los peones delante del rey enrocado abre líneas hacia tu propia posición. Salvo que sea un ataque muy concreto, conviene no tocar ese escudo de peones: cada avance deja huecos que el rival puede aprovechar.",
    },
    "dama_temprano": {
        "corto": "Sacaste la dama demasiado pronto; el rival gana tiempo atacándola.",
        "expandido": "Mover la dama temprano la expone: tu rival desarrolla sus piezas con tempo, atacándola y ganando ritmo. Mejor desarrolla primero caballos y alfiles, y reserva la dama para cuando la posición lo pida.",
    },
    "pieza_repetida": {
        "corto": "Moviste la misma pieza otra vez en lugar de desarrollar nuevas.",
        "expandido": "En la apertura cada tiempo cuenta. Volver a mover una pieza ya desarrollada, mientras otras siguen en casa, te hace perder ritmo de desarrollo. Saca una pieza nueva al juego en vez de reacomodar la misma.",
    },
    "caballo_borde": {
        "corto": "Llevaste el caballo al borde, donde controla muy pocas casillas.",
        "expandido": "Un caballo en la columna del borde (a/h) domina menos casillas que en el centro y suele quedar mal colocado. Salvo que vaya a una buena casilla concreta, conviene dirigir los caballos hacia el centro del tablero.",
    },
    "error_en_final": {
        "corto": "En el final cada imprecisión pesa el doble, y aquí estás soltando ventaja.",
        "expandido": "Estás en la fase final, donde los márgenes de error son mínimos y cada concesión cuesta caro. Una imprecisión que en el medio juego sería recuperable, en el final puede definir el resultado: juega con más cuidado y calcula hasta el final.",
    },
    "hallazgo": {
        "corto": "Gran recurso táctico: encontraste algo por encima de tu línea habitual.",
        "expandido": "Esta jugada destaca sobre el resto de tu partida: detectaste un recurso táctico que mejora claramente tu posición. Buen ojo; ese tipo de hallazgos son los que inclinan partidas parejas.",
    },
    "recuperacion": {
        "corto": "Buena reacción: estás recuperando el control después de un tramo flojo.",
        "expandido": "Después de unas jugadas por debajo de tu nivel, retomas el rumbo y tu evaluación vuelve a mejorar. Mantén esta concentración: salir de un mal tramo sin hundirte es una señal de solidez.",
    },
    "solidez": {
        "corto": "Jugada sólida, mantienes el plan sin sobresaltos.",
        "expandido": "Vienes sosteniendo un nivel parejo, sin concesiones importantes. No hay mucho que corregir aquí: sigue con la misma claridad de plan y sin apurarte.",
    },
    # Fallback por tipo de jugada (cuando no hay un patrón fuerte): evita el
    # comentario genérico idéntico mencionando qué clase de jugada fue.
    "leve_captura": {
        "corto": "Esta captura no termina de favorecerte; cambiaste sin mejorar tu posición.",
        "expandido": "Cambiar piezas no es malo en sí, pero aquí la captura entrega algo de ventaja sin una compensación clara. Antes de cambiar, fíjate si el cambio te conviene o si ayuda más al rival.",
    },
    "leve_peon": {
        "corto": "Este avance de peón no aporta mucho y cede algo de precisión.",
        "expandido": "Los avances de peón son permanentes: no se vuelven atrás y dejan casillas débiles. Este no mejora tu posición; en general conviene priorizar desarrollo y seguridad antes de mover peones sin un plan concreto.",
    },
    "leve_pieza": {
        "corto": "Mueves la pieza, pero la jugada cede algo de precisión; quizá había algo mejor.",
        "expandido": "La jugada no es grave, pero tu pieza queda algo menos activa de lo posible. Busca casillas donde tus piezas presionen el centro o las debilidades del rival, no solo una casilla cómoda.",
    },
    "leve_enroque": {
        "corto": "El enroque no era el momento más preciso, aunque la posición sigue jugable.",
        "expandido": "Enrocar casi siempre es bueno, pero el timing importa: aquí había algo un poco más exacto primero. De todos modos poner el rey a salvo rara vez es un error serio.",
    },
    "leve_otro": {
        "corto": "Esta jugada cede algo de precisión, pero la partida sigue equilibrada.",
        "expandido": "Es una pequeña concesión dentro de una partida que venías manejando bien. No es para alarmarse: registra el detalle y vuelve a tu plan en la próxima jugada.",
    },
    "desviacion_leve": {
        "corto": "Esta jugada cede algo de precisión, pero la partida sigue equilibrada.",
        "expandido": "Es una pequeña concesión dentro de una partida que venías manejando bien. No es para alarmarse: registra el detalle y vuelve a tu plan en la próxima jugada.",
    },
    "neutro": {
        "corto": "Mantienes el equilibrio de la posición.",
        "expandido": "La partida sigue su curso sin cambios estratégicos relevantes en este momento. Sigue atento a la evolución de la posición.",
    },
}

_FALLBACK = {"corto": "Jugada registrada.", "expandido": None}


def generar(patron: str, estado) -> dict:
    """Rellena la plantilla del patrón con los valores del estado acumulado.

    Devuelve {corto, expandido}. La interpolación usa solo enteros del estado
    (racha, errores…), así que el texto es totalmente determinista.
    """
    plantilla = _PLANTILLAS.get(patron, _FALLBACK)
    ctx = {
        "racha": estado.racha,
        "errores": estado.errores,
        "imprecisiones": estado.imprecisiones,
        "fase": estado.fase,
    }
    expandido = plantilla["expandido"]
    return {
        "corto": plantilla["corto"].format(**ctx),
        "expandido": expandido.format(**ctx) if expandido else None,
    }