Problembehebung

Bei der Installation erscheint eine Herausgeber-Warnung

Bei Beta-Builds vor der Code-Signierung wird eine SmartScreen-/Defender-Warnung normalerweise angezeigt. Folgst du dem „Hinweis zum ersten Start” auf der Download-Seite und erlaubst es einmalig, wird sie danach nicht mehr angezeigt. Da die Installationsdatei groß ist, kann die erste Prüfung etwas dauern — erscheint das Fenster nicht sofort, warte einen Moment und führe es erneut aus.

---

VNC-Remote-Bildschirm

Verbindungsmethode

Neue-Registerkarte-Menü → VNC-Verbindung… oder gespeicherte Verbindung. Eingabefelder:

Feld	Standardwert	Beschreibung
Host	—	IP oder Domain des VNC-Servers
Port	5900	VNC-Standardport
Passwort	—	VNC-Authentifizierungspasswort
Speichername	—	Bei Eingabe in gespeicherten Verbindungen registriert

Zugriff auf internes VNC per SSH-Tunnel

Aktivierst du im Verbindungsdialog die Option SSH-Tunnel, kannst du über einen Bastion-Server auf internes VNC zugreifen. Du musst von außerhalb der Firewall nicht direkt Port 5900 öffnen.

Header-Buttons

Button	Aktion
Zwischenablage senden	Lokale Zwischenablage an Remote senden
Ctrl+Alt+Del	Ctrl+Alt+Del an Remote-PC senden
📁 FT	Dateiübertragungs-Panel umschalten

Zwischenablage-Tastenkürzel

• Ctrl+Shift+V — nur die lokale Zwischenablage an Remote senden (kein Senden der Einfügetaste)
• Ctrl+V — Senden + auch die Einfügetaste an Remote senden

Dateiübertragung (TightVNC 2.x FT)

Achtung

Die Dateiübertragung funktioniert nur mit TightVNC-2.x-Servern. UltraVNC · ältere TightVNC-Versionen werden wegen abweichendem Wire-Format nicht unterstützt.

Funktionen des Dateiübertragungs-Panels:

Funktion	Methode
Ordner durchsuchen	Liste anklicken, ↑ übergeordneter Ordner
Aktualisieren	↻-Button
Neuer Ordner	➕-Button
Upload	⬆-Button (Mehrfachauswahl möglich)
Download	Doppelklick / Rechtsklick / nach Checkbox-Auswahl herunterladen
Umbenennen / Löschen	Rechtsklick-Menü

Beim Hochladen einer Datei mit gleichem Namen wird eine Überschreiben-Bestätigungsmeldung angezeigt.

Zerbrechen Dateinamen, ändere das Kodierungs-Dropdown oben im Panel (Standard UTF-8). Bei einer Änderung wird automatisch neu verbunden.

VNC-Problembehebung

Symptom	Ursache	Maßnahme
Verbindung schlägt fehl	Fehler bei Host · Port · Passwort	Verbindungsdaten erneut prüfen, prüfen ob VNC am Server läuft
Kein Zugriff auf internes Netz	Firewall blockiert	SSH-Tunnel-Option aktivieren
Dateiübertragungs-Panel fehlt oder Fehler	Server ist nicht TightVNC 2.x	Auf TightVNC-2.x-Server umstellen
Dateiname zerbrochen	Server-Kodierungs-Mismatch	Server-Kodierung im Kodierungs-Dropdown wählen (z. B. EUC-KR)
Bildschirm sichtbar, aber Zwischenablage geht nicht	Server-Zwischenablage deaktiviert	Zwischenablage-Freigabe in den VNC-Server-Einstellungen aktivieren

---

WinRM — Remote-Windows-PowerShell

Hinweis

WinRM wird nur unterstützt, wenn Blyck unter Windows läuft.

Verbindungsmethode

Neue-Registerkarte-Menü → WinRM (Remote-Windows)…. Eingabefelder:

Feld	Standardwert	Beschreibung
Host	—	IP oder Domain des Remote-Windows-PCs
Benutzer	—	Lokales Windows- oder Domänenkonto
Passwort	—	Kontopasswort
Port	5985 (HTTP) / 5986 (HTTPS)	Auswahl per HTTPS-Verwenden-Toggle
HTTPS verwenden	aus	aktiviert 5986, deaktiviert 5985
Speichername	—	Bei Eingabe in gespeicherten Verbindungen registriert

Voraussetzungen am Remote-PC

Öffne am Remote-PC PowerShell als Administrator und führe den folgenden Befehl aus:

