Fehlerbehebung

„Service is experiencing high traffic. Please try again later!“

Dies ist der häufigste Fehler, auf den Nutzer stoßen. Er weist darauf hin, dass der Verdent-Dienst vorübergehend überlastet ist.

Wann er auftritt:

• Während Spitzenlastzeiten
• Wenn Backend-Dienste stark ausgelastet sind
• Bei vorübergehender Beeinträchtigung des Dienstes

Wiederherstellungsschritte (in dieser Reihenfolge):

Probleme bei Installation und Einrichtung

Systemanforderungen:

• VS Code-Version: 1.90.0 oder höher (erforderlich)
• Internetverbindung: Aktive Verbindung erforderlich
• Abonnement: Aktives Verdent-Abonnement

Grundlegende Diagnose-Checkliste:

1. VS Code-Version prüfen: Hilfe → Info (muss 1.90.0 oder höher sein)
2. Internetverbindung prüfen: Verdent benötigt eine aktive Verbindung
3. Abonnement prüfen: Stellen Sie sicher, dass das Verdent-Abonnement aktiv ist
4. VS Code neu starten: Nach der Installation oder Konfigurationsänderungen
5. Erweiterungsstatus prüfen: Ansicht → Erweiterungen → Verdent (sollte „Aktiviert“ anzeigen)

Vorgehen für eine saubere Neuinstallation:

Protokolle prüfen:

• Öffnen Sie das Ausgabefenster: Ansicht → Ausgabe
• Wählen Sie „Verdent“ im Dropdown-Menü aus
• Suchen Sie nach Fehlermeldungen oder Stack-Traces

Anmeldung bei Verdent for VS Code nicht möglich

Häufigste Ursache: Problem mit der Proxy-Konfiguration

Lösung:

Kostenlose Testversion: Credits nicht erhalten

Fehler: Credits der kostenlosen Testversion wurden nicht gutgeschrieben oder der Zugang zur Testversion wurde verweigert

Grund: Bei der Registrierung wurde ein Verstoß gegen die Nutzungsbedingungen festgestellt

Lösung: Wenden Sie sich für Unterstützung bei Ihrem Zugang zur kostenlosen Testversion an support@verdent.ai. Das Support-Team prüft Ihr Konto und hilft, das Problem zu lösen.

Registrierung fehlgeschlagen

Fehler: Die Kontoregistrierung wurde abgelehnt oder eingeschränkt

Grund: Die Registrierung verstößt gegen die Nutzungsbedingungen von Verdent, was zu einer Zugangsbeschränkung geführt hat

Lösung: Wenden Sie sich an support@verdent.ai. Das Support-Team kann Ihre Registrierung prüfen und Ihnen Hinweise zur Lösung des Problems geben.

Fehlende Modelle (Claude, GPT, Gemini)

Problem: Claude, GPT- oder Gemini-Modelle sind in der Modellauswahl nicht zu finden

Grund: Standortbezogene Einschränkungen der Modellanbieter

Erklärung: Einige KI-Modellanbieter haben regionale Einschränkungen, die verhindern, dass bestimmte Modelle in bestimmten geografischen Regionen verfügbar sind. In diesem Fall gilt:

• Eingeschränkte Modelle erscheinen nicht in Ihrem Modellauswahlmenü
• Sie können weiterhin alle anderen verfügbaren Modelle ohne Unterbrechung nutzen
• Es gibt keine Auswirkungen auf Ihr Abonnement oder Ihre Credits

Verfügbare Modelle prüfen: Besuchen Sie https://www.verdent.ai/regions, um zu sehen, welche Modelle in Ihrer Region verfügbar sind

Leistungsprobleme

Symptome:

• Langsame Antwortzeiten
• Fehler wegen vollem Kontextfenster
• Zeitüberschreitungen bei der Werkzeugausführung

Häufige Ursachen und Lösungen:

Fehlermeldungen im Zusammenhang mit Bildern

Kurzübersicht häufiger Fehler bei der Bildverarbeitung:

Fehler bei file_edit

Fehler: „Failed to find exact match“

Ursachen:

• Text wurde seit dem letzten file_read geändert
• Unterschiede bei Leerzeichen (Tabs vs. Leerzeichen)
• String ist in der Datei nicht eindeutig

Lösungen:

# 1. Read file again to get current state
file_read("file.js")

# 2. Use larger context string for uniqueness
file_edit("file.js",
  old_string="function foo() {\n  return 42;\n}",
  new_string="...")

# 3. For multiple identical strings, use replace_all
file_edit("file.js", old_string="TODO", new_string="DONE", replace_all=true)

Fehler bei bash-Befehlen

Fehler: Zeitüberschreitung oder Ausführungsfehler des Befehls

Maximales Timeout: 120 Sekunden (2 Minuten, feste Grenze)

Lösung: Lange Befehle in kleinere Vorgänge aufteilen:

