Lambtune

WIKI

Troubleshooting

Häufige Probleme und ihre Lösung.

API-Key wird abgelehnt

Symptom: Der Wizard startet nicht, stattdessen erscheint eine Meldung wie authentication_error oder invalid_api_key.

Ursachen und Lösungen:

  • Key fehlerhaft kopiert: Öffne Einstellungen → KI-Setup und füge den Key erneut ein. Achte auf führende/nachfolgende Leerzeichen — die Eingabe-Feldvalidierung akzeptiert derzeit Whitespace ohne Warnung.
  • Key deaktiviert: In der Anthropic Console unter API Keys prüfen, ob der Key noch aktiv ist. Deaktivierte Keys können nicht reaktiviert werden — erstelle einen neuen.
  • Kein Guthaben: Anthropic-Konten benötigen Prepaid-Guthaben für API-Nutzung. Prüfe den Kontostand in der Console unter Billing.
  • Rate Limit: Bei intensiver Nutzung können Rate-Limits greifen. Warte 60 Sekunden und starte den Wizard erneut.

Wizard-Antwort scheint abgeschnitten

Symptom: Phase 2 oder Phase 3 endet mitten im Satz, Vorschläge sind unvollständig, JSON-Parsing-Fehler in der App.

Ursachen und Lösungen:

  • Token-Limit: Sehr große Bin-Auszüge oder umfangreiche Logs können das Modell-Kontext-Limit überschreiten. Teile das Log in Abschnitte auf (Leerlauf-Log separat von Lastfahrt-Log) und starte den Wizard mit einem Segment.
  • Netzwerkunterbrechung: Streaming-Antworten können bei instabiler Verbindung unterbrochen werden. Lambtuneversucht einmalig einen Reconnect — bei dauerhaftem Abbruch erscheint eine Fehlermeldung mit Retry-Button.
  • Anthropic-Ausfall: Prüfe den Status auf status.anthropic.com.

Zellen werden nach Walkthrough nicht angewendet

Symptom: Wizard-Walkthrough abgeschlossen, Vorschläge als übernommen markiert, aber Map-Werte im Editor unverändert.

Ursachen und Lösungen:

  • Kein Definition-File: Ohne XDF/A2L kann Lambtunedie Zell-Koordinaten nicht auflösen. Der Wizard kann Vorschläge generieren, aber nicht schreiben. Lösung: Definition-File importieren und Walkthrough erneut starten (die übernommenen Vorschläge sind im Audit gespeichert und können erneut angewendet werden).
  • Offset-Mismatch: Map-Offset aus XDF stimmt nicht mit der geladenen Bin-Revision überein. Symptom: Wert ändert sich, aber an einer anderen Stelle. Prüfe die Bin-Revision.
  • Schreibgeschützte Bin: Wenn die Bin-Datei auf dem Dateisystem schreibgeschützt ist, scheitert das Speichern lautlos. Prüfe Dateiberechtigungen im Finder.

Permission-Fehler auf macOS

Symptom: permission denied-Fehler beim Öffnen von Dateien, Datei-Picker öffnet sich jedes Mal neu statt das Bookmark zu nutzen.

  • Sandbox-Bookmark abgelaufen: Öffne die Datei erneut über den Datei-Picker. Lambtune erstellt ein neues Security-Scoped Bookmark.
  • Datei auf Volume ohne Bookmark-Support: Einige Netzlaufwerke und FAT32-Volumes unterstützen keine Bookmarks. Kopiere die Bin-Datei auf ein APFS/HFS+-Volume (z. B. dein lokaler Home-Ordner).
  • macOS-Datei-Berechtigungen prüfen: Unter Datenschutz & Sicherheit → Dateien und Ordner kontrollieren, ob Lambtune Zugriff auf den Ordner mit der Bin-Datei hat. Für normale Nutzung reichen die Bookmark-Berechtigungen aus dem Datei-Picker — separate Einstellungen sind selten nötig.

iCloud-Sync-Probleme

Symptom: Projekt auf macOS angelegt, auf iOS nicht sichtbar (oder umgekehrt). Änderungen synchronisieren nicht.

  • iCloud Drive aktiv? Lambtune-Projekte liegen im App-eigenen iCloud-Container. Prüfe unter Systemeinstellungen → Apple ID → iCloud, ob iCloud Drive aktiviert ist.
  • Sync hängt: In macOS Finder unter iCloud Drive den Lambtune-Ordner suchen. Wenn ein Sync-Symbol angezeigt wird, warte bis der Upload abgeschlossen ist. Bei dauerhaftem Hängen: macOS neu starten.
  • Speicherplatz: Voller iCloud-Speicher unterbricht die Synchronisierung ohne explizite Fehlermeldung in der App. Prüfe den verfügbaren iCloud-Speicher.
  • Bin-Dateien fehlen auf dem anderen Gerät:Bin-Dateien die über Security-Scoped Bookmarks referenziert (nicht eingebettet) wurden, sind gerätespezifisch. Bette die Bin direkt ins Projekt-Bundle ein (Onboarding-Option) für geräteübergreifende Nutzung.

Support

Wenn dein Problem hier nicht beschrieben ist, schreib an support@lambtune.de mit: App-Version (aus Lambtune → Über Lambtune), macOS- oder iOS-Version, und einer kurzen Beschreibung der Schritte die zum Problem geführt haben.