Dépannage

À vérifier en premier

• Mettez l'application à jour vers la dernière version. De nombreux problèmes ont été corrigés dans les nouvelles versions. Pour les fonctionnalités utilisées avec un téléphone ou un autre PC, le PC connecté doit lui aussi être à jour.
• Relevez le message d'erreur exact. L'application affiche des indications différentes selon la cause.

Installation et mises à jour

Windows affiche un avertissement SmartScreen

Cet avertissement apparaît parce que les fichiers d'installation Windows ne sont pas encore signés avec Authenticode. Vérifiez que le fichier provient de la page de téléchargement officielle, puis cliquez sur Informations complémentaires → Exécuter quand même. Pour plus de détails, consultez Installation et premier lancement.

La version Portable ne se met pas à jour toute seule

Windows Portable ne prend pas en charge l'installation automatique depuis l'application. Téléchargez le nouveau fichier sur la page de téléchargement et remplacez l'ancien. Si vous avez besoin des mises à jour automatiques, utilisez la version Setup.

Impossible de joindre le serveur de mises à jour

Si l'application ne parvient pas à joindre l'adresse de mise à jour, elle ouvre la page des versions dans le navigateur par défaut. Vous pouvez y télécharger directement le fichier d'installation. Les mises à jour ne nécessitent ni compte ni jeton d'accès.

Aucune notification de mise à jour

• Si vous avez choisi 「나중에」 (Plus tard), aucun rappel n'est affiché pendant 4 heures au cours de cette session.
• Si vous avez choisi 「이번 버전 건너뛰기」 (Ignorer cette version), cette version n'est plus signalée automatiquement.
• Une vérification manuelle avec l'icône de téléchargement en haut de la fenêtre réaffiche les versions reportées et ignorées.

L'installation de la mise à jour échoue

La raison de l'échec s'affiche dans la fenêtre de mise à jour et dans la fenêtre de confirmation du redémarrage.

• macOS : en cas d'erreur pendant la vérification de l'installation ou de dépassement du délai de 120 secondes, vous pouvez réessayer.
• Linux .deb : une fenêtre de privilèges administrateur doit s'ouvrir pendant l'installation. Si elle n'apparaît pas dans les 3 minutes, l'installation est interrompue et l'application indique la commande pour installer manuellement depuis un terminal. L'application distingue l'annulation dans la fenêtre de privilèges du cas où les privilèges n'ont pas pu être obtenus.
• Linux, application lancée depuis un shell en bac à sable : l'élévation de privilèges peut être bloquée par la restriction NoNewPrivs. L'application ouvre alors la fenêtre d'authentification via systemd utilisateur et, si cela ne fonctionne toujours pas, explique comment installer avec sudo depuis un terminal extérieur à l'application.

Connexion du téléphone et QR code

Impossible de cliquer sur 「연결 QR 만들기」 (Créer un QR code de connexion)

Le QR code ne peut être créé qu'une fois le PC connecté au serveur relais. Vérifiez dans 「환경 설정 › 휴대폰」 (Préférences › Téléphone) que 「휴대폰 연결 켜기」 (Activer la connexion du téléphone) est activé et que l'état indique « connecté ».

Impossible d'activer la connexion du téléphone

Si le PC ne peut pas utiliser le stockage sécurisé du système d'exploitation, la connexion du téléphone ne peut pas être activée. Aucune donnée n'est enregistrée en clair à la place. Sous Linux, activez un keyring tel que Secret Service puis redémarrez l'application.

Le QR code est indiqué comme expiré ou déjà utilisé

Un QR code n'est valable que 5 minutes et ne peut servir qu'une seule fois. Créez un nouveau QR code sur le PC et reconnectez-vous.

Le message 「연결 시도가 너무 잦습니다」 (Trop de tentatives de connexion) s'affiche

Les connexions dont l'authentification a échoué sont bloquées temporairement (environ 1 minute) par le PC, via le serveur relais. Attendez environ une minute, puis réessayez avec un nouveau QR code.

Le message 「연결이 해제되었습니다」 (La connexion a été supprimée) s'affiche

Le PC a déconnecté ce téléphone, ou l'identité du bureau a été recréée. Créez un nouveau QR code sur le PC et reconnectez-vous. Si vous vous étiez connecté avec un compte Google, il suffit d'autoriser à nouveau l'appareil dans la fenêtre d'approbation du PC.

Le PC est indiqué comme éteint