# Instead of one long command, break into steps
bash("step1")  # Completes in < 2min
bash("step2")  # Completes in < 2min

Befehl nicht gefunden:

• Prüfen, ob der Befehl existiert: bash("which command-name")
• Sicherstellen, dass der Pfad korrekt ist oder zuerst die Umgebung aktivieren
• Vollständige Pfade für ausführbare Dateien verwenden

Berechtigungsfehler:

• Befehle werden mit Benutzerberechtigungen ausgeführt
• sudo nur bei Bedarf und in Manual Accept Mode verwenden
• Datei- bzw. Verzeichnisberechtigungen prüfen

Suche liefert keine Ergebnisse

Problem: grep_file oder glob findet die erwarteten Dateien nicht

Muster-Syntax prüfen:

# Wrong
grep_file("*.ts")  # Missing ** for recursive

# Correct
grep_file("**/*.ts")  # Recursive search

Ausschlüsse prüfen:

# Ensure not accidentally excluding target files
glob("**/*.js", exclude=["**/dist/**", "**/node_modules/**"])

Groß-/Kleinschreibung:

# Use case-insensitive search if needed
grep_content("pattern", case_insensitive=true)

Subagent wird nicht aufgerufen

Problem: Ein benutzerdefinierter Subagent wird nicht automatisch aktiviert

Checkliste:

• Dateispeicherort: ~/.verdent/subagents/[name].md
• Gültiges YAML-Frontmatter mit name und description
• Aufrufrichtlinie entspricht der Nutzung (bei „strict“ ist eine @-Erwähnung erforderlich)
• Die Hinweise „Wann verwenden“ entsprechen dem Anfragemuster
• Keine Syntaxfehler in der Markdown-Datei

Manuell testen:

@subagent-name perform task

Verhalten integrierter Subagenten

Problem: @Explorer, @Verifier oder @Code-reviewer verhalten sich nicht wie erwartet

Häufige Ursachen:

• Die Anfrage entspricht nicht der Spezialisierung des Subagenten
• Kontext des Subagenten ist voll (selten)
• Der Hauptkonversationskontext beeinflusst das Routing

Lösung:

• Verwenden Sie eine explizite @-Erwähnung, um einen bestimmten Subagenten zu erzwingen
• Formulieren Sie die Anfrage um, damit sie zur Expertise des Subagenten passt
• Starten Sie bei Kontextproblemen eine neue Konversation

AGENTS.md wird nicht angewendet

Problem: Projektregeln beeinflussen das Verhalten von Verdent nicht

Diagnose:

1. Speicherort: Die Datei muss sich im Stammverzeichnis des Projekts befinden
2. Syntax: Gültiges Markdown (auf Syntaxfehler prüfen)
3. Eindeutigkeit: Regeln müssen direktiv formuliert sein: „Immer X verwenden“ statt „Versuchen Sie, X zu verwenden“
4. Test: Starten Sie eine neue Konversation, um die Anwendung neu zu testen

Rangfolge prüfen:

# In AGENTS.md (highest priority)
- Use 4-space indentation

# In VERDENT.md (lower priority)
- Use 2-space indentation

# Result: 4-space indentation (AGENTS.md wins)

Verbindungsfehler bei MCP

Fehler: Verbindung zum MCP-Server nicht möglich

Diagnoseschritte:

1. mcp.json prüfen: Gültige JSON-Syntax in ~/.verdent/mcp.json
2. Server läuft: Sicherstellen, dass der MCP-Serverprozess aktiv ist
3. Netzwerk: Konnektivität zum Server-Endpunkt prüfen
4. Authentifizierung: Bestätigen, dass die Anmeldedaten korrekt sind
5. Protokolle: Serverprotokolle von MCP auf Fehlerdetails prüfen

Häufige Lösungen:

• MCP-Server neu starten
• Format der Verbindungszeichenfolge prüfen
• Firewall-Regeln prüfen, die MCP-Datenverkehr zulassen
• API-Schlüssel oder Token validieren

Einschränkungen bei Binärdateien

Problem: Bilder, PDFs oder kompilierte Binärdateien können nicht bearbeitet werden

Workaround:

# Use bash to call external tools
bash("convert input.png -resize 50% output.png")
bash("pdftotext document.pdf output.txt")

Umgang mit großen Dateien

Problem: Dateien mit mehr als 10.000 Zeilen verursachen Kontextprobleme

Workaround:

# Always use line ranges for large files
file_read("large.log", start_line=1000, max_lines=100)

# Search first to find relevant sections
grep_content("ERROR", glob="large.log")

Plattformübergreifende Befehlsunterschiede

Problem: bash-Befehle unterscheiden sich zwischen Windows und Unix

Workaround:

# Use cross-platform tools when possible
bash("npm run build")  # Works everywhere

# Or conditional execution
bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")

Empfehlung: Verwenden Sie npm-Skripte für plattformübergreifende Kompatibilität.