Solución de problemas

Aparece una advertencia de editor al instalar

Las builds beta están sin firma de código, por lo que la advertencia de SmartScreen/Defender se muestra de forma normal. Si sigues la “Guía de primera ejecución” de la página de descarga y permites una sola vez, después no vuelve a aparecer. Como el instalador es grande, el primer escaneo puede tardar — si la ventana no aparece de inmediato, espera un momento y vuelve a ejecutarlo.

Pantalla remota VNC

Cómo conectar

Menú de pestaña nueva → Conexión VNC… o una conexión guardada. Campos de entrada:

Campo	Valor predeterminado	Descripción
Host	—	IP o dominio del servidor VNC
Puerto	5900	Puerto predeterminado de VNC
Contraseña	—	Contraseña de autenticación VNC
Nombre para guardar	—	Si lo introduces, se registra en las conexiones guardadas

Acceso a VNC de red interna por túnel SSH

Si activas la opción Túnel SSH del diálogo de conexión, puedes acceder a un VNC de red interna a través de un servidor bastion. No tienes que abrir directamente el puerto 5900 desde fuera del firewall.

Botones de cabecera

Botón	Acción
Enviar al portapapeles	Envía el portapapeles local al remoto
`Ctrl+Alt+Del`	Envía Ctrl+Alt+Del al PC remoto
📁 FT	Alterna el panel de transferencia de archivos

Atajos del portapapeles

Ctrl+Shift+V — solo envía el portapapeles local al remoto (sin enviar la tecla de pegar)
Ctrl+V — envía + envía también la tecla de pegar al remoto

Transferencia de archivos (TightVNC 2.x FT)

Funciones del panel de transferencia de archivos:

Función	Método
Explorar carpetas	Clic en la lista, ↑ carpeta superior
Actualizar	Botón ↻
Carpeta nueva	Botón ➕
Subir	Botón ⬆ (selección de varios archivos posible)
Descargar	Doble clic / clic derecho / seleccionar con casilla y descargar
Renombrar / eliminar	Menú contextual

Al subir un archivo con el mismo nombre, se muestra un mensaje de confirmación de sobrescritura.

Si los nombres de archivo se corrompen, cambia el desplegable de codificación de la parte superior del panel (UTF-8 por defecto). Al cambiarlo se reconecta automáticamente.

Solución de problemas de VNC

Síntoma	Causa	Acción
Fallo de conexión	Error de host·puerto·contraseña	Revisar los datos de conexión, comprobar si el VNC del servidor está en ejecución
No se puede acceder a la red interna	Bloqueo del firewall	Activar la opción de túnel SSH
El panel de transferencia de archivos no existe o da error	Servidor que no es TightVNC 2.x	Cambiar a un servidor TightVNC 2.x
Nombres de archivo corruptos	Codificación del servidor no coincidente	Seleccionar la codificación del servidor en el desplegable de codificación (ej.: EUC-KR)
Se ve la pantalla pero el portapapeles no funciona	Portapapeles del servidor desactivado	Activar la compartición del portapapeles en la configuración del servidor VNC

WinRM — PowerShell de Windows remoto

Cómo conectar

Menú de pestaña nueva → WinRM (Windows remoto)…. Campos de entrada:

Campo	Valor predeterminado	Descripción
Host	—	IP o dominio del PC Windows remoto
Usuario	—	Cuenta local o de dominio de Windows
Contraseña	—	Contraseña de la cuenta
Puerto	5985 (HTTP) / 5986 (HTTPS)	Se elige con el toggle de uso de HTTPS
Usar HTTPS	Desactivado	Si lo activas 5986, si lo desactivas 5985
Nombre para guardar	—	Si lo introduces, se registra en las conexiones guardadas

Requisitos previos del PC remoto

En el PC remoto, abre PowerShell como administrador y ejecuta el comando siguiente:

Enable-PSRemoting -Force

En el caso de grupo de trabajo o acceso directo por IP (no entorno de dominio), hay que configurar TrustedHosts en el PC cliente. Si haces clic en el botón “Añadir confianza a este host” del diálogo de conexión, se gestiona automáticamente.

Para configurarlo manualmente:

# Ejecutar en PowerShell como administrador
Set-Item WSMan:\localhost\Client\TrustedHosts -Value "IPoNombreDeHostDestino" -Force

Cómo funciona y limitaciones

Escribes comandos de PowerShell en la consola y los ejecutas con Enter.
Con las teclas ↑ / ↓ puedes navegar por el historial de comandos.
Es un método imperativo que establece una conexión nueva en cada comando (el estado de la sesión no se mantiene).
No admite prompts interactivos como Read-Host.

Solución de problemas de WinRM

