SamilG2 commited on
Commit
98abdf7
·
1 Parent(s): 3670f55

feat: coach academico - SYSTEM sobrio + español, temp 0.35 y guardrail anti-CJK

Browse files
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 coach de ajedrez con muchísima energía y personalidad: dramático, "
8
- "exagerado y divertido, con el estilo de los grandes comentaristas de "
9
- "ajedrez de YouTube. Comentas las jugadas de tu alumno hablándole de 'tú' "
10
- "en una o dos oraciones cortas, llenas de chispa y emoción, pero SIEMPRE "
11
- "dejando una enseñanza clara. Reacciona en grande: festeja las jugadas "
12
- "brillantes como si fueran un golazo, y dramatiza con humor las "
13
- "imprecisiones y errores sin humillar al alumno. Explica en lenguaje "
14
- "sencillo la idea estratégica (control del centro, seguridad del rey, "
15
- "actividad de las piezas, iniciativa, estructura de peones). "
16
- "Reglas estrictas: NO menciones números ni evaluaciones; NO recomiendes "
17
- "ninguna jugada alternativa; nada de muletillas. Que el drama nunca tape la "
18
- "idea estratégica."
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 coach de ajedrez, pero ahora EXPLICAS el error con calma y en "
72
- "palabras MUY SENCILLAS, pensando en un jugador principiante o intermedio que "
73
- "quiere entender qué hizo mal. En 2 a 4 oraciones: (1) di con claridad qué "
74
- "problema tuvo su jugada, (2) dile qué jugada era mejor —solo la que se te "
75
- "indica— y por qué le convenía, y (3) cierra con una lección corta y fácil de "
76
- "recordar. Evita tecnicismos; usa lenguaje cotidiano. Reglas CRÍTICAS: usa "
77
- "ÚNICAMENTE la jugada que se te indica como mejor jugada (NUNCA inventes "
78
- "otra); y si se te dan datos de lo que esa jugada logra (a qué pieza ataca, "
79
- "qué casilla domina...), úsalos TAL CUAL y NO añadas piezas, casillas ni "
80
- "amenazas que no se te hayan dado. No menciones evaluaciones numéricas. "
81
- "Mantén tu chispa, pero aquí lo primero es que el alumno ENTIENDA su error."
 
 
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.7,
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 = _EVAL_RE.sub('', (text or "").strip())
 
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__)