Zum Hauptinhalt springen

Fehlerbehebung

Häufige Probleme und wie Sie sie beheben.

Probleme mit Providern​

„Error: 401 Unauthorized“​

  • Ursache: Ungültiger API-Schlüssel.
  • Lösung: Gehen Sie zu Settings > Providers. Geben Sie Ihren API-Schlüssel erneut ein. Achten Sie darauf, dass keine zusätzlichen Leerzeichen oder Zeilenumbrüche enthalten sind.

„Error: 403 Forbidden“​

  • Ursache: Ihr API-Schlüssel hat keinen Zugriff auf das angeforderte Modell.
  • Lösung:
    • Bei OpenAI: Einige Modelle erfordern eine kostenpflichtige Stufe. Prüfen Sie Ihren Zugriff unter platform.openai.com.
    • Bei Anthropic: Stellen Sie sicher, dass Ihr Konto Zugriff auf das angeforderte Claude-Modell hat.

„Error: 429 Too Many Requests“​

  • Ursache: Sie haben das Rate Limit erreicht oder Ihre credits sind aufgebraucht.
  • Lösung:
    • Warten Sie einige Minuten und versuchen Sie es erneut (Rate Limit).
    • Prüfen Sie Ihren Abrechnungsstatus und laden Sie credits auf der Website des Providers auf.
    • Erwägen Sie, vorübergehend zu einem anderen Provider zu wechseln.

„Error: 500 Internal Server Error“​

  • Ursache: Die Server des Providers haben Probleme.
  • Lösung: Warten Sie einige Minuten und versuchen Sie es erneut. Prüfen Sie die Statusseite des Providers.

„Connection Refused“ (Ollama)​

  • Ursache: Rephlo kann nicht mit dem lokalen KI-Server kommunizieren.
  • Lösung:
    1. Öffnen Sie ein Terminal und führen Sie ollama serve aus.
    2. Prüfen Sie, ob es läuft: Rufen Sie http://localhost:11434 in einem Browser auf.
    3. Prüfen Sie, ob eine andere Anwendung Port 11434 belegt.

„Model Not Found“ (Ollama)​

  • Ursache: Das angeforderte Modell wurde nicht heruntergeladen.
  • Lösung: Führen Sie ollama pull [model-name] in Ihrem Terminal aus (z. B. ollama pull llama3).

Probleme mit der Benutzeroberfläche​

„Hotkeys funktionieren nicht“​

  • Ursache (Windows/Linux): Eine andere Anwendung (z. B. PowerToys oder ein Spiel) hat den Hotkey möglicherweise belegt.
  • Lösung: Gehen Sie zu Settings > Hotkeys und ändern Sie den Auslöser auf eine andere Kombination (z. B. Ctrl + Shift + Alt + Z).

macOS-Nutzer: Siehe macOS-spezifische Probleme weiter unten zur Fehlerbehebung bei Hotkeys unter macOS.

„Tray-Symbol fehlt“​

  • Ursache: Windows hat es möglicherweise im „Überlauf“-Menü ausgeblendet.
  • Lösung: Klicken Sie auf den ^-Pfeil neben der Uhr. Ziehen Sie das Rephlo-Symbol in den Hauptbereich der Taskleiste.

Probleme mit Funktionen​

„Vision/Screenshot funktioniert nicht“​

  • Ursache (Windows): Die Berechtigung für Bildschirmaufnahmen ist möglicherweise in den Windows-Datenschutzeinstellungen verweigert.
  • Lösung (Windows): Führen Sie Rephlo als Administrator aus oder prüfen Sie Windows Privacy settings > Camera / Screen capture.
  • Ursache (macOS): Rephlo benötigt die Berechtigung „Bildschirmaufnahme“.
  • Lösung (macOS): Siehe macOS-spezifische Probleme weiter unten für die detaillierten Schritte.

„Space beantwortet keine Fragen“​

  • Ursache: Der Space ist möglicherweise leer, oder die Ingestion ist fehlgeschlagen.
  • Lösung: Prüfen Sie die Space-Details. Stellen Sie sicher, dass Dateien aufgelistet sind und der Status „Ready“ anzeigt. Versuchen Sie, den Cache in den Advanced Settings zu leeren.

„Variable im Space nicht gefunden“​

  • Ursache: Sie verwenden eine {{filename}}-Variable, aber die Datei befindet sich nicht im aktiven Space.
  • Lösung:
    1. Prüfen Sie, ob der Space die referenzierte Datei enthält.
    2. Stellen Sie sicher, dass der Variablenname mit dem Dateinamen übereinstimmt (umgewandelt in snake_case, z. B. „Style Guide.pdf“ -> {{style_guide_pdf}}).
    3. Stellen Sie sicher, dass der richtige Space aktiv ist.

