Fehlerbehebung

Die Benutzeroberfläche der Apps ist derzeit nur auf Koreanisch verfügbar. Bezeichnungen und Meldungen aus der App stehen beim ersten Vorkommen auf Koreanisch mit deutscher Übersetzung in Klammern, danach nur auf Deutsch.

Zuerst prüfen

• Aktualisieren Sie die App auf die neueste Version. Viele Probleme sind in neuen Versionen behoben. Für Funktionen, die mit dem Smartphone oder anderen PCs zusammenarbeiten, muss auch der verbundene PC auf dem neuesten Stand sein.
• Lesen Sie die Fehlermeldung genau. Die App zeigt je nach Ursache unterschiedliche Hinweise an.

Installation und Updates

Unter Windows erscheint eine SmartScreen-Warnung

Die Warnung entsteht, weil die Windows-Installationsdateien noch keine Authenticode-Codesignatur haben. Prüfen Sie, ob Sie die Datei von der offiziellen Download-Seite heruntergeladen haben, und klicken Sie dann auf Weitere Informationen → Trotzdem ausführen. Einzelheiten finden Sie unter Installation und erster Start.

Die Portable-Version aktualisiert sich nicht selbst

Windows Portable unterstützt keine automatische Installation in der App. Laden Sie die neue Datei von der Download-Seite herunter und ersetzen Sie die alte. Wenn Sie automatische Updates brauchen, verwenden Sie die Setup-Version.

Keine Verbindung zum Update-Server

Erreicht die App die Update-Adresse nicht, öffnet sie die Release-Seite im Standardbrowser. Dort können Sie die Installationsdatei direkt herunterladen. Für Updates ist kein Konto und kein Zugriffstoken nötig.

Es kommen keine Update-Benachrichtigungen

• Wenn Sie 나중에 (Später) gewählt haben, werden Sie während dieser Sitzung 4 Stunden lang nicht erneut benachrichtigt.
• Wenn Sie 이번 버전 건너뛰기 (Diese Version überspringen) gewählt haben, werden Sie über diese Version nicht automatisch benachrichtigt.
• Wenn Sie über das Download-Symbol oben selbst prüfen, werden auch zurückgestellte und übersprungene Versionen wieder angezeigt.

Die Installation eines Updates schlägt fehl

Der Grund wird im Update-Fenster und im Bestätigungsfenster für den Neustart angezeigt.

• macOS: Bei einem Fehler während der Installationsprüfung oder einer Zeitüberschreitung von 120 Sekunden können Sie es erneut versuchen.
• Linux .deb: Bei der Installation muss ein Fenster zur Eingabe von Administratorrechten erscheinen. Erscheint es nicht innerhalb von 3 Minuten, wird die Installation abgebrochen und ein Befehl für die direkte Installation im Terminal angezeigt. Ob Sie im Rechtefenster abgebrochen haben oder keine Rechte erteilt wurden, wird getrennt erklärt.
• Linux, App aus einer Sandbox-Shell gestartet: Wegen der NoNewPrivs-Beschränkung kann die Rechteerhöhung blockiert sein. Die App öffnet das Authentifizierungsfenster über systemd des Benutzers. Funktioniert das nicht, erklärt sie, wie Sie in einem Terminal außerhalb der App mit sudo installieren.

Smartphone-Verbindung und QR-Code

„연결 QR 만들기“ (Verbindungs-QR erstellen) lässt sich nicht anklicken

Ein QR-Code lässt sich erst erstellen, wenn der PC mit dem Relay-Server verbunden ist. Prüfen Sie unter 환경 설정 › 휴대폰 (Einstellungen › Smartphone), ob 휴대폰 연결 켜기 (Smartphone-Verbindung aktivieren) eingeschaltet ist und der Status „verbunden“ lautet.

Die Smartphone-Verbindung lässt sich nicht aktivieren

Kann der PC den sicheren Speicher des Betriebssystems nicht nutzen, lässt sich die Smartphone-Verbindung nicht aktivieren. Ersatzweise im Klartext gespeichert wird nicht. Unter Linux aktivieren Sie einen Keyring wie Secret Service und starten die App neu.

Der QR-Code sei abgelaufen oder bereits verwendet

Ein QR-Code ist nur 5 Minuten gültig und kann nur einmal verwendet werden. Erstellen Sie am PC einen neuen QR-Code und verbinden Sie sich erneut.

„연결 시도가 너무 잦습니다“ (Zu viele Verbindungsversuche) erscheint

Verbindungen mit fehlgeschlagener Authentifizierung sperrt der PC über den Relay-Server kurzzeitig (etwa 1 Minute). Warten Sie etwa eine Minute und versuchen Sie es mit einem neuen QR-Code erneut.

„연결이 해제되었습니다“ (Die Verbindung wurde getrennt) erscheint

Der PC hat die Verbindung zu diesem Smartphone getrennt oder die Desktop-Identität neu erstellt. Erstellen Sie am PC einen neuen QR-Code und verbinden Sie sich erneut. Wenn Sie über ein Google-Konto verbunden waren, genügt es, die Verbindung im Freigabefenster des PCs erneut zuzulassen.

