Spaces:
Paused
Paused
Download modules/analysis/move_facts.py from SamilG2/BACKEND-CheckScan: direct link, hf CLI and curl.
- Browser
- Download file 3.82 kB
-
https://huggingface.co/spaces/SamilG2/BACKEND-CheckScan/resolve/main/modules/analysis/move_facts.py
- Command line
-
hf download hf://spaces/SamilG2/BACKEND-CheckScan/modules/analysis/move_facts.py
-
curl -L -o move_facts.py https://huggingface.co/spaces/SamilG2/BACKEND-CheckScan/resolve/main/modules/analysis/move_facts.py
3.82 kB
| """Hechos REALES de la mejor jugada (TA-002, expandido anclado a la posición). | |
| Calcula, con python-chess sobre la posición real, qué logra la `mejor_jugada` de | |
| Stockfish: si desarrolla, si va al centro, qué pieza rival ataca/captura, si da | |
| jaque o enroca. Devuelve una frase corta en español que el LLM usa como DATO | |
| (no inventa nada: todo sale del tablero). | |
| Se reconstruye la posición ANTES de la jugada del jugador (a partir del historial | |
| SAN), que es justo donde aplica la mejor jugada (Stockfish la calcula ahí). | |
| """ | |
| from __future__ import annotations | |
| import chess | |
| _PIEZA_ES = { | |
| chess.PAWN: "peón", chess.KNIGHT: "caballo", chess.BISHOP: "alfil", | |
| chess.ROOK: "torre", chess.QUEEN: "dama", chess.KING: "rey", | |
| } | |
| _HOME_MINOR = { | |
| chess.WHITE: {chess.B1, chess.G1, chess.C1, chess.F1}, | |
| chess.BLACK: {chess.B8, chess.G8, chess.C8, chess.F8}, | |
| } | |
| _CENTRO = {chess.D4, chess.E4, chess.D5, chess.E5} | |
| def _reconstruir(sans: list[str]) -> chess.Board | None: | |
| board = chess.Board() | |
| for san in sans: | |
| if not san: | |
| return None | |
| try: | |
| board.push_san(san) | |
| except (ValueError, AssertionError): | |
| return None | |
| return board | |
| def describe_best_move(history_sans: list[str], mejor_en: str | None, | |
| color_str: str) -> str | None: | |
| """Frase factual ('desarrolla tu caballo al centro y ataca el peón rival de | |
| e5') de lo que logra la mejor jugada. None si no se puede calcular —el | |
| expandido cae entonces a una explicación genérica.""" | |
| if not mejor_en: | |
| return None | |
| board = _reconstruir(list(history_sans)) | |
| if board is None: | |
| return None | |
| color = chess.WHITE if color_str == "white" else chess.BLACK | |
| if board.turn != color: # la posición debe estar al turno del jugador | |
| return None | |
| try: | |
| move = board.parse_san(mejor_en) | |
| except (ValueError, AssertionError): | |
| return None | |
| pieza = board.piece_at(move.from_square) | |
| if pieza is None: | |
| return None | |
| es_enroque = board.is_castling(move) | |
| es_captura = board.is_capture(move) and not board.is_en_passant(move) | |
| cap_tipo = board.piece_at(move.to_square).piece_type if es_captura else None | |
| desarrolla = (pieza.piece_type in (chess.KNIGHT, chess.BISHOP) | |
| and move.from_square in _HOME_MINOR[color]) | |
| board.push(move) | |
| da_jaque = board.is_check() | |
| dest = move.to_square | |
| central = dest in _CENTRO | |
| # Pieza rival más valiosa que la jugada ataca desde su nueva casilla. | |
| atacadas = [] | |
| for sq in board.attacks(dest): | |
| p = board.piece_at(sq) | |
| if p and p.color != color and p.piece_type != chess.KING: | |
| atacadas.append((p.piece_type, sq)) | |
| atacadas.sort(key=lambda t: t[0], reverse=True) # dama > torre > menor > peón | |
| # ── Redacción factual ───────────────────────────────────────────────────── | |
| if es_enroque: | |
| return "pone tu rey a salvo enrocando" | |
| nombre = _PIEZA_ES.get(pieza.piece_type, "pieza") | |
| if desarrolla and central: | |
| base = f"desarrolla tu {nombre} al centro" | |
| elif desarrolla: | |
| base = f"desarrolla tu {nombre}" | |
| elif central: | |
| base = f"lleva tu {nombre} al centro" | |
| else: | |
| base = f"coloca tu {nombre} en {chess.square_name(dest)}" | |
| extras = [] | |
| if cap_tipo is not None: | |
| extras.append(f"captura el {_PIEZA_ES.get(cap_tipo, 'pieza')} rival") | |
| elif atacadas: | |
| tipo, sq = atacadas[0] | |
| extras.append(f"ataca el {_PIEZA_ES.get(tipo, 'pieza')} rival de {chess.square_name(sq)}") | |
| if da_jaque: | |
| extras.append("da jaque") | |
| return base + (" y " + " y ".join(extras) if extras else "") | |