macOS-spezifische Probleme​

„Hotkeys funktionieren nicht“ (macOS)​

  • Ursache: Rephlo benötigt die Berechtigung „Bedienungshilfen“ (Accessibility), um globale Tastenkombinationen zu erkennen.
  • Lösung:
    1. Öffnen Sie System Settings > Privacy & Security > Accessibility.
    2. Suchen Sie Rephlo in der Liste und aktivieren Sie es (ON).
    3. Falls Rephlo nicht in der Liste erscheint, beenden Sie die App und starten Sie sie erneut.
    4. Starten Sie Rephlo neu, nachdem Sie die Berechtigung erteilt haben.

Wichtig: Globale Hotkeys funktionieren nur, wenn Rephlo als signiertes .app-Bundle ausgeführt wird. Wenn Sie als Entwickler dotnet run im Terminal ausführen, funktionieren die Hotkeys möglicherweise nicht. Siehe das macOS-Setup-Tutorial zum Erstellen und Ausführen des .app-Bundles.

„Screenshot/Vision funktioniert nicht“ (macOS)​

  • Ursache: Rephlo benötigt die Berechtigung „Bildschirmaufnahme“, um Bildschirminhalte zu erfassen.
  • Lösung:
    1. Öffnen Sie System Settings > Privacy & Security > Screen Recording.
    2. Suchen Sie Rephlo in der Liste und aktivieren Sie es (ON).
    3. Starten Sie Rephlo neu.

„Berechtigungsdialog erscheint ständig erneut“​

  • Ursache: Rephlo lief ohne stabile Codesignatur. Jeder Neu-Build ändert den Binärhash, wodurch macOS die App als neu behandelt und die Berechtigungen zurücksetzt.
  • Lösung: Verwenden Sie einen signierten Release-Build von Rephlo aus der offiziellen Distribution. Nachdem Sie der signierten App einmal Berechtigungen erteilt haben, bleiben diese über Updates hinweg erhalten.

„Overlay erscheint auch nach Erteilen der Berechtigungen nicht“​

  • Lösung:
    1. Beenden Sie Rephlo vollständig (Rechtsklick auf das Tray-Symbol > Exit).
    2. Starten Sie die App über das .app-Bundle neu.
    3. Prüfen Sie, ob sowohl Accessibility als auch Screen Recording Berechtigungen erteilt sind.
    4. Probieren Sie die Schaltfläche Test Overlay unter Settings > Hotkeys.

Leistungsprobleme​

„Antworten sind sehr langsam“​

  • Ursache: Verschiedene Faktoren können Antworten verlangsamen.
  • Lösung:
    • Großer Space-Kontext: Erwägen Sie, Ihren Space zu komprimieren (compacting).
    • Langsamer Provider: Wechseln Sie zu einem schnelleren Modell wie GPT-5.4 Mini oder Gemini 3.5 Flash für schnellere Antworten.
    • Lokales Modell (Ollama): Stellen Sie sicher, dass Ihre GPU genutzt wird. Prüfen Sie die Ollama-Logs.

„App wirkt beim Start träge“​

  • Ursache: Laden großer Spaces oder vieler Commands.
  • Lösung: Archivieren Sie nicht genutzte Commands. Entfernen Sie alte Spaces, die Sie nicht mehr benötigen.

Probleme mit Chat​

„Chat-Verlauf fehlt“​

  • Ursache: Unterhaltungen werden lokal gespeichert und wurden möglicherweise gelöscht.
  • Lösung: Prüfen Sie Settings > Privacy für die Einstellungen zur Verlaufsspeicherung. Bei der Einstellung „Immediate“ wird der Verlauf nicht gespeichert.

„Chat vergisst ständig den Kontext“​

  • Ursache: Sie haben das Kontextfenster des Providers überschritten.
  • Lösung: Starten Sie eine neue Unterhaltung, oder verwenden Sie einen Provider mit größerem Kontextfenster. Prüfen Sie die Dokumentation Ihres Providers für die genauen Kontextfenstergrößen.

Probleme mit Variablen und Templates​

