Troubleshooting

Beginne mit dem kleinsten echten Check. Die meisten Probleme fallen in eine von fünf Kategorien: Zugang, Provider-Konfiguration, lokale Umgebung, Qualität generierter Outputs oder veraltete Dokumentation.

Zugangsprobleme

Symptom	Check
Produktseite sagt bald verfügbar oder im Aufbau	Das Produkt ist noch nicht offen — das Label ist der echte Stand, kein Login-Problem.
Du hast ein aktives bezahltes Feature erwartet	Mitgliedschafts-Checkout und FC-Top-ups bleiben deaktiviert, bis ihre Aktivierungs-Gates bestehen. Siehe FluxCore.
Du findest keinen Download	Prüfe in der Produktübersicht, ob das Produkt live ist.

CLI-Probleme

Für Skillry:

npx skillry init
skillry validate
skillry sync --dry-run

Wenn ein Kommando fehlschlägt, wiederhole es mit --verbose und kopiere den Fehlertext ohne Secrets.

Provider- oder Generierungsprobleme

• Prüfe, ob der Provider Key in der erwarteten Einstellung oder Umgebungsvariable existiert.
• Prüfe, ob der Prompt in die Provider-Limits passt.
• Reduziere Prompt-Mehrdeutigkeit, bevor du Modelle wechselst.
• Hat ein Output unlesbaren Text, entscheide, ob deterministisches Overlay ihn fixen kann oder ob die Generierung einen Retry braucht.
• Behalte fehlgeschlagene Outputs und Manifeste, bis die Ursache verstanden ist.

Lokale Desktop-Probleme

• Prüfe App-Version und Betriebssystem.
• Prüfe, ob die App Lese-/Schreibrechte auf ihren lokalen Datenbankordner hat.
• Bevorzuge eingebaute Test- oder Health-Screens statt Ad-hoc-Checks.
• Lösche lokalen State nur, wenn der Produkt-Guide es explizit als sicher beschreibt.

Docs-Probleme

Wenn eine Docs-Seite unklar oder falsch ist, melde die URL und den genauen Satz oder das Kommando, das fehlgeschlagen ist. Ein präziser Report ist viel schneller zu fixen als ein allgemeines „die Docs sind kaputt“.