⚡ LinguaForge

Una suite de traducción asistida por IA (CAT Tool) de alto rendimiento escrita en Rust, especializada en localización de videojuegos de RPG Maker (MZ / MV) y motores basados en Ruby / JS.

---

🌟 Características Principales

• 🎮 Soporte Nativo de Formatos de Juego:
  • RPG Maker MZ / MV: Mapas (MapXXX.json), Bases de datos (Actors.json, Skills.json, Items.json, etc.).
  • Scripts JS & Plugins: Análisis de cadenas traducibles en plugins de RPG Maker.
  • Ruby Marshal: Deserialización y reinyección de objetos de datos en juegos de RPG Maker XP/VX/VX Ace.
• 🛡️ Protección Inteligente de Tokens (Tag Protector):
  • Enmascara y protege automáticamente códigos de control como \V[n], \N[n], \C[n], secuencias de escape y etiquetas HTML antes de enviarlas a la IA para evitar corrupción sintáctica.
• 🤖 Motor de Traducción Multiproveedor por IA:
  • Cloud LPUs / LLMs: Groq (Llama 3.3 70B), Google Gemini, OpenAI (GPT-4o), Anthropic Claude, OpenRouter, GitHub Copilot.
  • Local LLMs: Ollama, LM Studio (privacidad 100% local sin costo de API).
  • Traducción Tradicional: DeepL Translate API, LibreTranslate.
• ⚡ Procesamiento Paralelo de Alto Rendimiento:
  • Núcleo asíncrono optimizado con Tokio y Rayon para procesar proyectos masivos en segundos.
  • Manejo automático de límites de velocidad (Rate Limits 429) con reintentos inteligentes y des-alineación de razonamiento (<think> blocks).
• 📚 Memoria de Traducción (TM) y Glosario:
  • Extracción y sugerencias de terminología en tiempo real.
  • Exportación e importación en formato CSV.
• 🖥️ Interfaz Gráfica Nativa (GUI):
  • Construida con egui / eframe para una experiencia fluida a 60+ FPS sin el consumo de memoria de Electron.
  • Vista previa del juego, árbol de archivos, editor en cuadrícula, búsqueda avanzada y sintetizador de voz (TTS).

---

🏗️ Arquitectura del Proyecto

El proyecto está estructurado como un Cargo Workspace modular compuesto por 4 cajas (crates):

LinguaForge/
├── linguaforge_core/         # Núcleo: Parsers de formatos, Tag Protector, QA Checker y Reinyección
├── linguaforge_storage/      # Almacenamiento: Memoria de Traducción (TM), Glosarios y Gestión de proyectos
├── linguaforge_translator/   # Conectores IA: Cliente asíncrono para Groq, Gemini, OpenAI, Ollama, DeepL, etc.
└── linguaforge_gui/          # Frontend: Interfaz gráfica interactiva basada en egui / eframe

---

🚀 Requisitos e Instalación

Prerrequisitos

Asegúrate de tener instalado el toolchain de Rust (edición 2021 o superior):

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

En sistemas Linux (Arch / CachyOS / Debian / Ubuntu), instala las dependencias de desarrollo de gráfica y ventana:

# Arch Linux / CachyOS
sudo pacman -S base-devel libx11 libxcb libxcursor libxrandr libxi libxkbcommon pkg-config

# Ubuntu / Debian
sudo apt install build-essential libx11-dev libxcb1-dev libxcursor-dev libxrandr-dev libxi-dev libxkbcommon-dev pkg-config libssl-dev

Compilar y Ejecutar

Clona el repositorio y ejecuta la interfaz gráfica:

git clone https://github.com/Shidohs/LinguaForge.git
cd LinguaForge

# Ejecutar la aplicación gráfica
cargo run --release --bin linguaforge_gui

---

🛠️ Proveedores de Traducción Soportados

Proveedor	Tipo	Soporte de Glosario	Recomendado para
Groq (LPU)	Cloud	✅	Máxima velocidad y precisión con Llama 3.3 70B
Google Gemini	Cloud	✅	Traducciones narrativas complejas
OpenAI / OpenRouter	Cloud	✅	GPT-4o / Claude 3.5 Sonnet
Ollama	Local	✅	Uso offline sin enviar datos a la nube
DeepL API	Cloud	⚠️	Traducción directa basada en reglas

---

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Si deseas reportar un error o proponer una mejora:

1. Haz un Fork del repositorio.
2. Crea una rama para tu característica (git checkout -b feature/nueva-caracteristica).
3. Realiza tus commits (git commit -m 'feat: añadir nueva característica').
4. Haz push a la rama (git push origin feature/nueva-caracteristica).
5. Abre un Pull Request.

---

📄 Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.