„Variable nicht gefunden“ oder „Ungültige Variable“​

  • Ursache: Der Variablenname stimmt nicht mit einer gültigen Systemvariable oder Datei in Ihrem Space überein.
  • Lösung:
    • Verwenden Sie die exakte Syntax: {{input_content}}, {{space_data_all}} oder {{filename}}.
    • Für Dateivariablen: Wandeln Sie den Dateinamen in snake_case um (z. B. „Style Guide.pdf“ -> {{style_guide_pdf}}).
    • Prüfen Sie, ob die Datei in Ihrem aktiven Space existiert.
    • Prüfen Sie auf Tippfehler — Variablennamen unterscheiden nicht zwischen Groß-/Kleinschreibung, müssen aber korrekt geschrieben sein.

„Space-Variablen werden im Standalone-Modus ignoriert“​

  • Ursache: Standalone-Commands fügen Space-Daten nicht automatisch ein.
  • Erklärung: Der Standalone-Modus gibt Ihnen die volle manuelle Kontrolle. Variablen wie {{space_data_all}} werden nicht automatisch ersetzt.
  • Lösung: Wechseln Sie zum Combination-Modus für die automatische Einfügung von Space-Daten, oder fügen Sie die Space-Daten manuell in Ihren Prompt ein.

Probleme mit Spaces​

„Space voll“ oder „Token-Budget überschritten“​

  • Ursache: Ihr Space hat sein konfiguriertes Token-Limit überschritten.
  • Lösung:
    1. Öffnen Sie die Datenansicht des Space und prüfen Sie die aktuelle Nutzung.
    2. Entfernen Sie weniger wichtige Dateien aus dem Space, oder erhöhen Sie das Token-Budget (max. 1.000.000 Token) — beides reduziert direkt einen Space, der sein gespeichertes Budget überschreitet.
    3. Wechseln Sie den Datenmodus zu 🗜️ Compact, um KI-Zusammenfassungen statt des vollständigen Textes zu speichern — dies senkt die gezählten Token des Space (prüfen Sie die credit-Kosten). Wählen Sie dann eine Kompaktierungsstufe:
      • Conservative: Minimale Zusammenfassung (bewahrt Details).
      • Balanced: Moderate Zusammenfassung (Standard, empfohlen).
      • Aggressive: Starke Zusammenfassung (am besten für sehr große Spaces).
      • Hinweis: Bei einem sehr großen Space (≈128.000 Token oder mehr) ist Compact absichtlich deaktiviert — entfernen Sie stattdessen Dateien oder erhöhen Sie das Budget.
    4. Hinweis: 🔍 Smart Search hält jede Anfrage klein, indem nur die relevanten Passagen gesendet werden, zählt aber den vollständigen Rohtext zum Budget des Space — es steuert also die Kosten pro Anfrage, nicht einen Space, der sein gespeichertes Limit überschritten hat.

„Space-Ingestion fehlgeschlagen“ (PDF-/Dokumentfehler)​

  • Ursache: Die Datei konnte nicht verarbeitet werden — möglicherweise beschädigt, passwortgeschützt oder in einem nicht unterstützten Format.
  • Lösung:
    • Stellen Sie sicher, dass das PDF nicht passwortgeschützt ist.
    • Versuchen Sie, das Dokument erneut aus der Quellanwendung zu exportieren.
    • Bei gescannten PDFs: Rephlo extrahiert nur Text — Bilder innerhalb von PDFs werden nicht gelesen.
    • Prüfen Sie, ob die Datei beschädigt ist, indem Sie sie zunächst in einer anderen Anwendung öffnen.

Probleme bei der Bildgenerierung​

„Dieser Prompt wurde durch unsere Inhaltsrichtlinie blockiert"​

  • Ursache: Ihr Bild-Prompt wurde von der Inhaltsmoderation markiert und abgelehnt, bevor die Generierung ausgeführt wurde.
  • Lösung: Schreiben Sie Ihren Prompt um, um die nicht zulässigen Inhalte zu entfernen, und versuchen Sie es erneut. Siehe die Seite Inhaltsrichtlinie für Details, was nicht erlaubt ist.

„Inhaltsmoderation ist vorübergehend nicht verfügbar"​

  • Ursache: Der Inhaltsmoderationsdienst ist vorübergehend nicht erreichbar (eine vorübergehende Störung), sodass Ihr Prompt nicht überprüft werden konnte.
  • Lösung: Warten Sie einen Moment und versuchen Sie es erneut.

Hilfe erhalten​

Wie melde ich schädliche oder unangemessene KI-Ausgaben?​

  • Lösung:
    • Angemeldet: Klicken Sie auf Ihren Avatar unten in der Seitenleiste > Help > Report inappropriate content.
    • Jederzeit: Öffnen Sie Settings > About > Contact & Support > Report inappropriate content.
    • Dadurch wird rephlo.app/contact in Ihrem Browser geöffnet, mit der Meldungskategorie bereits vorausgewählt.