Browser AI v0.2.1 Beta

Browser AI - Versión 0.2.1-beta

Fecha de lanzamiento: 07 de noviembre de 2025

🚀 Resumen de la versión

Esta versión representa una evolución importante de Browser AI, agregando capacidades de resumen automático e internacionalización completa a la extensión de traducción existente. Se han implementado mejoras arquitectónicas significativas que permiten un manejo más robusto y escalable de las funcionalidades de IA.

✨ Nuevas características principales

🌍 Internacionalización completa (i18n)

• Soporte multilingüe nativo: Implementación completa de internacionalización usando el sistema de Chrome Extensions
• Idiomas soportados: Español e inglés con localización completa de UI
• Archivos de localización:
  • public/_locales/en/messages.json - 307 strings en inglés
  • public/_locales/es/messages.json - 307 strings en español
• Detección automática: Chrome detecta automáticamente el idioma del navegador
• Strings internacionalizables: Todos los elementos de UI, mensajes de error y nombres de idiomas ahora son traducibles

📝 Funcionalidad de resumen de texto

• Resumen automático: Nueva capacidad para generar resúmenes concisos usando IA on-device
• API Summarizer: Integración con Chrome AI Summarizer API
• Opciones de resumen configurables:
  • Tipos: TLDR, key-points, outline
  • Longitudes: short, medium, long
  • Formatos: plain-text, markdown
• Soporte de idiomas para resumen: Inglés, español y japonés
• Lógica inteligente de idiomas: Traducción automática cuando el idioma origen/destino no está soportado

🔀 Menú contextual jerárquico

• Menú padre: "Browser AI" como menú principal
• Submenús especializados:
  • "Traducir" - Para funciones de traducción
  • "Resumir" - Para funciones de resumen
• Activación automática: El menú contextual abre el panel y ejecuta la acción seleccionada
• Precarga inteligente: El texto seleccionado se carga automáticamente en el panel

🏗️ Arquitectura y refactorización

Nuevo AIService (Orquestador de IA)

• Servicio centralizado: Maneja tanto traducción como resumen en un solo punto
• Abstracción de proveedores: Unifica el acceso a diferentes APIs de IA
• Ejecución diferida: Manejo inteligente de descargas de modelos con ejecución automática
• Gestión de estados: Notificaciones push para estados de descarga y completación

ModelManager refactorizado

• Separación de responsabilidades: Extraído a archivos dedicados:
  • model-manager.service.ts - Lógica de negocio
  • model-manager.model.ts - Tipos y interfaces
• API unificada: Manejo consistente para traducción y resumen
• Sistema de estados mejorado: AIModelStatus con estados 'available', 'downloadable', 'downloading', 'unavailable'
• Gestión de errores robusta: Manejo específico por tipo de error

Mejoras en mensajería

• Protocolo tipado: Sistema de mensajería completamente tipado con TypeScript
• Nuevos mensajes:
  • selectedText con flag summarize
  • modelStatusUpdate con estados detallados
  • processText unificado para traducción/resumen
• Compatibilidad: Mantiene retrocompatibilidad con funcionalidades existentes

📊 Cambios técnicos específicos

Componentes Vue.js

• ProcessControls.vue: Nuevo componente para controles de procesamiento
• Integración Vue 3: Uso de Composition API y <script setup>
• Eventos bidireccionales: Sincronización entre componentes Vue y lógica vanilla JS

Actualización de dependencias

• Vitest v4.0.7: Actualización desde v3.2.4 con mejoras en mocking
• @webext-core/proxy-service: Nueva dependencia para servicios proxy
• Soporte Vue en Tailwind: Actualización de tailwind.config.js para archivos .vue

Gestión de idiomas mejorada

• Códigos de idioma: Cambio de name a nameKey para soporte i18n
• Detección robusta: Manejo mejorado de errores de detección de idioma
• Fallbacks inteligentes: Traducción automática a inglés para resúmenes

🔧 Mejoras de experiencia de usuario

Estados de UI mejorados

• Advertencia de APIs: Indicador cuando las APIs nativas no están disponibles
• Progreso de descarga: Indicadores visuales para descargas de modelos
• Estados de botones: Lógica mejorada para habilitar/deshabilitar según contexto
• Indicadores de origen: "🔒 Procesado localmente" para identificar el tipo de procesamiento

Manejo de errores

• Mensajes localizados: Todos los errores ahora están internacionalizados
• Recuperación automática: Reintentos automáticos en casos de fallo temporal
• Feedback específico: Mensajes de error específicos por tipo de problema

