Solución de problemas

Cuando algo falla, KomaLens muestra una tarjeta con el problema, una explicación, un botón que lo resuelve y un consejo. Si despliegas Detalle técnico, verás el mensaje original del navegador o del proveedor: cópialo si nos escribes.

Aquí tienes cada error, en el mismo orden en que suelen aparecer.

No puedo leer esta pestaña

Código: NO_TAB_PERMISSION

Qué significa. El navegador no le dio permiso a KomaLens para capturar la pestaña.

Por qué pasa. Por seguridad, Chrome y Edge solo dejan que una extensión capture la página justo después de pulsar su ícono (permiso activeTab). Si escaneas desde el panel lateral, ese clic no cuenta, y la extensión necesita un permiso para ese sitio. El detalle técnico suele decir Either the '<all_urls>' or 'activeTab' permission is required.

Cómo se arregla.

• Pulsa Permitir en este sitio. El navegador te pedirá acceso solo para ese sitio (por ejemplo, example.com). Al aceptarlo, KomaLens reintenta el escaneo, y la próxima vez no volverá a pedirlo en ese sitio.
• Si prefieres no dar permisos, pulsa el ícono de KomaLens en la barra del navegador y luego Escanear área. Ese clic concede el acceso a la pestaña por esta vez.

Puedes quitar el permiso cuando quieras desde la configuración de extensiones del navegador. Más en Permisos de la extensión.

Falta el paquete de idioma

Código: LANGUAGE_PACK_NEEDED

Qué significa. En modo local, el navegador todavía no tiene el paquete de traducción del par que elegiste (por ejemplo, chino → español).

Por qué pasa. La Translator API descarga cada par de idiomas una sola vez, la primera vez que se necesita.

Cómo se arregla. Pulsa Descargar paquete y espera: puede tardar unos minutos según tu conexión. Después funciona sin internet. También puedes descargarlo desde Ajustes → Paquetes de idioma de Chrome, o pulsar Usar modo Híbrido para traducir ahora con tu proveedor.

Falta tu API key

Código: NO_API_KEY

Qué significa. Elegiste Híbrido o Imagen a la API, pero no hay un proveedor configurado.

Cómo se arregla. Pulsa Configurar API key y completa la URL base, la key y el modelo, como se explica en Configurar un proveedor. Si no quieres usar un proveedor, pulsa Usar modo local: no necesita ninguna clave.

No encontré texto

Código: OCR_EMPTY

Qué significa. El OCR no detectó caracteres en el área seleccionada, o los detectó con muy poca confianza.

Por qué pasa. La selección no incluía texto, era demasiado pequeña, o el texto es muy estilizado, borroso o de poco contraste.

Cómo se arregla.

• Pulsa Escanear de nuevo y selecciona solo el globo o la línea de texto, con un poco de margen.
• Si es una letra dibujada a mano o con efectos, pulsa Enviar la imagen a la API: un modelo con visión suele leerla mejor.
• Comprueba en Ajustes → Idiomas que Leer en coincide con el idioma del texto.

No pude conectar con tu proveedor

Qué significa. En Híbrido o Imagen a la API, el proveedor no respondió o respondió con un error. Siempre puedes pulsar Reintentar o Usar modo local mientras lo resuelves. El detalle técnico muestra el código y el mensaje del proveedor; estos son los casos más comunes:

La API key no es válida

Suele aparecer como error 401. La key está mal copiada, se borró o pertenece a otro proveedor. Crea una nueva en el panel del proveedor, pégala sin espacios al principio ni al final, y comprueba que la URL base sea la de ese proveedor.

Sin crédito

Suele aparecer como error 402 o como un mensaje de saldo insuficiente. Carga crédito en tu cuenta del proveedor o elige un modelo más barato.

El modelo no existe

Suele aparecer como error 404 o «model not found». El identificador del modelo está mal escrito o el proveedor lo retiró. Elige el modelo de la lista en Ajustes → Proveedor de API en lugar de escribirlo a mano.

El modelo no acepta imágenes

Suele aparecer como error 400 que menciona imágenes o contenido no soportado. En Imagen a la API el modelo tiene que tener visión. Elige un modelo con entrada de imagen (lo dice su ficha en la web del proveedor) o cambia a Híbrido, que solo envía texto.

Demasiadas solicitudes

Suele aparecer como error 429. Llegaste al límite de solicitudes de tu plan. Espera un momento y reintenta, o revisa los límites de tu cuenta.

El proveedor no responde

Errores 500, 502, 503 o sin respuesta. Puede ser tu conexión o una caída del proveedor. Revisa tu internet y la página de estado del proveedor, y reintenta en unos minutos.

Error 403 o de CORS con un modelo local

Si usas Ollama, por defecto no acepta solicitudes de extensiones del navegador. Tienes que agregar el origen de KomaLens a OLLAMA_ORIGINS: los pasos para Windows, macOS y Linux están en Modelos locales con Ollama. En LM Studio, activa Enable CORS en los ajustes del servidor.

No diste el permiso para el dominio del proveedor

Al configurar un proveedor, KomaLens pide permiso para conectarse a su dominio. Si lo rechazaste, vuelve a guardar la URL base en Ajustes → Proveedor de API y acepta el permiso.

Tu navegador no es compatible con el modo local

Código: LOCAL_UNSUPPORTED

Qué significa. Tu navegador no incluye la Translator API que usa el modo local.

Cómo se arregla. Actualiza Chrome o Edge a la última versión estable. Si usas otro navegador basado en Chromium, puede que no tenga esa API. Mientras tanto, pulsa Usar modo Híbrido: no depende de la Translator API. Los requisitos están en Modo local.

Esta página no se puede escanear

Código: NO_VALID_TAB

Qué significa. Estás en una página que ninguna extensión puede leer.

Por qué pasa. Los navegadores protegen sus páginas internas (como chrome:// o edge://), la tienda de extensiones y algunas pantallas del sistema. Es una regla del navegador, no de KomaLens.

Cómo se arregla. Pulsa Entendido y escanea en una página normal.

Algo salió mal

Qué significa. Un error que no está en esta lista.

Cómo se arregla. Pulsa Reintentar. Si se repite, abre Detalle técnico, copia el mensaje y escríbenos a poullorca@proton.me o a @PoulLorca en X, contando qué estabas escaneando y en qué modo.