Síntoma	Causa	Acción
Error “Acceso denegado”	Permisos de cuenta insuficientes	Usar una cuenta de administrador o añadir al grupo de gestión remota permitido
No conecta (grupo de trabajo)	TrustedHosts sin configurar	Clic en “Añadir confianza a este host” en el diálogo
No conecta (firewall)	Puerto 5985/5986 bloqueado	Permitir el puerto WinRM en el firewall del PC remoto
No hay servicio WinRM	PSRemoting sin activar	Ejecutar `Enable-PSRemoting -Force` en el PC remoto
Error de certificado HTTPS	Certificado autofirmado	Conectar por HTTP (5985) o configurar la confianza del certificado
No hay WinRM en el menú	Se está ejecutando en macOS	Función exclusiva de Windows, usar en un PC con Windows

Captura de escritorio

Captura de área de pantalla (📷)

Al hacer clic en el botón 📷 de la barra de pestañas, una superposición transparente cubre la pantalla.

Arrastra con el ratón para seleccionar el área a capturar (incluye monitores externos).
La imagen capturada se abre en el editor de marcado — puedes anotar con flechas·texto·rotulador.
Al hacer clic en el botón “Enviar a la IA”, la imagen se adjunta al Chat con IA abierto.

Espejo de escritorio (streaming en vivo)

Menú de pestaña nueva → 🖥️ Captura de escritorio… → al seleccionar una app de la lista de ventanas, esa ventana se transmite en vivo en el panel (solo visualización).

La IA puede ver la pantalla del espejo con la herramienta panel_screenshot.
El panel de vista previa web se puede capturar con el botón ✏️ y enviar a la IA.

Solución de problemas general

Cuando la app se cuelga·la pantalla se pone en blanco

Síntoma	Causa	Acción
La pantalla se pone en blanco y se recarga sola	Crash del proceso renderizador	Se recupera automáticamente — comportamiento normal
Crash repetido 3 o más veces en 30 segundos	Problema de driver de GPU o de memoria	Actualizar el driver de GPU y volver a ejecutar
Pantalla en blanco persistente aunque recargue	Error grave del renderizador	Comprobar `crash.log` y contactar

Ubicación del log de crash: %APPDATA%\Blyck\crash.log

Si se produce un crash:

Abre crash.log para ver el último error.
Abre las herramientas de desarrollador con F12 y comprueba los errores en la pestaña de consola.
Si no se resuelve, adjunta crash.log y logs\blyck.log en la página de contacto.

Bloqueos·retraso en la entrada de teclas

Síntoma	Causa	Acción
Bloqueo de 5~10 s y recuperación automática	Bloqueo del hilo principal durante reindexación RAG o inicialización de LSP	Esperar un momento
Bloqueos repetidos	Contención de recursos	Adjuntar `blyck.log` y contactar
Bloqueo largo durante una tarea de IA	Backstop de turno (60 min) o gestión de 2 min sin respuesta	Forzar la interrupción con el botón ■ Detener

Sobre las actualizaciones

Blyck comprueba actualizaciones en update.blyck.dev al iniciar la app y cada 4 horas. Las versiones nuevas se descargan en segundo plano y se instalan automáticamente al cerrar la app.

Síntoma	Causa	Acción
La actualización no se aplica	La app no se cerró por completo	Cerrar por completo incluido el icono de la bandeja y volver a ejecutar
Fallo de descarga	La red de la empresa bloquea el CDN	Pedir al equipo de TI que permita `update.blyck.dev` o instalar manualmente
No comprueba actualizaciones	Entorno sin conexión	Conectar a internet y reiniciar

Sobre la licencia

Síntoma	Causa	Acción
Se muestra el bloqueo a pantalla completa	Finalizó la prueba de 14 días	Pegar la clave de licencia para activar
”La suscripción ha caducado”	Suscripción caducada o cancelada	Comprobar el estado de la suscripción en el portal de Lemon Squeezy
Fallo de activación	Estado sin conexión	Reintentar tras conectar a la red
”Registrado en otro dispositivo”	Registro de dispositivos superado	Gestionar dispositivos en el portal de Lemon Squeezy
Bloqueo tras pasar 7 días desde la activación	Período de gracia sin conexión superado	Revalidar conectando a internet y reiniciando la app

Sobre la conexión de BD

Síntoma	Causa	Acción
Timeout de conexión	Bloqueo de red·firewall	Comprobar host·puerto·reglas del firewall. PG/MySQL 10 s, MSSQL 15 s
Oracle `ORA-xxxxx`	Error del lado del servidor (nombre de servicio·cuenta bloqueada, etc.)	Revisar los datos de conexión del servidor
Oracle `NJS-116`	Entorno sin soporte de modo Thin	Marcar Forzar Thick + configurar la ruta del Instant Client de 64 bits
Oracle `NJS-118`	Error de inicialización de Thick	Reintentar tras reiniciar la app
MySQL muestra BIGINT como cadena	Protección de precisión por encima de 2^53	Comportamiento normal — no es un bug
Explosión de sesiones del pool de conexiones	—	Gestionado automáticamente por el pool (máximo 4), sin problema

Para problemas detallados de BD, consulta la página del Cliente de BD.

Sobre la vista previa web

Síntoma	Causa	Acción
La página no carga	Servidor de desarrollo sin ejecutar	Ejecutar primero el servidor de desarrollo local e introducir la URL
`preview_eval` falla de inmediato	La página aún se está cargando	Reintentar tras la herramienta `preview_wait`
La pantalla se queda en blanco	Error de URL o error del servidor	Comprobar la URL y el estado del servidor

