Einschränkungen & Beschränkungen

Binärdateien werden nicht unterstützt

Die Datei-Werkzeuge von Verdent funktionieren nur mit textbasierten Formaten. Folgendes kann nicht bearbeitet werden:

Workaround: Auf Binärdateien kann im Code verwiesen oder konzeptionell darüber gesprochen werden, Änderungen erfordern jedoch externe Werkzeuge.

Zeilenlimits für file_read

Einschränkung:

• Große Dateien (>10.000 Zeilen) sollten abschnittsweise gelesen werden
• Das Lesen ganzer großer Dateien kann zur Erschöpfung des Kontextfensters führen

Lösung: Verwenden Sie Zeilenbereiche: file_read("file.js", start_line=100, max_lines=50)

Zeitüberschreitungen bei bash-Befehlen

Einschränkung:

• Maximale Zeitüberschreitung: 120 Sekunden (2 Minuten)
• Lang laufende Vorgänge werden automatisch beendet

Lösung: Teilen Sie Vorgänge in kleinere Befehle auf, die innerhalb von 2 Minuten abgeschlossen werden

Suchleistung

Einschränkung:

• Breite Glob-Muster (**/*) können Tausende von Ergebnissen liefern
• Regex-Suchen sind langsamer als Suchen nach wörtlichen Zeichenfolgen

Lösung: Verwenden Sie spezifische Muster und schließen Sie unnötige Verzeichnisse aus

Erschöpfung des Kontextfensters

Problem: Bei langen Sitzungen oder komplexen Vorgängen kann sich das Kontextfenster der KI füllen, was die Möglichkeit einschränkt, sich auf frühere Konversationsinhalte zu beziehen.

Strategien zur Abmilderung:

• Nutzen Sie Subagents für explorative Recherchen (nur die Ergebnisse belasten den Hauptkontext)
• Lesen Sie Dateien gezielt mit Zeilenbereichen
• Verwenden Sie grep_file, bevor Sie vollständige Inhalte lesen
• Delegieren Sie Hintergrundaufgaben an den Explorer-Subagent

Keine direkte Systemverwaltung

Kann nicht:

• VS Code-Einstellungen programmatisch ändern
• VS Code-Erweiterungen automatisch installieren
• Konfigurationen auf Systemebene ändern
• VS Code oder Systemdienste neu starten

Umfang: Verdent arbeitet innerhalb des VS Code-Arbeitsbereichs, nicht auf der Ebene der Systemverwaltung.

Keine autonome Ausführung

Manual Accept Mode-Kontrollen:

• Benutzer müssen Werkzeugausführungen in Manual Accept Mode genehmigen
• Keine automatisierten Hintergrundvorgänge ohne Genehmigung
• Kann keine Befehle ausführen, während VS Code geschlossen ist

Zweck: Sicherheit und Benutzerkontrolle über alle Vorgänge.

Keine Echtzeitüberwachung

Kann nicht:

• Laufende Prozesse kontinuierlich überwachen
• Dateisystemänderungen in Echtzeit verfolgen
• Bei Systemereignissen alarmieren
• Protokolldateien kontinuierlich streamen

Alternative: Verwenden Sie MCP-Integrationen für externe Überwachungswerkzeuge.

Keine Netzwerkvorgänge ohne MCP

Integrierte Einschränkungen:

• Kann keine beliebigen HTTP-Anfragen stellen (verwenden Sie web_fetch für bestimmte Seiten)
• Keine direkten Datenbankverbindungen (erfordert MCP)
• Kein direkter Zugriff auf Cloud-Dienste (erfordert MCP)
• Keine Echtzeit-Integrationen für API (erfordert MCP)

Lösung: Konfigurieren Sie MCP-Server für den Zugriff auf externe Systeme.

Bearbeitung von Binärdateien

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

Workarounds:

• Verweisen Sie in bash-Befehlen auf externe Werkzeuge: bash("convert input.png -resize 50% output.png")
• Generieren Sie Skripte, die externe Werkzeuge ausführen können
• Dokumentieren Sie manuelle Schritte für Vorgänge mit Binärdateien

Beispiel:

# Image conversion
bash("convert input.png -resize 50% output.png")

# PDF to text
bash("pdftotext document.pdf output.txt")

Umgang mit großen Dateien

Einschränkung: Dateien mit mehr als 10.000 Zeilen belasten das Kontextfenster

Workarounds:

• Verwenden Sie Zeilenbereiche: file_read("large.log", start_line=1000, max_lines=100)
• Suchen Sie zuerst: grep_content("ERROR", glob="large.log"), um relevante Abschnitte zu finden
• Teilen Sie Dateien in kleinere Module auf, um die Verwaltung zu erleichtern

Erschöpfung des Kontextfensters

Einschränkung: Lange Konversationen füllen das Kontextfenster

Workarounds:

• Delegieren Sie Codebasis-Recherchen an den Explorer-Subagent
• Verwenden Sie den Verifier-Subagent für isolierte Validierungsaufgaben
• Starten Sie für unterschiedliche Aufgaben eine neue Konversation
• Verwenden Sie todo_update, um den Fortschritt über Sitzungen hinweg zu verfolgen

Best Practice: Delegieren Sie Hintergrundrecherchen an Subagents, um den Hauptkontext für die aktive Entwicklung zu bewahren.

Unterschiede bei Plattformbefehlen

Einschränkung: bash-Befehle unterscheiden sich zwischen Windows und Unix

Workarounds:

• Verwenden Sie plattformübergreifende Werkzeuge: npm-Skripte statt rohem bash
• Bedingte Befehle: bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")
• Projektspezifische AGENTS.md mit Plattformhinweisen

Beispiel:

# Cross-platform
bash("npm run build")

# Platform-specific conditional
bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then make; else nmake; fi")