📚 Documentación y herramientas de desarrollo

Documentación restructurada

• Nueva jerarquía: Reorganización completa de docs/ con versiones
• Guías específicas:
  • vue-architecture.md → docs/guides/vue-architecture.md
  • wxt-architecture.md → docs/guides/wxt-architecture.md
• Especificaciones detalladas: Nuevos documentos para summarize.md y translate.md
• Versionado de documentos: Cada documento incluye versión y fecha de modificación

Herramientas de desarrollo

• Reglas centralizadas: Archivos de reglas movidos a .agents/:
  • code-quality.md - Verificaciones de calidad
  • commit-messages.md - Reglas de mensajes de commit
  • issues-prs.md - Plantillas y flujo de trabajo
• Configuración WXT: Soporte para localización con default_locale: 'es'
• Testing mejorado: Configuración actualizada para mocks y entornos

🧪 Calidad y testing

Cobertura de pruebas ampliada

• Nuevos tests: Pruebas específicas para AIService y funcionalidades de resumen
• Tests de integración: Verificación de flujos completos de traducción/resumen
• Mocks mejorados: Simulación más realista de APIs de Chrome AI
• Tests de i18n: Verificación de que las pruebas son independientes del idioma

Configuración de testing

• Vitest v4.0.7: Nuevas capacidades de mocking y configuración
• Setup unificado: Configuración centralizada en src/tests/setup.ts
• Browser mocking: Simulación completa de APIs del navegador

🔄 Cambios arquitectónicos importantes

CAMBIO ROMPEDOR: Nueva arquitectura de IA

La gestión de modelos AI ha sido completamente refactorizada:

• Antes: Lógica de modelos embebida en background script
• Después:
  • AIService como orquestador de alto nivel
  • ModelManager como gestor de bajo nivel
  • Separación clara de responsabilidades

CAMBIO ROMPEDOR: Sistema de mensajes

• Antes: Mensajes específicos por función (translateText, detectLanguage)
• Después: Protocolo unificado con tipos específicos y nuevos mensajes

CAMBIO ROMPEDOR: Internacionalización

• Antes: Strings hardcodeados en español
• Después: Sistema completo de i18n con detección automática de idioma

📦 Archivos y estructura

Archivos nuevos

public/_locales/en/messages.json          # 307 strings en inglés
public/_locales/es/messages.json          # 307 strings en español
src/entrypoints/background/ai/
  ai.service.ts                           # Servicio orquestador de IA
  ai.service.test.ts                      # Tests del AIService
src/entrypoints/background/model-manager/
  model-manager.service.ts                # Servicio de gestión de modelos
  model-manager.model.ts                  # Tipos e interfaces
  model-manager.service.test.ts           # Tests del ModelManager
src/entrypoints/sidepanel/components/
  ProcessControls.vue                     # Controles de procesamiento
.agents/
  code-quality.md                         # Reglas de calidad
  commit-messages.md                      # Reglas de commits
  issues-prs.md                           # Flujo de issues/PRs
docs/specs/
  summarize.md                            # Especificación de resumen
  translate.md                            # Especificación de traducción

Archivos significativamente modificados

• src/entrypoints/background/index.ts - Reestructuración completa
• src/entrypoints/sidepanel/sidepanel.ts - Integración Vue + funcionalidades nuevas
• src/entrypoints/background/messaging.ts - Protocolo de mensajes tipado
• src/entrypoints/background/available-languages.ts - Soporte i18n
• wxt.config.ts - Configuración de localización
• package.json - Actualización de dependencias y versión
• tailwind.config.js - Soporte para archivos Vue
• vitest.config.ts - Configuración de testing actualizada

Archivos eliminados

• src/utils/model-management.ts - Lógica movida a ModelManager
• src/types/chrome-ai.d.ts - Tipos ahora en archivos dedicados

🎯 Compatibilidad y migración

Compatibilidad hacia atrás

• Funcionalidad existente: La traducción básica sigue funcionando igual
• APIs mantenidas: Los mensajes existentes siguen siendo soportados
• Datos del usuario: No hay cambios en el almacenamiento local

Consideraciones de migración

• Desarrolladores: Revisar implementación de ModelManager personalizado
• Traducciones: Las extensiones existentes necesitarán actualización de strings
• Testing: Actualizar mocks para nuevas APIs de IA

🚀 Próximos pasos y roadmap

Esta versión establece las bases para:

• Más funcionalidades de IA: Escritura, reescritura, corrección
• Idiomas adicionales: Expansión del soporte de idiomas
• Modelos personalizados: Soporte para modelos específicos por caso de uso
• APIs externas: Integración opcional con servicios en la nube
• Optimizaciones: Mejoras de rendimiento y uso de memoria