Der PC wird als ausgeschaltet angezeigt

Prüfen Sie, ob der PC eingeschaltet ist und Agent Switchboard läuft. Sobald der PC eingeschaltet ist, wird die Verbindung automatisch wiederhergestellt.

Die Android-App zeigt nur „네트워크 연결을 확인하세요“ (Prüfen Sie die Netzwerkverbindung)

Mit dem Release-Schlüssel signierte Android-Apps (ab 0.6.0) werden für die Google-Konto-Verbindung nur von PCs ab Version 0.65.2 angenommen. Aktualisieren Sie die PC-App.

„Google 계정을 확인하지 못했습니다“ (Das Google-Konto konnte nicht bestätigt werden) erscheint

Geht die Uhr des PCs nach, kann die Prüfung des Google-Anmeldenachweises fehlschlagen. In PC-Version 0.65.3 wurde der Fall einer leicht nachgehenden Uhr behoben. Aktualisieren Sie die PC-App und aktivieren Sie die automatische Zeitsynchronisierung des Betriebssystems.

Am PC erscheint „Google에 다시 로그인해 주세요“ (Bitte melden Sie sich erneut bei Google an)

Die Google-Anmeldung des PCs ist abgelaufen. Klicken Sie unter Einstellungen › Smartphone auf Google 다시 로그인 (Erneut bei Google anmelden). Bis zur erneuten Anmeldung können keine neuen Verbindungen anderer Geräte angenommen werden.

Die Android-App lässt sich nicht neu installieren

Wenn Sie früher ein APK mit einer anderen Signatur installiert haben, lässt sich das neue APK nicht darüber installieren. Deinstallieren Sie die bisherige App, installieren Sie das neue APK und stellen Sie die PC-Verbindung und die Google-Anmeldung erneut her.

Nach der Änderung der Web-App-Adresse ist die PC-Liste leer

Die Smartphone-Web-App wird unter https://app.switchboard.twentyoz.kr bereitgestellt. Verbindungsdaten der früheren Adresse werden nicht auf die neue Adresse übertragen. Verbinden Sie sich erneut per QR-Code oder melden Sie sich, falls Sie ein Google-Konto verwendet haben, erneut an, um die PC-Liste zu laden.

Schlüssel und Authentifizierung

„저장 후 적용“ (Speichern und anwenden) ist deaktiviert (Linux)

Auf PCs, die den sicheren Speicher des Betriebssystems (Keyring) nicht nutzen können, lassen sich keine API-Schlüssel speichern. Der Grund wird über der Schaltfläche angezeigt. Aktivieren Sie den Keyring und starten Sie die App neu.

Das gewählte Modell wird nicht angewendet

Beim Verbindungstest und beim Anwenden wird geprüft, ob das gewählte Modell tatsächlich nutzbar ist. Ist es nicht nutzbar, wird die Anwendung abgebrochen. Wählen Sie ein verfügbares Modell aus der Liste.

Die CLI meldet den Fehler „credential is not configured“

Dies kann auftreten, wenn nach einer Änderung der Ordnerverbindung eine CLI mit einem veralteten Startprofil gestartet wurde. Wenden Sie die betreffende Verbindung in den Tool-Einstellungen erneut an und starten Sie die CLI neu. Sind im Ordner Codex-Einstellungen vorhanden, fehlt aber das Verbindungsprofil des Ordners, erstellt die App das Profil aus den gespeicherten Einstellungen neu.

„SECURE_STORAGE_BOOTSTRAP_FAILED“ erscheint wiederholt

1. Prüfen Sie, ob Agent Switchboard und alle zugehörigen Prozesse beendet sind.
2. Ist nach einem erzwungenen Beenden während der Initialisierung nur die Sperrdatei .secure-storage-bootstrap.lock übrig geblieben, sichern Sie diese Datei separat, löschen Sie sie und starten Sie erneut.
3. Löschen oder ändern Sie weder die Datei Local State noch den Ordner credentials. Bewahren Sie die Originale auf und wenden Sie sich an uns.

Die Unterstützung des Reasoning-Aufwands konnte nicht bestätigt werden

Ein Reasoning-Aufwand, dessen Unterstützung nicht bestätigt ist, wird als Standardwert des Tools gesendet und ein Hinweis hinterlassen. Wenn Sie in einer früheren Version wegen dieser Meldung keinen Chat beginnen konnten, aktualisieren Sie die App.

Unter Windows öffnet sich das OAuth-Anmeldefenster nur als leeres Terminal

Das PowerShell-Startprofil des Benutzers hat den Anmeldebefehl blockiert. Ab 0.61.2 überspringt das Authentifizierungsfenster das Startprofil. Aktualisieren Sie die App.

Wenn Sie uns kontaktieren

Wenn Sie ein Sicherheitsproblem melden, hängen Sie keine API-Schlüssel, OAuth-Tokens, Authentifizierungsdateien oder vollständigen Konfigurationsdateien an. Senden Sie nur Verbindungsadresse, Betriebssystem, App-Version, Schritte zur Reproduktion und die Fehlermeldung mit unkenntlich gemachten sensiblen Werten. Anfragen nehmen wir unter hello@twentyoz.kr entgegen.