Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,11 @@ Todos los cambios importantes de ModpackES quedan en este archivo. El formato si

### Agregado

- **Perfiles de calidad** («Calidad» en la ventana y `--calidad` en `analizar` y `traducir`). El análisis estima el costo de cada uno:
- **Equilibrado** (por defecto): después de traducir, lo que quedó con dudas (cifras distintas, un paréntesis sin cerrar, usted, inglés, un término del glosario…) se corrige una vez explicando qué falló. La corrección se queda solo si pasa las reglas y un juez a ciegas la prefiere en los dos órdenes; si no, queda la primera, marcada. Cuesta cerca de un 5 % más.
- **Máximo:** además, cada texto corto (6 palabras o menos: nombres, botones) se traduce tres veces en lotes distintos. Gana la traducción en que coinciden dos; si no coinciden, gana la de mejor promedio entre tres señales (dudas del control de calidad, términos del glosario y parecido con las otras), y el texto queda marcado para revisarlo. También activa la revisión de misiones y libros. Cuesta un 30 % más, más la revisión. Con Gemini 3.8 Flash no mejoró de forma medible (ver [docs/calidad.md](docs/calidad.md)): queda como opción.
- **Económico:** solo los arreglos automáticos, como hasta ahora.
- **La revisión de misiones y libros ya no acepta a ciegas lo que rehace:** la versión nueva tiene que ganarle a la anterior ante un juez que no sabe cuál es cuál, en los dos órdenes. Un modelo que corrige su propia traducción tiende a cambiar cosas que estaban bien.
- **Control de calidad determinista** después de cada traducción, con las ideas de las herramientas de QA de la industria y las convenciones del español de Minecraft:
- Se arregla solo lo que no tiene riesgo: espacios dobles o antes de la puntuación, caracteres invisibles, una palabra repetida seguida, «¿» y «¡» que faltan en una frase única, el «:» o los «...» finales que se perdieron (el juego escribe «...», no «…»), las comillas del dialecto (es_es «», es_mx "") si el original las tiene, y meses y días con mayúscula a mitad de frase. Los códigos de formato no se tocan.
- Queda como duda, para revisarlo: cifras distintas del original (con tolerancia a «1,000» = «1.000» y a las cifras escritas con letras), paréntesis o corchetes sin pareja, formas de usted (el juego tutea), palabras en inglés que quedaron, y frases que se perdieron.
Expand Down Expand Up @@ -56,6 +61,13 @@ Todos los cambios importantes de ModpackES quedan en este archivo. El formato si

### Cambiado

- **La memoria distingue cada modpack y recuerda lo dudoso:**
- Cada traducción se guarda con su modpack y con su calidad: «ok», o el motivo por el que se aceptó con dudas.
- Un modpack siempre usa lo suyo. De otro modpack solo usa lo que quedó bien: un término del glosario que no se cumplió en un pack ya no se copia a todos los demás.
- Los nombres del propio juego mandan sobre la memoria («Lingote de hierro» aunque la memoria diga «Lingote de Hierro»). Por encima solo quedan tus correcciones y tu glosario.
- Lo que la memoria tiene como bueno se vuelve a comprobar con los códigos y el glosario de hoy. Si ya no cumple (por ejemplo, agregaste un término), ese texto se traduce de nuevo una vez. Lo que se aceptó con dudas en el mismo pack no se vuelve a pedir, para no pagar en cada traducción.
- La memoria se actualiza sola la primera vez que se abre: lo de antes queda como «ok» y para todos los packs, y se guarda una copia del archivo viejo (`memoria.sqlite.v1.bak`).
- El paquete compartible (`.modpackes.zip`) lleva marcado lo dudoso; al aplicarlo, eso queda solo para ese modpack. Un paquete viejo sigue sirviendo.
- **Más contexto en los textos de los mods, sin costo extra:**
- Los textos van al motor en el orden del archivo y no en orden alfabético, así que un lote junta el nombre de un objeto con su tooltip y el título de una misión con su descripción.
- Un tooltip o una descripción dice de qué objeto habla («habla de «Teleporter»»).
Expand Down
15 changes: 12 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ y **cualquier lanzador**, y escribe a la vez las siete variantes de español del

