# Einschränkungen & Beschränkungen (/de/docs/verdent-for-vscode/help-support/limitations)

> Die Einschränkungen und Beschränkungen von Verdent verstehen



### Das lernen Sie [#das-lernen-sie]

Bekannte Einschränkungen von Verdent for VS Code, einschließlich Dateiformatbeschränkungen, Werkzeugbeschränkungen und plattformspezifischer Besonderheiten.

***

## Bekannte Einschränkungen [#bekannte-einschränkungen]

<Tabs>
  <Tab title="Dateiformate">
    ### Binärdateien werden nicht unterstützt [#binärdateien-werden-nicht-unterstützt]

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

    | Formattyp             | Beispiele                           |
    | --------------------- | ----------------------------------- |
    | **Bilder**            | PNG, JPG, GIF, SVG (als Binärdatei) |
    | **Videos**            | MP4, AVI, MOV                       |
    | **Kompilierter Code** | EXE, DLL, SO                        |
    | **Archive**           | ZIP, TAR, GZ                        |
    | **Office-Dokumente**  | DOCX, XLSX, PPTX                    |
    | **PDFs**              | PDF-Dateien                         |

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

  <Tab title="Werkzeugbeschränkungen">
    ### Zeilenlimits für file\_read [#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 [#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 [#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
  </Tab>

  <Tab title="Kontextfenster">
    ### Erschöpfung des Kontextfensters [#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

    <Tip>
      Verwenden Sie bei Dateien mit mehr als 500 Zeilen immer Zeilenbereiche, um Kontextraum zu sparen.
    </Tip>
  </Tab>
</Tabs>

***

## Was Verdent nicht kann [#was-verdent-nicht-kann]

<Tabs>
  <Tab title="Systemverwaltung">
    ### Keine direkte Systemverwaltung [#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.
  </Tab>

  <Tab title="Autonome Ausführung">
    ### Keine autonome Ausführung [#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.

    <Warning>
      Verdent kann Befehle nicht ohne Genehmigung des Benutzers im Hintergrund ausführen. Alle Vorgänge erfordern eine ausdrückliche Zustimmung in Manual Accept Mode.
    </Warning>
  </Tab>

  <Tab title="Echtzeitüberwachung">
    ### Keine Echtzeitüberwachung [#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.
  </Tab>

  <Tab title="Netzwerkvorgänge">
    ### Keine Netzwerkvorgänge ohne MCP [#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.
  </Tab>
</Tabs>

***

## Plattformspezifische Einschränkungen [#plattformspezifische-einschränkungen]

### Unterschiede zwischen Betriebssystemen [#unterschiede-zwischen-betriebssystemen]

**Verhalten des bash-Werkzeugs:**

| Plattform       | Shell      | Hinweise                                                                  |
| --------------- | ---------- | ------------------------------------------------------------------------- |
| **macOS/Linux** | bash/zsh   | Vollständige bash-Funktionalität                                          |
| **Windows**     | PowerShell | Einige bash-Befehle nicht verfügbar, verwenden Sie PowerShell-Äquivalente |
| **WSL**         | bash       | Linux-Befehle funktionieren in der WSL-Umgebung                           |

**Umgang mit Pfaden:**

* Windows verwendet Backslashes (`\`), Unix verwendet Schrägstriche (`/`)
* Dateipfade müssen bei plattformübergreifenden Projekten möglicherweise angepasst werden

***

### VS Code-Versionsanforderungen [#vs-code-versionsanforderungen]

**Mindestanforderungen:**

* Kompatibilität mit der VS Code-Version (prüfen Sie den Erweiterungs-Marktplatz auf die aktuelle Mindestversion)
* Ausreichender Speicherplatz für das Zwischenspeichern des Kontexts

<Info>
  Spezifische Versionsanforderungen werden im Eintrag des VS Code-Marktplatzes gepflegt. Prüfen Sie die Erweiterungsdetails auf die aktuelle Kompatibilität.
</Info>

***

### Beschränkungen des Arbeitsbereichs [#beschränkungen-des-arbeitsbereichs]

**Fokus auf einen einzelnen Arbeitsbereich:**

* Verdent arbeitet jeweils innerhalb eines VS Code-Arbeitsbereichs
* Kann nicht gleichzeitig Dateien über mehrere geöffnete VS Code-Fenster hinweg ändern
* Arbeitsbereiche mit mehreren Root-Verzeichnissen werden unterstützt, der Kontext ist jedoch auf den aktuell aktiven Arbeitsbereich beschränkt

***

## Workarounds für häufige Einschränkungen [#workarounds-für-häufige-einschränkungen]

<Tabs>
  <Tab title="Binärdateien">
    ### Bearbeitung von Binärdateien [#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:**

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

    # PDF to text
    bash("pdftotext document.pdf output.txt")
    ```
  </Tab>

  <Tab title="Große Dateien">
    ### Umgang mit großen Dateien [#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

    <Tip>
      Verwenden Sie immer zuerst `grep_content`, um relevante Abschnitte zu identifizieren, und lesen Sie dann nur diese bestimmten Zeilenbereiche.
    </Tip>
  </Tab>

  <Tab title="Kontextfenster">
    ### Erschöpfung des Kontextfensters [#erschöpfung-des-kontextfensters-1]

    **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.
  </Tab>

  <Tab title="Plattformunterschiede">
    ### Unterschiede bei Plattformbefehlen [#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:**

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

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

***

## Zukünftige Verbesserungen [#zukünftige-verbesserungen]

<Note>
  Einschränkungen werden kontinuierlich bearbeitet. Sehen Sie in den Versionshinweisen von Verdent nach, um Updates zu erweiterten Funktionen, erhöhten Limits und neuen Integrationen zu erhalten.
</Note>

***

## Siehe auch [#siehe-auch]

<CardGroup cols="2">
  <Card title="Werkzeugreferenz" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Vollständige Werkzeugfunktionen
  </Card>

  <Card title="Best Practices" icon="lightbulb" href="/docs/verdent-for-vscode/best-practices/prompts">
    Nutzung von Verdent optimieren
  </Card>
</CardGroup>
