Spaces:
Paused
Paused
Download modules/deterministic/plantillas.py from SamilG2/BACKEND-CheckScan: direct link, hf CLI and curl.
- Browser
- Download file 8.25 kB
-
https://huggingface.co/spaces/SamilG2/BACKEND-CheckScan/resolve/main/modules/deterministic/plantillas.py
- Command line
-
hf download hf://spaces/SamilG2/BACKEND-CheckScan/modules/deterministic/plantillas.py
-
curl -L -o plantillas.py https://huggingface.co/spaces/SamilG2/BACKEND-CheckScan/resolve/main/modules/deterministic/plantillas.py
8.25 kB
| """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, | |
| } | |