Para más detalles consulta la página de Run & Preview.

Sobre la búsqueda RAG

Síntoma	Causa	Acción
No hay resultados o muestra archivos antiguos	Índice sin actualizar	Configuración del chat → comprobar el estado del índice RAG
Aparecen archivos eliminados en la búsqueda	Elementos huérfanos	Ejecutar la herramienta de limpieza Orphan Scan
Resultados con demasiado ruido	Indexación de archivos innecesarios	Añadir patrones de exclusión con `.termeditignore`
Resultados extraños tras cambiar el modelo de embeddings	Reindexación en curso	Esperar a que se complete la reindexación

Para la gestión del índice RAG, consulta la página de Búsqueda RAG.

Sobre la conexión SSH

Síntoma	Causa	Acción
Se queda en la entrada de contraseña	Prompt no estándar (espera de detección hasta 30 s)	Introducir directamente o usar contraseña guardada
Fallo de reconexión automática	Servidor solo de contraseña (la reconexión no reutiliza la contraseña)	Configurar autenticación por clave/agent o reconectar manualmente
Solo falla el SFTP	Subsistema SFTP desactivado	Volver a conectar manualmente desde el panel de archivos
Coreano corrupto	Configuración regional del servidor	Comprobar `*.UTF-8` con `locale` del servidor

Para más detalles consulta la página de Terminal · SSH · SFTP.

Sobre las funciones de IA

Síntoma	Causa	Acción
Chat con IA desactivado	CLI sin instalar o sin iniciar sesión	Instalar·iniciar sesión en la CLI desde el asistente de preparación
Error 401/403	Clave de API caducada o incorrecta	Volver a registrar la clave o reejecutar `claude login`
No llega respuesta / se detiene	Red o autenticación caducada	Tras 3 reintentos automáticos, volver a iniciar sesión e iniciar un chat nuevo
Archivos cambiados sin tarjeta de aprobación	Modo 🚀 Automático activado	Cambiar al modo ⚡ Ejecutar+revisar con `Ctrl+3`

Para más detalles consulta la página del Chat con IA.

Sobre el autocompletado LSP

Síntoma	Causa	Acción
El autocompletado de Python no funciona	Pyright sin instalar	Aprobar el modal “¿Descargar?” al abrir el primer archivo Python
El autocompletado de Go no funciona	Sin toolchain de Go	Tras instalar Go, `go install golang.org/x/tools/gopls@latest`
El autocompletado de Rust no funciona	Fallo de descarga de rust-analyzer	Reiniciar la app en un entorno con acceso a GitHub o instalar manualmente y registrar en PATH
Fallo de descarga en la red de la empresa	GitHub bloqueado	Instalar directamente ese servidor y registrarlo en PATH

Sobre la visualización del terminal

Síntoma	Causa	Acción
Texto borroso	Fallback de WebGL (Canvas/DOM)	Especificar explícitamente el renderizador Canvas en la configuración
Alineación de caracteres de ancho completo rota	Renderizador DOM en uso	Especificar el renderizador Canvas en la configuración
Coreano corrupto (local)	—	Windows aplica UTF-8 automáticamente; los exe nativos como `ipconfig` se sustituyen por cmdlets de PowerShell

Quiero revertir un cambio incorrecto

Al abrir el historial de cambios con Ctrl+Shift+H, todos los cambios de archivos·BD·SSH están registrados. Selecciona un elemento y haz la reversión. Como en DML los datos se respaldan automáticamente justo antes de ejecutar, también puedes restaurar un UPDATE sin WHERE.

Para el comportamiento detallado, consulta la página de Git · ChangeSet.

Ubicación de logs·datos (Windows)

Elemento	Ubicación
Log de la app	`%APPDATA%\Blyck\logs\blyck.log` (rotación de 2 MB)
Log de crash	`%APPDATA%\Blyck\crash.log`
Datos de conexión (sin contraseñas)	`%APPDATA%\Blyck\connections.json`
Diseño (pestañas·división)	`%APPDATA%\Blyck\layout.json`
Registro del Chat con IA	`%APPDATA%\Blyck\chats\`
Historial de cambios (ChangeSet)	`%APPDATA%\Blyck\blyck-history.db`
Índice RAG	Archivo SQLite por espacio de trabajo

Las contraseñas y tokens no se guardan en archivos, sino cifrados en el almacén de credenciales del SO. En los logs se enmascaran automáticamente las contraseñas·tokens·claves de API·rutas de usuario, y se guardan solo en local sin transmitirse al exterior.

Otros problemas

Los problemas que no se resuelvan, envíalos a la página de contacto. Si incluyes la información del entorno (SO·versión) y los pasos de reproducción, podremos ayudarte más rápido. Los servidores auxiliares que Blyck abre internamente (MCP·proxy VNC, etc.) se abren todos solo con puerto dinámico en localhost + autenticación por token, por lo que no necesitan excepciones de firewall ni apertura de puertos.