Enable-PSRemoting -Force

Handelt es sich nicht um eine Domänenumgebung, sondern um Arbeitsgruppe oder direkten IP-Zugriff, musst du am Client-PC TrustedHosts konfigurieren. Klickst du im Verbindungsdialog den Button „Diesen Host zu Vertrauenswürdig hinzufügen”, wird es automatisch erledigt.

Zum manuellen Konfigurieren:

# In administrativer PowerShell ausführen
Set-Item WSMan:\localhost\Client\TrustedHosts -Value "ZielIPoderHostname" -Force

Funktionsweise und Einschränkungen

• Gib in der Konsole einen PowerShell-Befehl ein und führe ihn mit Enter aus.
• Mit ↑ / ↓ kannst du den Befehlsverlauf durchblättern.
• Es ist ein imperatives Verfahren, das bei jedem Befehl eine neue Verbindung aufbaut (kein erhaltener Sitzungszustand).
• Interaktive Prompts wie Read-Host werden nicht unterstützt.

WinRM-Problembehebung

Symptom	Ursache	Maßnahme
Fehler „Zugriff verweigert”	Unzureichende Kontoberechtigung	Administratorkonto verwenden oder zur Gruppe für erlaubte Remote-Verwaltung hinzufügen
Keine Verbindung (Arbeitsgruppe)	TrustedHosts nicht konfiguriert	Im Dialog „Diesen Host zu Vertrauenswürdig hinzufügen” klicken
Keine Verbindung (Firewall)	Port 5985/5986 blockiert	WinRM-Port in der Firewall des Remote-PCs erlauben
Kein WinRM-Dienst	PSRemoting nicht aktiviert	Am Remote-PC Enable-PSRemoting -Force ausführen
HTTPS-Zertifikatsfehler	Selbstsigniertes Zertifikat	Über HTTP (5985) verbinden oder Zertifikatvertrauen einrichten
WinRM nicht im Menü	Läuft unter macOS	Windows-exklusive Funktion, auf einem Windows-PC nutzen

---

Desktop-Aufnahme

Bildschirmbereich erfassen (📷)

Klickst du den 📷-Button der Registerkartenleiste, legt sich ein transparentes Overlay über den Bildschirm.

1. Wähle per Maus-Drag den zu erfassenden Bereich (auch externe Monitore).
2. Das erfasste Bild öffnet sich im Markup-Editor — du kannst es mit Pfeilen · Text · Textmarker annotieren.
3. Klickst du den Button „An KI senden”, wird das Bild an den geöffneten KI-Chat angehängt.

Tipp

Das KI-Chat-Panel muss geöffnet sein, damit der Button „An KI senden” aktiviert ist.

Desktop-Mirror (Live-Streaming)

Neue-Registerkarte-Menü → 🖥️ Desktop-Aufnahme… → wählst du in der Fensterliste eine App, wird das betreffende Fenster live ins Panel gestreamt (nur Ansicht).

• Die KI kann den Mirror-Bildschirm mit dem Tool panel_screenshot sehen.
• Das Web-Vorschau-Panel kannst du mit dem ✏️-Button erfassen und an die KI senden.

---

Allgemeine Problembehebung

Wenn die App abstürzt · der Bildschirm weiß wird

Symptom	Ursache	Maßnahme
Bildschirm wird weiß und lädt automatisch neu	Renderer-Prozess-Absturz	Automatisch behoben — normales Verhalten
Mehr als 3 wiederholte Abstürze in 30 Sekunden	GPU-Treiber- oder Speicherproblem	GPU-Treiber aktualisieren und neu starten
Bleibt auch nach Neuladen weiß	Schwerer Renderer-Fehler	Nach Prüfung von crash.log Kontakt aufnehmen

Speicherort des Absturzprotokolls: %APPDATA%\Blyck\crash.log

Bei einem Absturz:

1. Öffne crash.log und prüfe den letzten Fehlerinhalt.
2. Öffne mit F12 die Entwicklerwerkzeuge und prüfe in der Registerkarte Konsole die Fehler.
3. Lässt es sich nicht lösen, hänge crash.log und logs\blyck.log an die Kontaktseite an.

Einfrieren · Verzögerung bei der Tasteneingabe

Symptom	Ursache	Maßnahme
5~10 Sek Einfrieren, dann automatische Wiederherstellung	Hauptthread während RAG-Neuindizierung oder LSP-Initialisierung blockiert	Kurz warten
Wiederholtes Einfrieren	Ressourcenkonflikt	blyck.log anhängen und Kontakt aufnehmen
Langes Einfrieren während KI-Arbeit	Turn-Backstop (60 Min) oder 2-Min-Keine-Antwort-Behandlung	Mit dem ■ Stopp-Button erzwungen abbrechen