- **No modifica los jars de los mods.** Lo de los mods va en un resource pack aparte.
- **Todo tiene copia de seguridad.** Un botón devuelve el modpack a su texto original.
- **No se paga dos veces.** Lo ya traducido queda en una memoria que se reutiliza, también entre modpacks.
- **No se paga dos veces.** Lo ya traducido queda en una memoria que se reutiliza, también entre modpacks (de otro modpack, solo lo que quedó sin dudas).
- **Respeta los formatos.** Colores, enlaces, variables y comandos llegan intactos; lo que no pasa las
reglas de calidad se reintenta o queda en inglés antes que romper algo.

Expand Down Expand Up @@ -86,10 +86,19 @@ El campo **Ambientación** (opcional) le cuenta al motor de qué va el modpack:
amable; “Bells” es la moneda del pueblo». Ayuda con el tono y con los términos propios del pack, y se guarda
por instancia.

**Calidad** (en «Opciones avanzadas» y `--calidad`):
- **Equilibrado**, el perfil por defecto: lo que quedó con dudas se corrige una vez. La corrección se queda solo si
un juez a ciegas la prefiere. Cuesta cerca de un 5 % más.
- **Máximo:** además, cada texto corto se traduce tres veces y se elige por consenso, y se revisan misiones y libros.
Cuesta un 30 % más, más la revisión. Con Gemini 3.8 Flash no mejoró de forma medible: es una opción para
modelos que dudan más.
- **Económico:** solo los arreglos automáticos.