📈 Métricas de la versión

• +2,847 líneas de código ag...

Browser AI v0.2.0 Alpha - Migration to WXT/Vue

Esta versión establece una nueva línea base para la integración de frameworks y la configuración de compilación.

Qué ha cambiado

• PRs: #20 #24

• Incidencias: #7 #10 #11 #13 #15

• Intercambio de mensajes refactorizado para utilizar el wrapper @webext-core/messaging

• Pruebas refactorizadas y limpiadas

• Refactorizado flujo de traducción del menú contextual

• Registro de cambios completo: v0.1.0-beta...v0.2.0-alpha

Browser AI v0.1.0 Beta - Traducción con IA integrada

Browser AI v0.1.0 Beta - Versión Beta

🚀 Características Principales

• ✅ Traducción instantánea usando las APIs nativas de IA de Chrome
• ✅ 100% Privacidad - Todo el procesamiento se realiza localmente en tu dispositivo
• ✅ Sin costos ni límites - No hay APIs de terceros ni tarifas
• ✅ Funciona offline - No requiere conexión a internet para traducir
• ✅ Interfaz intuitiva - Panel lateral fácil de usar
• ✅ Menú contextual - Traduce texto seleccionado con clic derecho

⚠️ Nota Importante - Versión Beta

Esta es una versión beta que está en desarrollo activo. Algunas características pueden estar incompletas o presentar comportamientos inesperados. Te animamos a probarla y reportar cualquier problema que encuentres.

📋 Requisitos del Sistema

• Chrome 138 o superior (requerido para APIs de IA integradas)
• Sistema operativo: Windows 10/11, macOS 13+ (Ventura), Linux, o ChromeOS
• Dispositivo: Solo escritorio (no funciona en móviles)
• Almacenamiento: Al menos 22 GB de espacio libre en el volumen que contiene tu perfil de Chrome
• Red: Conexión sin límites de datos (para descarga inicial del modelo)

🔧 Instalación

Método 1: Instalación Manual (Recomendado)

1. Descargar: Haz clic en "Assets" y descarga browser-ai-extension-v0.1.0-beta.zip

2. Extraer: Descomprime el archivo ZIP en una carpeta de tu elección

3. Abrir Chrome: Ve a chrome://extensions/

4. Activar modo desarrollador: Activa el interruptor "Modo de desarrollador" en la esquina superior derecha

5. Cargar extensión: Haz clic en "Cargar extensión sin empaquetar" y selecciona la carpeta dist extraída

6. ¡Listo!: La extensión aparecerá en tu barra de herramientas

Método 2: Desde el código fuente

Si prefieres compilar desde el código fuente:

git clone https://github.com/tu-usuario/browser-ai-repo.git
cd browser-ai-repo
npm install
npm run build

Luego sigue los pasos 3-6 del método anterior, seleccionando la carpeta dist generada.

🎯 Cómo Usar

Traducción desde texto seleccionado:

1. Selecciona cualquier texto en una página web
2. Haz clic derecho y selecciona "Traducir con Browser AI"
3. El panel lateral se abrirá automáticamente con la traducción

Traducción manual:

1. Haz clic en el icono de Browser AI en la barra de herramientas
2. Escribe o pega texto en el panel lateral
3. Selecciona idioma destino y haz clic en "Traducir"

🛠️ APIs Utilizadas

• Translator API: Para traducción de texto
• Language Detector API: Para detección automática del idioma

Ambas son APIs nativas de Chrome, garantizando máxima privacidad y rendimiento.

🐛 Reportar Problemas

¿Encontraste un bug o tienes una sugerencia? Por favor:

1. Abre un issue en GitHub
2. Incluye tu versión de Chrome y sistema operativo
3. Describe los pasos para reproducir el problema

📝 Notas de la Versión Beta

Esta versión beta incluye las funcionalidades principales:

• Traducción de texto usando IA local
• Detección automática de idioma
• Interfaz de panel lateral
• Menú contextual para texto seleccionado
• Soporte para múltiples idiomas

Próximas versiones incluirán:

• Corrección de texto y gramática
• Extracción de ideas clave
• Reconocimiento de entidades
• Más opciones de personalización

📄 Licencia

Este proyecto está licenciado bajo la MIT License.

---

¡Gracias por probar Browser AI Beta! 🌟

Tu feedback es invaluable para mejorar la extensión antes del lanzamiento de la versión estable.