Zu Updates

Blyck prüft beim App-Start und im 4-Stunden-Intervall auf update.blyck.dev auf Updates. Eine neue Version wird im Hintergrund heruntergeladen und beim Beenden der App automatisch installiert.

Symptom	Ursache	Maßnahme
Update wird nicht angewendet	App nicht vollständig beendet	Bis zum Tray-Symbol vollständig beenden und neu starten
Download schlägt fehl	Firmen-Netzwerk blockiert das CDN	IT-Team um Freigabe von update.blyck.dev bitten oder manuell installieren
Update wird nicht geprüft	Offline-Umgebung	Internetverbindung herstellen und neu starten

Zur Lizenz

Symptom	Ursache	Maßnahme
Vollbild-Sperre angezeigt	14-Tage-Test beendet	Lizenzschlüssel einfügen und aktivieren
„Ihr Abonnement ist abgelaufen”	Abo abgelaufen oder gekündigt	Abo-Status im Lemon-Squeezy-Portal prüfen
Authentifizierung fehlgeschlagen	Offline-Zustand	Netzwerkverbindung herstellen und erneut versuchen
„Auf einem anderen Gerät registriert”	Gerätelimit überschritten	Geräte im Lemon-Squeezy-Portal verwalten
Nach 7 Tagen offline gesperrt	Offline-Grace-Period überschritten	Internetverbindung herstellen und App neu starten zur erneuten Prüfung

Hinweis

Ein aktiviertes Gerät kann 7 Tage offline ohne erneute Prüfung genutzt werden.

Zur DB-Verbindung

Symptom	Ursache	Maßnahme
Verbindungs-Timeout	Netzwerk-·Firewall-Blockade	Host · Port · Firewall-Regeln prüfen. PG/MySQL 10 Sek, MSSQL 15 Sek
Oracle ORA-xxxxx	Serverseitiger Fehler (Service-Name · Konto gesperrt usw.)	Server-Verbindungsdaten erneut prüfen
Oracle NJS-116	Umgebung ohne Thin-Modus-Unterstützung	Thick erzwingen ankreuzen + Pfad zum 64-Bit Instant Client setzen
Oracle NJS-118	Thick-Initialisierungsfehler	Nach App-Neustart erneut versuchen
MySQL BIGINT als String angezeigt	Präzisionsschutz über 2^53	Normales Verhalten — kein Bug
Explosion von Pool-Sessions	—	Wird automatisch über den Pool (max. 4) verwaltet, kein Problem

Detaillierte DB-bezogene Probleme siehe die Seite DB-Client.

Zur Web-Vorschau

Symptom	Ursache	Maßnahme
Seite lädt nicht	Dev-Server läuft nicht	Lokalen Dev-Server zuerst starten, dann URL eingeben
preview_eval schlägt sofort fehl	Seite lädt noch	Nach dem preview_wait-Tool erneut versuchen
Bildschirm bleibt leer hängen	URL-Fehler oder Serverfehler	URL und Serverstatus prüfen

Achtung

Bei der Web-Vorschau musst du zuerst den Dev-Server starten und dann die URL eingeben. Ohne Server funktioniert es nicht.

Details siehe die Seite Run & Preview.

Zur RAG-Suche

Symptom	Ursache	Maßnahme
Keine Ergebnisse oder alte Dateien angezeigt	Index nicht aktualisiert	Chat-Einstellungen → RAG-Index-Status prüfen
Gelöschte Datei wird gefunden	Orphan-Eintrag	Orphan-Scan-Bereinigungstool ausführen
Ergebnisse zu verrauscht	Indizierung unnötiger Dateien	Ausschlussmuster mit .termeditignore hinzufügen
Ergebnisse seltsam nach Embedding-Modellwechsel	Neuindizierung läuft	Bis zum Abschluss der Neuindizierung warten

Zur RAG-Indexverwaltung siehe die Seite RAG-Suche.

Zur SSH-Verbindung

Symptom	Ursache	Maßnahme
Hängt bei der Passworteingabe	Nicht standardmäßiger Prompt (Erkennungswartezeit max. 30 Sek)	Direkt eingeben oder Passwortspeicherung nutzen
Automatische Wiederverbindung schlägt fehl	Reiner Passwort-Server (Passwort bei Wiederverbindung nicht wiederverwendet)	Schlüssel-/agent-Authentifizierung einrichten oder manuell neu verbinden
Nur SFTP schlägt fehl	SFTP-Subsystem deaktiviert	Im Datei-Panel manuell neu verbinden
Sonderzeichen zerbrochen	Server-Locale	Server locale auf *.UTF-8 prüfen