**Revisión automática** (opcional, en «Opciones avanzadas», solo misiones y libros): después de traducir, otro
pedido al motor juzga cada traducción nueva al estilo de [GEMBA-MQM](https://aclanthology.org/2023.wmt-1.64)
(exactitud, terminología, fluidez y estilo, con gravedad leve, grave o crítica) y las graves se vuelven a
traducir indicando el error. La nueva traducción tiene que pasar las mismas reglas; si no, queda la anterior.
traducir indicando el error. La nueva traducción tiene que pasar las mismas reglas y ganarle a la anterior ante
un juez a ciegas, en los dos órdenes; si no, queda la anterior.
Tus correcciones nunca se revisan. Sube el costo de esos textos (el análisis lo incluye) y sus marcas no son
infalibles: sirven para decidir qué rehacer, no como nota de calidad.

Expand Down Expand Up @@ -224,7 +233,7 @@ Desde el código fuente (ver [Desarrollo](#desarrollo)):
uv run modpackes instancias
uv run modpackes analizar "RUTA DE LA INSTANCIA"
uv run modpackes cambios "RUTA" [--json] # qué cambió desde la última traducción y cuánto cuesta (solo lee)
uv run modpackes traducir "RUTA" [--dialecto es_es | --tambien-es-es] [--solo misiones,libros] [--lotes] [--modelo gemini-3.5-flash-lite] [--contexto "granja acogedora"] [--revisar]
uv run modpackes traducir "RUTA" [--dialecto es_es | --tambien-es-es] [--solo misiones,libros] [--lotes] [--modelo gemini-3.5-flash-lite] [--contexto "granja acogedora"] [--revisar] [--calidad economico|equilibrado|maximo]
uv run modpackes restaurar "RUTA"
uv run modpackes cobertura "RUTA" [--java] # qué queda en inglés y por qué (solo lee)
uv run modpackes glosario listar | agregar "Death Knights" "Caballeros de la Muerte" | quitar "Fluix" | importar terminos.json
Expand Down
29 changes: 29 additions & 0 deletions docs/calidad.md
Original file line number Diff line number Diff line change
Expand Up @@ -518,6 +518,35 @@ Para medirlo, una copia del banco de interfaz lleva las pistas nuevas, calculada
- **Descripciones de FTB Quests:** traducirlas como un bloque y no línea por línea queda para la ola de segmentación,
porque cambia cómo se escriben los archivos.

## 15 de noviembre de 2026 · perfiles de calidad: corregir lo dudoso y el consenso de lo corto

Hay tres perfiles: económico, equilibrado y máximo. En los perfiles equilibrado y máximo, toda corrección se queda
solo si un juez a ciegas (el mismo modelo, tarea «comparar», con los códigos enmascarados) prefiere la versión nueva
en los dos órdenes (`validacion/verificacion.py`). Eso vale también para la revisión de misiones y libros, que antes
aceptaba lo rehecho sin juzgarlo.

**Equilibrado** (corrige una vez lo dudoso): en la interfaz no hubo nada dudoso. En misiones actuó en un texto por
corrida:
- en una corrida, el juez prefirió la corrección («ítem» como el es_mx del juego, y la misma cifra que el original);
- en la otra, se quedó la primera.

El costo extra fueron unos 3 pedidos chicos por banco.

**Máximo** (tres traducciones de cada texto de 6 palabras o menos, elegidas por consenso). Gemini 3.8 Flash, dos
corridas, US$ 0,11:

| | Interfaz |
|---|---|
| chrF, económico contra máximo | 75,6 contra 75,7: +0,09 (IC −0,38 a +0,60), no se distingue del ruido |
| Textos que cambiaron | 41 y 42 de 390 |
| Juez a ciegas en los dos órdenes | gana el máximo 37 veces, el económico 32 y 14 empates (p ≈ 0,6 y 0,19) |
| Costo de la traducción | 1,2 veces el económico |

- Con este modelo, las tres traducciones casi siempre coinciden. Cuando no coinciden, la elegida cambia la
redacción («adyacente» por «contiguo», «Unificador» por «Convergente») y no el sentido.
- Coincide con la investigación: elegir entre salidas ayuda sobre todo cuando el modelo duda más. Por eso el
máximo queda como opción y el perfil por defecto es el equilibrado.

## Cómo repetirlo

```
Expand Down
8 changes: 8 additions & 0 deletions scripts/medir_calidad.py
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@
from traductor_es.motores.grabadora import MotorGrabado
from traductor_es.motores.simulador import Simulador
from traductor_es.nucleo.ejemplos import CANTIDAD_EN_LA_APP
from traductor_es.nucleo.traductor import ECONOMICO, PERFILES
from traductor_es.validacion import medicion

RAIZ = Path(__file__).resolve().parent.parent
Expand Down Expand Up @@ -111,6 +112,12 @@ def main(argv: list[str] | None = None) -> int:
help="corridas independientes (cada una con su grabación); la salida lleva _1, _2… en el nombre",
)
ap.add_argument("--simular", action="store_true", help="sin API: solo comprueba que todo funcione")
ap.add_argument(
"--calidad",
choices=PERFILES,
default=ECONOMICO,
help="perfil de calidad (por defecto economico, para comparar con las mediciones anteriores)",
)
ap.add_argument("--banco", type=Path, default=RAIZ / "tests" / "datos" / "referencia_es.json")
ap.add_argument("--salida", type=Path, default=RAIZ / "build" / "medicion.json")
args = ap.parse_args(argv)
Expand Down Expand Up @@ -148,6 +155,7 @@ def main(argv: list[str] | None = None) -> int:
hilos=args.hilos or (1 if args.carga_segura else 4),
cantidad_ejemplos=args.n_ejemplos,
controles_de_forma=not args.sin_controles,
perfil=args.calidad,
)
for m in resultados:
print(m.tabla(), end="\n\n")
Expand Down
16 changes: 14 additions & 2 deletions src/traductor_es/__main__.py
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@
from .motores.simulador import Simulador
from .nucleo.dialectos import DIALECTOS
from .nucleo.memoria import Memoria
from .nucleo.traductor import PERFIL_POR_DEFECTO, PERFILES
from .proceso import GRUPOS, Informe, Proceso
from .registro import LOGGER, configurar
from .salida import exportar, mod_apoyo, paquete
Expand Down Expand Up @@ -52,7 +53,7 @@ def _mostrar(informe: Informe, args: argparse.Namespace) -> None:
linea = f" {m.nombre}: {m.descripcion} — {m.textos} textos, {m.a_traducir} para el motor ({m.caracteres} car.)"
_escribir(linea + (f"\n {m.resumen}" if m.resumen else ""))
modelo, lotes = _modelo(args), args.lotes
costo = informe.costo(modelo, lotes, args.motor, args.revisar)
costo = informe.costo(modelo, lotes, args.motor, args.revisar, getattr(args, "calidad", PERFIL_POR_DEFECTO))
_escribir(f"Total para el motor: {informe.a_traducir} textos, {informe.caracteres} caracteres")
if costo is not None:
_escribir(f"Costo estimado con {modelo}{' (por lotes)' if lotes else ''}: US$ {costo:.2f}")
Expand Down Expand Up @@ -93,6 +94,16 @@ def comunes(p: argparse.ArgumentParser) -> None:
p.add_argument("--lotes", action="store_true", help="usar la Batch API de Gemini (mitad de precio, tarda más)")
p.add_argument("--contexto", default="", help="ambientación del modpack para el tono y los términos")
p.add_argument("--revisar", action="store_true", help="revisión automática de misiones y libros (cuesta más)")
p.add_argument(
"--calidad",
choices=PERFILES,
default=PERFIL_POR_DEFECTO,
help=(
"economico: solo arreglos automáticos; equilibrado (por defecto): además corrige lo dudoso si un "
"juez a ciegas lo prefiere (≈ +5 %%); maximo: además traduce tres veces lo corto y revisa misiones "
"y libros (≈ +30 %% más la revisión)"
),
)
p.add_argument(
"--exhaustivo",
action="store_true",
Expand Down Expand Up @@ -177,6 +188,7 @@ def _traducir_o_analizar(args: argparse.Namespace) -> None:
Proceso(
args.carpeta, motor, args.dialecto, grupos, memoria=memoria, registro=_escribir,
hilos=getattr(args, "hilos", 4), usar_lotes=args.lotes, contexto=args.contexto, revisar=args.revisar,
calidad=getattr(args, "calidad", PERFIL_POR_DEFECTO),
texto_java=args.java,
scripts_exhaustivo=args.exhaustivo, tambien_es_es=args.tambien_es_es,
) as p,
Expand Down Expand Up @@ -296,7 +308,7 @@ def _cambios(args: argparse.Namespace) -> None:
cambios = informe.cambios or Cambios()
diferencia = informe.diferencia
modelo = _modelo(args)
costo = diferencia.costo(modelo, args.lotes, args.motor, args.revisar)
costo = diferencia.costo(modelo, args.lotes, args.motor, args.revisar, getattr(args, "calidad", PERFIL_POR_DEFECTO))
if args.json:
datos = {
"base": cambios.base, "fecha": cambios.fecha, "nuevas": cambios.nuevas, "cambiadas": cambios.cambiadas,
Expand Down
10 changes: 10 additions & 0 deletions src/traductor_es/fuentes/modpack.py
Original file line number Diff line number Diff line change
Expand Up @@ -99,3 +99,13 @@ def datos_del_modpack(juego: Path) -> DatosModpack:
if not nombre:
nombre = juego.parent.name if juego.name in (".minecraft", "minecraft") else juego.name
return DatosModpack(nombre, version)


def identificador(juego: Path) -> str:
"""Con qué nombre se guarda el modpack en la memoria: el nombre del pack (sin la versión, para que una
actualización siga usando lo suyo) o, si no se sabe, el de su carpeta."""
nombre = datos_del_modpack(juego).nombre
if nombre:
return nombre
carpeta = juego.parent if juego.name.lower() in ("minecraft", ".minecraft") else juego
return carpeta.name or "instancia"
13 changes: 12 additions & 1 deletion src/traductor_es/motores/simulador.py
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
"""Motor falso para probar todo sin gastar: antepone «ES» y, si se pide, daña textos a propósito.

Para probar la revisión: marca como «grave» las traducciones de `marcar` y, cuando una pista pide corregir, antepone
«ES*» en vez de «ES».
«ES*» en vez de «ES». Como juez («comparar»), con `marcar` prefiere la versión corregida («ES*»); si no, dice «igual».
"""

from __future__ import annotations
Expand Down Expand Up @@ -35,6 +35,17 @@ def traducir_lote(self, lote: Lote) -> dict[str, str]:
e.id: "grave|exactitud|marcado por la prueba" if e.traduccion in self.marcar else "OK"
for e in lote.entradas
}
if lote.tarea == "comparar":
return {
e.id: "igual"
if not self.marcar
else "A"
if "«ES*»" in e.traduccion
else "B"
if "«ES*»" in e.alternativa
else "igual"
for e in lote.entradas
}
salida: dict[str, str] = {}
for e in lote.entradas:
prefijo = "«ES*» " if "revisión" in e.pista else self.prefijo
Expand Down
30 changes: 30 additions & 0 deletions src/traductor_es/nucleo/glosario.py
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ def __init__(self) -> None:
self._palabras_es: set[str] = set() #: palabras del español de esos textos (sin mayúsculas)
self._ambiguos: dict[tuple[str, str], bool] = {}
self._marcas: set[str] = set() #: nombres de mods («create»): no son inglés a medio traducir
self._por_palabra: dict[str, list[tuple[str, str, re.Pattern[str]]]] | None = None

def __len__(self) -> int:
return len(self._terminos) + len(self._fijos)
Expand Down Expand Up @@ -230,8 +231,37 @@ def _ordenados(self) -> list[tuple[str, str, re.Pattern[str]]]:
for k in sorted(todos, key=len, reverse=True)
]
self._orden = orden
self._por_palabra = None
return orden

def oficial(self, texto: str) -> str | None:
"""El nombre del propio juego para ese texto entero («Iron Ingot» → «Lingote de hierro»), si el usuario no
lo cambió."""
t = texto.strip()
return self._terminos.get(t) if t in self._oficiales and t not in self._fijos else None

def terminos_en(self, texto: str, maximo: int = 60) -> dict[str, str]:
"""Lo mismo que `relevantes([texto])`, rápido para muchos textos sueltos: solo mira los términos que empiezan
con una palabra del texto."""
orden = self._ordenados()
if self._por_palabra is None:
indice: dict[str, list[tuple[str, str, re.Pattern[str]]]] = {}
for termino in orden:
primera = next(iter(PALABRA.findall(termino[0])), termino[0])
indice.setdefault(primera, []).append(termino)
self._por_palabra = indice
bajo = sin_formato(texto).lower()
candidatos = [c for p in set(PALABRA.findall(bajo)) for c in self._por_palabra.get(p, ())]
elegidos: dict[str, str] = {}
for termino_bajo, original, patron in sorted(candidatos, key=lambda c: -len(c[0])):
if termino_bajo in bajo and patron.search(bajo):
if self.ambiguo(original) and not uso_como_nombre(original, texto):
continue
elegidos[original] = self._fijos.get(original) or self._terminos[original]
if len(elegidos) >= maximo:
break
return elegidos

def relevantes(self, textos: Iterable[str], maximo: int = 60) -> dict[str, str]:
"""Términos que aparecen como palabra completa en los textos, priorizando los más largos.

Expand Down
Loading
Loading