Vérifiez que le PC est allumé et qu'Agent Switchboard est en cours d'exécution. La connexion se rétablit automatiquement lorsque le PC est allumé.

L'application Android affiche uniquement 「네트워크 연결을 확인하세요」 (Vérifiez votre connexion réseau)

L'application Android signée avec la clé de distribution (0.6.0 ou ultérieure) n'accepte la connexion par compte Google qu'avec un PC en version 0.65.2 ou ultérieure. Mettez à jour l'application sur le PC.

Le message 「Google 계정을 확인하지 못했습니다」 (Impossible de vérifier le compte Google) s'affiche

Si l'horloge du PC retarde, la vérification de la preuve de connexion Google peut échouer. La version 0.65.3 du PC corrige le cas d'une horloge légèrement en retard. Mettez à jour l'application sur le PC et activez la synchronisation automatique de l'heure du système d'exploitation.

Le PC affiche 「Google에 다시 로그인해 주세요」 (Reconnectez-vous à Google)

La connexion Google du PC a expiré. Cliquez sur 「Google 다시 로그인」 (Se reconnecter à Google) dans Préférences › Téléphone. Tant que vous ne vous êtes pas reconnecté, les nouvelles connexions d'autres appareils ne peuvent pas être acceptées.

Impossible d'installer à nouveau l'application Android

Si vous aviez installé un APK signé avec une autre signature, le nouvel APK ne peut pas s'installer par-dessus. Désinstallez l'ancienne application, installez le nouvel APK, puis refaites la connexion au PC et la connexion Google.

La liste des PC est vide après le changement d'adresse de l'application web

L'application web mobile est servie à l'adresse https://app.switchboard.twentyoz.kr. Les informations de connexion utilisées avec l'ancienne adresse ne sont pas transférées vers la nouvelle. Reconnectez-vous par QR code ou, si vous utilisiez un compte Google, reconnectez-vous pour charger la liste des PC.

Clés et authentification

「저장 후 적용」 (Enregistrer et appliquer) est désactivé (Linux)

Sur un PC qui ne peut pas utiliser le stockage sécurisé du système d'exploitation (keyring), les clés API ne peuvent pas être enregistrées. La raison s'affiche au-dessus du bouton. Activez un keyring puis redémarrez l'application.

Le modèle choisi n'est pas appliqué

Lors du test de connexion et de l'application, l'application vérifie que le modèle choisi est réellement utilisable. S'il ne l'est pas, l'application des paramètres est interrompue. Choisissez à nouveau un modèle disponible dans la liste.

Le CLI renvoie l'erreur « credential is not configured »

Cette erreur peut survenir lorsqu'un CLI est lancé avec un ancien profil d'exécution après un changement de la connexion du dossier. Réappliquez la connexion concernée dans la configuration de l'outil, puis relancez le CLI. Si le dossier contient des paramètres Codex mais que le profil de connexion du dossier a disparu, l'application recrée le profil à partir des paramètres enregistrés.

L'erreur « SECURE_STORAGE_BOOTSTRAP_FAILED » persiste

1. Vérifiez qu'Agent Switchboard et tous les processus associés sont arrêtés.
2. Si seul le fichier de verrou .secure-storage-bootstrap.lock est resté à la suite d'un arrêt forcé pendant l'initialisation, mettez ce fichier de côté, supprimez-le, puis relancez l'application.
3. Ne supprimez ni ne modifiez le fichier Local State ou le dossier credentials. Conservez les originaux en l'état et contactez-nous.

Un message indique que la prise en charge du niveau de raisonnement n'a pas pu être vérifiée

Un niveau de raisonnement dont la prise en charge n'est pas confirmée est remplacé par la valeur par défaut de l'outil, et un message l'indique. Si, dans une version précédente, ce message empêchait de démarrer une conversation, mettez l'application à jour.

Sous Windows, la fenêtre de connexion OAuth s'ouvre sur un terminal vide

Le profil de démarrage PowerShell de l'utilisateur bloquait la commande de connexion. Depuis la version 0.61.2, la fenêtre d'authentification ignore le profil de démarrage. Mettez l'application à jour.

Pour nous contacter

Pour signaler un problème de sécurité, ne joignez pas de clé API, de jeton OAuth, de fichier d'authentification ni de fichier de configuration complet. Envoyez uniquement l'adresse de connexion, le système d'exploitation, la version de l'application, les étapes de reproduction et le message d'erreur en masquant les valeurs sensibles. Les demandes sont reçues à hello@twentyoz.kr.