Details siehe die Seite Terminal · SSH · SFTP.

Zu den KI-Funktionen

Symptom	Ursache	Maßnahme
KI-Chat deaktiviert	CLI nicht installiert oder nicht eingeloggt	Im Setup-Assistenten CLI installieren·einloggen
Fehler 401/403	API-Schlüssel abgelaufen oder falsch	Schlüssel neu registrieren oder claude login erneut ausführen
Keine Antwort / Einfrieren	Netzwerk oder abgelaufene Authentifizierung	Nach 3 automatischen Wiederholungen neu einloggen, neuen Chat starten
Datei ohne Genehmigungskarte geändert	🚀 Auto-Modus aktiv	Mit Ctrl+3 in den ⚡ Ausführen+Prüfen-Modus wechseln

Details siehe die Seite KI-Chat.

Zur LSP-Autovervollständigung

Symptom	Ursache	Maßnahme
Python-Autovervollständigung geht nicht	Pyright nicht installiert	Beim ersten Öffnen einer Python-Datei das „Herunterladen?”-Modal genehmigen
Go-Autovervollständigung geht nicht	Keine Go-Toolchain	Nach Go-Installation go install golang.org/x/tools/gopls@latest
Rust-Autovervollständigung geht nicht	rust-analyzer-Download fehlgeschlagen	App in einer Umgebung mit GitHub-Zugriff neu starten oder manuell installieren und in PATH eintragen
Download im Firmen-Netzwerk fehlgeschlagen	GitHub blockiert	Den betreffenden Server selbst installieren und in PATH eintragen

Zur Terminal-Darstellung

Symptom	Ursache	Maßnahme
Schrift unscharf	WebGL-Fallback (Canvas/DOM)	In den Einstellungen Canvas-Renderer explizit festlegen
Ausrichtung von Vollbreite-Zeichen zerbrochen	DOM-Renderer in Verwendung	In den Einstellungen Canvas-Renderer festlegen
Sonderzeichen zerbrochen (lokal)	—	Windows wendet UTF-8 automatisch an; native exe wie ipconfig durch PowerShell-Cmdlet ersetzen

---

Ich möchte eine falsche Änderung rückgängig machen

Öffnest du mit Ctrl+Shift+H den Änderungsverlauf, sind alle Datei-·DB-·SSH-Änderungen protokolliert. Wähle einen Eintrag und mache ihn rückgängig. Bei DML werden die Daten unmittelbar vor der Ausführung automatisch gesichert, sodass auch ein UPDATE ohne WHERE wiederhergestellt werden kann.

Zur detaillierten Funktionsweise siehe die Seite Git · ChangeSet.

---

Speicherort von Logs·Daten (Windows)

Element	Speicherort
App-Log	%APPDATA%\Blyck\logs\blyck.log (2-MB-Rotation)
Absturzprotokoll	%APPDATA%\Blyck\crash.log
Verbindungsdaten (ohne Passwort)	%APPDATA%\Blyck\connections.json
Layout (Registerkarte·Teilung)	%APPDATA%\Blyck\layout.json
KI-Chat-Verlauf	%APPDATA%\Blyck\chats\
Änderungsverlauf (ChangeSet)	%APPDATA%\Blyck\blyck-history.db
RAG-Index	SQLite-Datei pro Arbeitsbereich

Passwörter und Tokens werden nicht in Dateien, sondern verschlüsselt im OS-Anmeldeinformationsspeicher aufbewahrt. In den Logs werden Passwörter·Tokens·API-Schlüssel·Benutzerpfade automatisch maskiert und nur lokal gespeichert, nicht nach außen übertragen.

Tipp

Hängst du bei einer Anfrage %APPDATA%\Blyck\logs\blyck.log an, beschleunigt das die Diagnose.

---

Sonstige Probleme

Probleme, die sich nicht lösen lassen, sende bitte an die Kontaktseite. Gibst du dazu Umgebungsinfos (OS · Version) und die Reproduktionsschritte an, können wir dir schnell helfen. Die von Blyck intern geöffneten Hilfsserver (MCP · VNC-Proxy usw.) werden alle nur über localhost mit dynamischem Port + Token-Authentifizierung geöffnet, sodass keine Firewall-Ausnahmen oder Portfreigaben nötig sind.