Spaces:
Paused
Paused
feat: coach academico - SYSTEM sobrio + español, temp 0.35 y guardrail anti-CJK
Browse files- modules/llm/guardrails.py +17 -0
- modules/llm/prompt_builder.py +25 -23
- modules/llm/qwen.py +1 -1
- routes/comment.py +3 -2
modules/llm/guardrails.py
CHANGED
|
@@ -52,9 +52,26 @@ _FILLER_RE = re.compile(
|
|
| 52 |
re.IGNORECASE,
|
| 53 |
)
|
| 54 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 55 |
|
| 56 |
def _limpiar(text: str) -> str:
|
| 57 |
"""Borra evaluaciones numéricas y muletillas que se hayan filtrado."""
|
|
|
|
| 58 |
text = _EVAL_RE.sub('', text)
|
| 59 |
text = _FILLER_RE.sub('', text)
|
| 60 |
# Limpia puntuación huérfana y espacios dobles que deja el borrado.
|
|
|
|
| 52 |
re.IGNORECASE,
|
| 53 |
)
|
| 54 |
|
| 55 |
+
# Caracteres CJK (chino/japonés/coreano y fullwidth). El base de Qwen a veces
|
| 56 |
+
# deriva a chino en generaciones largas; este filtro garantiza que eso NUNCA
|
| 57 |
+
# llegue al usuario aunque ocurra.
|
| 58 |
+
_CJK_RE = re.compile('[ -鿿-]')
|
| 59 |
+
|
| 60 |
+
|
| 61 |
+
def strip_cjk(text: str) -> str:
|
| 62 |
+
"""Si aparece un carácter CJK, corta el texto ahí y lo recorta a la última
|
| 63 |
+
oración completa (para no dejar una frase a medias)."""
|
| 64 |
+
m = _CJK_RE.search(text or "")
|
| 65 |
+
if not m:
|
| 66 |
+
return text
|
| 67 |
+
cortado = text[:m.start()]
|
| 68 |
+
fin = max(cortado.rfind('.'), cortado.rfind('!'), cortado.rfind('?'))
|
| 69 |
+
return (cortado[:fin + 1] if fin != -1 else cortado).strip()
|
| 70 |
+
|
| 71 |
|
| 72 |
def _limpiar(text: str) -> str:
|
| 73 |
"""Borra evaluaciones numéricas y muletillas que se hayan filtrado."""
|
| 74 |
+
text = strip_cjk(text)
|
| 75 |
text = _EVAL_RE.sub('', text)
|
| 76 |
text = _FILLER_RE.sub('', text)
|
| 77 |
# Limpia puntuación huérfana y espacios dobles que deja el borrado.
|
modules/llm/prompt_builder.py
CHANGED
|
@@ -4,18 +4,18 @@ from modules.analysis.classifier import classify
|
|
| 4 |
# evaluación numérica las muestra Stockfish por separado en la UI, así que el
|
| 5 |
# modelo NO debe mencionarlas (de hecho no se las pasamos en el prompt).
|
| 6 |
SYSTEM = (
|
| 7 |
-
"Eres un
|
| 8 |
-
"
|
| 9 |
-
"
|
| 10 |
-
"en
|
| 11 |
-
"
|
| 12 |
-
"
|
| 13 |
-
"
|
| 14 |
-
"
|
| 15 |
-
"
|
| 16 |
-
"
|
| 17 |
-
"
|
| 18 |
-
"
|
| 19 |
)
|
| 20 |
|
| 21 |
# Clasificaciones que cuentan como "mala jugada" para detectar tendencia.
|
|
@@ -68,17 +68,19 @@ def build(move: dict, clasificacion: str, history: list | None = None) -> str:
|
|
| 68 |
# que se le pasa, nunca inventar. Es un SYSTEM aparte para no mezclar reglas
|
| 69 |
# contradictorias con el corto.
|
| 70 |
SYSTEM_EXPANDIDO = (
|
| 71 |
-
"Eres el mismo
|
| 72 |
-
"
|
| 73 |
-
"quiere entender qué hizo mal. En 2 a 4 oraciones: (1)
|
| 74 |
-
"problema tuvo su jugada, (2)
|
| 75 |
-
"indica— y por qué le convenía, y (3) cierra con una lección
|
| 76 |
-
"recordar. Evita tecnicismos; usa lenguaje cotidiano
|
| 77 |
-
"ÚNICAMENTE la jugada que se te indica como mejor
|
| 78 |
-
"otra); y si se te dan datos de lo que esa jugada logra (a
|
| 79 |
-
"qué casilla domina...), úsalos TAL CUAL y NO añadas piezas,
|
| 80 |
-
"amenazas que no se te hayan dado. No menciones evaluaciones
|
| 81 |
-
"
|
|
|
|
|
|
|
| 82 |
)
|
| 83 |
|
| 84 |
|
|
|
|
| 4 |
# evaluación numérica las muestra Stockfish por separado en la UI, así que el
|
| 5 |
# modelo NO debe mencionarlas (de hecho no se las pasamos en el prompt).
|
| 6 |
SYSTEM = (
|
| 7 |
+
"Eres un entrenador de ajedrez serio y didáctico, con un registro claro y "
|
| 8 |
+
"profesional, como un buen profesor. Comentas las jugadas de tu alumno "
|
| 9 |
+
"hablándole de 'tú' en una o dos oraciones precisas, explicando con rigor "
|
| 10 |
+
"pero en lenguaje accesible la idea estratégica detrás de la jugada (control "
|
| 11 |
+
"del centro, seguridad del rey, actividad de las piezas, iniciativa, "
|
| 12 |
+
"estructura de peones). Mantén un tono sobrio y respetuoso: SIN exclamaciones "
|
| 13 |
+
"efusivas, SIN emojis y SIN jerga ni coloquialismos. La prioridad es que la "
|
| 14 |
+
"explicación sea correcta, concisa y fácil de entender. "
|
| 15 |
+
"Reglas estrictas: responde SIEMPRE en español (nunca en otro idioma); NO "
|
| 16 |
+
"menciones números ni evaluaciones; NO recomiendes ninguna jugada "
|
| 17 |
+
"alternativa; nada de muletillas. Lo esencial es la idea estratégica "
|
| 18 |
+
"expresada con claridad."
|
| 19 |
)
|
| 20 |
|
| 21 |
# Clasificaciones que cuentan como "mala jugada" para detectar tendencia.
|
|
|
|
| 68 |
# que se le pasa, nunca inventar. Es un SYSTEM aparte para no mezclar reglas
|
| 69 |
# contradictorias con el corto.
|
| 70 |
SYSTEM_EXPANDIDO = (
|
| 71 |
+
"Eres el mismo entrenador de ajedrez, serio y didáctico, y ahora EXPLICAS el "
|
| 72 |
+
"error con calma y en palabras SENCILLAS, pensando en un jugador principiante o "
|
| 73 |
+
"intermedio que quiere entender qué hizo mal. En 2 a 4 oraciones: (1) expón con "
|
| 74 |
+
"claridad qué problema tuvo su jugada, (2) indícale qué jugada era mejor —solo la "
|
| 75 |
+
"que se te indica— y por qué le convenía, y (3) cierra con una lección breve y "
|
| 76 |
+
"fácil de recordar. Evita tecnicismos innecesarios; usa lenguaje cotidiano pero "
|
| 77 |
+
"preciso. Reglas CRÍTICAS: usa ÚNICAMENTE la jugada que se te indica como mejor "
|
| 78 |
+
"jugada (NUNCA inventes otra); y si se te dan datos de lo que esa jugada logra (a "
|
| 79 |
+
"qué pieza ataca, qué casilla domina...), úsalos TAL CUAL y NO añadas piezas, "
|
| 80 |
+
"casillas ni amenazas que no se te hayan dado. No menciones evaluaciones "
|
| 81 |
+
"numéricas. Responde SIEMPRE en español, nunca en otro idioma. Mantén un tono "
|
| 82 |
+
"sobrio y profesional, sin exclamaciones ni jerga; lo primero es que el alumno "
|
| 83 |
+
"ENTIENDA su error."
|
| 84 |
)
|
| 85 |
|
| 86 |
|
modules/llm/qwen.py
CHANGED
|
@@ -81,7 +81,7 @@ def _generate_locked(prompt: str, system: str, max_tokens: int) -> str:
|
|
| 81 |
{"role": "user", "content": prompt},
|
| 82 |
],
|
| 83 |
max_tokens=max_tokens,
|
| 84 |
-
temperature=0.
|
| 85 |
stop=["<|im_end|>", "\n\n\n"],
|
| 86 |
)
|
| 87 |
dt = time.time() - t0
|
|
|
|
| 81 |
{"role": "user", "content": prompt},
|
| 82 |
],
|
| 83 |
max_tokens=max_tokens,
|
| 84 |
+
temperature=0.35,
|
| 85 |
stop=["<|im_end|>", "\n\n\n"],
|
| 86 |
)
|
| 87 |
dt = time.time() - t0
|
routes/comment.py
CHANGED
|
@@ -17,7 +17,7 @@ from modules.deterministic import comentar as comentar_deterministico
|
|
| 17 |
from modules.analysis.move_facts import describe_best_move
|
| 18 |
from modules.llm.prompt_builder import build, build_expandido, SYSTEM_EXPANDIDO
|
| 19 |
from modules.llm.qwen import generate
|
| 20 |
-
from modules.llm.guardrails import validate, brief
|
| 21 |
from modules.transcription.validator import translate_move_en_es
|
| 22 |
from config import COACH_MODEL
|
| 23 |
|
|
@@ -27,7 +27,8 @@ _EVAL_RE = re.compile(r'[+-]?\d+\.\d+|[+-]?M\d*|[+-]\d+')
|
|
| 27 |
|
| 28 |
|
| 29 |
def _limpiar_expandido(text: str) -> str:
|
| 30 |
-
text =
|
|
|
|
| 31 |
return re.sub(r'\s{2,}', ' ', text).strip()
|
| 32 |
|
| 33 |
comment_bp = Blueprint('comment', __name__)
|
|
|
|
| 17 |
from modules.analysis.move_facts import describe_best_move
|
| 18 |
from modules.llm.prompt_builder import build, build_expandido, SYSTEM_EXPANDIDO
|
| 19 |
from modules.llm.qwen import generate
|
| 20 |
+
from modules.llm.guardrails import validate, brief, strip_cjk
|
| 21 |
from modules.transcription.validator import translate_move_en_es
|
| 22 |
from config import COACH_MODEL
|
| 23 |
|
|
|
|
| 27 |
|
| 28 |
|
| 29 |
def _limpiar_expandido(text: str) -> str:
|
| 30 |
+
text = strip_cjk((text or "").strip()) # corta cualquier deriva a chino
|
| 31 |
+
text = _EVAL_RE.sub('', text)
|
| 32 |
return re.sub(r'\s{2,}', ' ', text).strip()
|
| 33 |
|
| 34 |
comment_bp = Blueprint('comment', __name__)
|