Troubleshooting

AKC-Ansicht oder Statusleiste fehlt

Symptom: Activity-Bar-Eintrag oder AKC in der Statusleiste nicht sichtbar.

Lösung:

1. Befehlspalette → Developer: Reload Window (nach Updates oft nötig, Extension-Host-Cache).
2. Extensions-Ansicht: AI Keep Clean Enabled, Marketplace-ID ready-4-it.aikeepclean.
3. VS Code-Version ≥ 1.102 (Help → About). Darunter lädt die Engine die Extension nicht.
4. Ein- bis zweimal auf den AKC-Statusleisten-Eintrag klicken, damit der kontextbezogene Statusleisten-Block (u. a. Close All) erscheint.

Explorer-Roots färben nicht / nur zwei Wurzeln

Symptom: Der dritte (oder spätere) Workspace-Ordner bleibt grau. Oder Custom-Hex wird ignoriert.

Das ist in Free so gebaut (v1.22.41): Soft-Limit 2 workspaceFolders mit Builtin-Paletten. Root 3+ und Custom-Hex brauchen Trial/Pro. Preview umgeht den Cap nicht.

Prüfen:

• Reihenfolge der Roots in der .code-workspace (es zählen die ersten zwei Indizes).
• License-Status in der Statusleiste (AKC Free vs. Trial/Full).
• Nach Aktivierung Window reloaden, dann erneut Apply in Explorer Root Colors.

Workspace-Farben wirken falsch oder bleiben aus

Symptom: Preview sieht gut aus, Apply ändert nichts — oder Dark/Light vertauscht.

Lösung:

• In Workspace Settings wirklich Apply klicken, nicht nur Preview.
• Scope: Workspace vs. Global.
• Dark- und Light-Mode sind getrennte Ziele. Statusleiste (Sonne/Mond) muss zum Apply-Ziel passen.
• Colour Zen kann Apply bei zu schwachem Kontrast ablehnen — Preset wechseln oder Kontrast erhöhen.

Statusleisten-Terminal öffnet falsch oder gar nicht

Symptom: Klick auf AKC startet kein Fenster, falscher Pfad, oder Windows-Security-Dialog.

Lösung:

• Erwartetes Verhalten: Windows = externes PowerShell-/Windows-Terminal im Workspace-Root, Titel PS: <workspace> #<n>; sonst integriertes Terminal.
• Antivirus/code.exe-Hooks: code.exe auf die Ausschlussliste setzen.
• Workspace wirklich geöffnet (nicht nur eine lose Datei).
• Reload Window nach Extension-Update.

AI-Verbindung klappt nicht

Symptom: Keine Vorschläge, Timeouts, Connection refused.

Theme Suggest ohne „Generate with local model“ braucht kein Ollama.

Ollama:

• ollama serve, Modell gezogen (ollama pull llama3), Base-URL in AI / KI Settings = http://localhost:11434.
• Sonst fällt Suggest auf den Offline-Katalog zurück.

Cloud-Endpoint: API-Key, Endpoint, Modellname.

Free-Limit: 10 Suggestions/Tag sind aufgebraucht → Status/Upsell prüfen, kein Provider-Fehler.

AI Compare: nur Trial/Pro. Ohne Token ist „geht nicht“ korrekt.

Lizenz wird nicht akzeptiert

Symptom: Aktivierung abgelehnt.

Lösung:

• Aktivierungsschlüssel (R4IT.…) einfügen, nicht den Kauf-Lizenzschlüssel.
• Leerzeichen am Token-Rand entfernen.
• Slot frei? Zweites Gerät erst deaktivieren.
• Netz und VS Code 1.102+.

Darstellung unlesbar / zu bunt

Symptom: Kontrast zu schwach oder Rainbow zu laut.

Lösung:

• Auf ein stabiles Builtin-Preset zurück, Colour Zen respektieren.
• Indent-Stufen reduzieren.
• Nur eine Variable (Farbe oder Indent) pro Durchgang ändern, dann Apply.

Support: support@ready-4-it.com · Lizenz · Installation.