Documentos de la guía
Solución de problemas
Qué comprobar primero
- Actualice la aplicación a la última versión. Muchos problemas se han corregido en versiones nuevas. Para las funciones que se usan junto con el teléfono u otro PC, el PC conectado también debe tener la última versión.
- Compruebe el texto exacto del mensaje de error. La aplicación muestra indicaciones distintas según la causa.
Instalación y actualización
Aparece una advertencia de SmartScreen en Windows
La advertencia aparece porque los archivos de instalación de Windows todavía no tienen firma de código Authenticode. Compruebe que el archivo se descargó desde la página oficial de descargas y pulse Más información → Ejecutar de todas formas. Consulte los detalles en Instalación y primer inicio.
La versión Portable no se actualiza sola
Windows Portable no admite la instalación automática desde la aplicación. Descargue el nuevo archivo desde la página de descargas y sustitúyalo. Si necesita actualizaciones automáticas, use la versión Setup.
No se puede conectar con el servidor de actualizaciones
Si la aplicación no puede llegar a la dirección de actualización, abre la página de versiones en el navegador predeterminado. Desde ahí puede descargar el archivo de instalación directamente. Las actualizaciones no requieren cuenta ni token de acceso.
No llegan avisos de actualización
- Si eligió 나중에 (Más tarde), no se le volverá a avisar durante 4 horas en esa ejecución.
- Si eligió 이번 버전 건너뛰기 (Omitir esta versión), esa versión no se le avisará automáticamente.
- Si lo comprueba manualmente con el icono de descarga de la parte superior, también se vuelven a mostrar las versiones pospuestas y omitidas.
La instalación de la actualización falla
El motivo del fallo se muestra en la ventana de actualización y en la ventana de confirmación de reinicio.
- macOS: si se produce un error durante la verificación de la instalación o se supera el tiempo de espera de 120 segundos, puede volver a intentarlo.
- Linux .deb: al instalar debe aparecer una ventana de permisos de administrador. Si no aparece en 3 minutos, la instalación se detiene y se le indica el comando para instalar directamente desde la terminal. Se distingue entre el caso en que canceló la ventana de permisos y el caso en que no se obtuvieron permisos.
- Linux, si la aplicación se inició desde un shell en sandbox: la elevación de privilegios puede quedar bloqueada por la restricción
NoNewPrivs. La aplicación abre la ventana de autenticación con systemd de usuario y, si aun así no funciona, indica cómo instalar consudodesde una terminal fuera de la aplicación.
Conexión con el teléfono y QR
No se puede pulsar «연결 QR 만들기» (Crear QR de conexión)
El QR solo se puede crear después de que el PC se conecte al servidor de retransmisión. En 환경 설정 › 휴대폰 (Preferencias › Teléfono), compruebe que 휴대폰 연결 켜기 (Activar la conexión con el teléfono) está activado y que el estado es conectado.
No se puede activar la conexión con el teléfono
Si el PC no puede usar el almacén seguro del sistema operativo, no se puede activar la conexión con el teléfono. No se guarda en texto plano como alternativa. En Linux, active un keyring como Secret Service y reinicie la aplicación.
Aparece que el QR ha caducado o ya se ha usado
El QR solo es válido durante 5 minutos y solo se puede usar una vez. Cree un QR nuevo en el PC y vuelva a conectarse.
Aparece «연결 시도가 너무 잦습니다» (Demasiados intentos de conexión)
El PC bloquea brevemente (alrededor de 1 minuto), a través del servidor de retransmisión, las conexiones que no superan la autenticación. Espere aproximadamente 1 minuto y vuelva a intentarlo con un QR nuevo.
Aparece «연결이 해제되었습니다» (Se ha cerrado la conexión)
Ocurre cuando se desconectó este teléfono desde el PC o se creó una nueva identidad de escritorio. Cree un QR nuevo en el PC y vuelva a conectarse. Si se conectó con una cuenta de Google, basta con volver a permitirlo en la ventana de aprobación del PC.
Aparece que el PC está apagado
Compruebe que el PC está encendido y que Agent Switchboard se está ejecutando. Cuando el PC se enciende, se vuelve a conectar automáticamente.
La aplicación de Android solo muestra «네트워크 연결을 확인하세요» (Compruebe la conexión de red)
La aplicación de Android firmada con la clave de distribución (0.6.0 o posterior) solo acepta la conexión con cuenta de Google en PC con la versión 0.65.2 o posterior. Actualice la aplicación del PC.
Aparece «Google 계정을 확인하지 못했습니다» (No se pudo verificar la cuenta de Google)
Si el reloj del PC va atrasado, la verificación de la prueba de inicio de sesión de Google puede fallar. En la versión 0.65.3 del PC se corrigió el caso en que el reloj va ligeramente atrasado. Actualice la aplicación del PC y active la sincronización automática de la hora del sistema operativo.
En el PC aparece «Google에 다시 로그인해 주세요» (Vuelva a iniciar sesión en Google)
Ocurre cuando ha caducado el inicio de sesión de Google del PC. Pulse Google 다시 로그인 (Volver a iniciar sesión en Google) en Preferencias › Teléfono. Hasta que vuelva a iniciar sesión, no se pueden aceptar nuevas conexiones de otros dispositivos.
No se puede instalar de nuevo la aplicación de Android
Si antes instaló un APK firmado con otra firma, el nuevo APK no se instalará encima. Desinstale la aplicación anterior, instale el nuevo APK y vuelva a conectar el PC e iniciar sesión con Google.
La lista de PC está vacía después del cambio de dirección de la aplicación web
La aplicación web del teléfono se ofrece en https://app.switchboard.twentyoz.kr. La información de conexión que usaba en la dirección anterior no se traslada a la nueva. Vuelva a conectarse con un QR o, si usaba una cuenta de Google, vuelva a iniciar sesión para cargar la lista de PC.
Claves y autenticación
«저장 후 적용» (Guardar y aplicar) está desactivado (Linux)
En un PC que no puede usar el almacén seguro del sistema operativo (keyring), no se pueden guardar claves de API. El motivo se muestra encima del botón. Active el keyring y reinicie la aplicación.
No se aplica el modelo elegido
Al probar la conexión y al aplicar, se comprueba si el modelo elegido se puede usar realmente. Si no se puede usar, la aplicación se detiene. Vuelva a elegir un modelo disponible de la lista.
La CLI muestra el error «credential is not configured»
Puede ocurrir cuando se inicia la CLI con un perfil de ejecución antiguo después de cambiar la conexión de la carpeta. Vuelva a aplicar esa conexión en la configuración de la herramienta y reinicie la CLI. Si la carpeta tiene configuración de Codex pero ha desaparecido el perfil de conexión de la carpeta, la aplicación vuelve a crear el perfil con la configuración guardada.
Sigue apareciendo «SECURE_STORAGE_BOOTSTRAP_FAILED»
- Compruebe que Agent Switchboard y todos los procesos relacionados se han cerrado.
- Si, por un cierre forzado durante la inicialización, solo ha quedado el archivo de bloqueo
.secure-storage-bootstrap.lock, guarde una copia aparte de ese archivo, elimínelo y vuelva a ejecutar la aplicación. - No elimine ni modifique el archivo
Local Stateni la carpetacredentials. Conserve los originales y póngase en contacto con nosotros.
Aparece que no se pudo confirmar la compatibilidad del esfuerzo de razonamiento
Un esfuerzo de razonamiento cuya compatibilidad no se ha confirmado se envía con el valor predeterminado de la herramienta y se deja un aviso. Si en una versión anterior no podía iniciar una conversación por este mensaje, actualice la aplicación.
En Windows, la ventana de inicio de sesión OAuth solo se abre como una terminal vacía
Era un problema en el que el perfil de inicio de PowerShell del usuario bloqueaba el comando de inicio de sesión. Desde la versión 0.61.2, la ventana de autenticación omite el perfil de inicio. Actualice la aplicación.
Al ponerse en contacto
Al informar de un problema relacionado con la seguridad, no adjunte claves de API, tokens OAuth, archivos de autenticación ni archivos de configuración completos. Envíe solo la dirección de conexión, el sistema operativo, la versión de la aplicación, los pasos para reproducirlo y el texto del error con los valores sensibles ocultos. Las consultas se reciben en hello@twentyoz.kr.