# Limitations et contraintes (/fr/docs/verdent-for-vscode/help-support/limitations)

> Comprendre les limitations et contraintes de Verdent



### Ce que vous allez apprendre [#ce-que-vous-allez-apprendre]

Les limitations connues de Verdent for VS Code, y compris les restrictions de format de fichier, les contraintes d'outils et les considérations spécifiques à chaque plateforme.

***

## Limitations connues [#limitations-connues]

<Tabs>
  <Tab title="Formats de fichiers">
    ### Les fichiers binaires ne sont pas pris en charge [#les-fichiers-binaires-ne-sont-pas-pris-en-charge]

    Les outils de fichiers de Verdent ne fonctionnent qu'avec des formats textuels. Les éléments suivants ne peuvent pas être modifiés :

    | Type de format       | Exemples                        |
    | -------------------- | ------------------------------- |
    | **Images**           | PNG, JPG, GIF, SVG (en binaire) |
    | **Vidéos**           | MP4, AVI, MOV                   |
    | **Code compilé**     | EXE, DLL, SO                    |
    | **Archives**         | ZIP, TAR, GZ                    |
    | **Documents Office** | DOCX, XLSX, PPTX                |
    | **PDF**              | Fichiers PDF                    |

    **Solution de contournement :** les fichiers binaires peuvent être référencés dans le code ou évoqués de manière conceptuelle, mais leur modification nécessite des outils externes.
  </Tab>

  <Tab title="Contraintes d'outils">
    ### Limites de lignes de file\_read [#limites-de-lignes-de-file_read]

    **Limitation :**

    * Les fichiers volumineux (>10 000 lignes) doivent être lus par sections
    * Lire l'intégralité de fichiers volumineux peut entraîner un épuisement du contexte

    **Solution :** utilisez des plages de lignes : `file_read("file.js", start_line=100, max_lines=50)`

    ***

    ### Délais d'expiration de la commande bash [#délais-dexpiration-de-la-commande-bash]

    **Limitation :**

    * Délai maximal : 120 secondes (2 minutes)
    * Les opérations de longue durée seront automatiquement interrompues

    **Solution :** découpez les opérations en commandes plus petites qui se terminent en moins de 2 minutes

    ***

    ### Performance de recherche [#performance-de-recherche]

    **Limitation :**

    * Des motifs glob larges (`**/*`) peuvent renvoyer des milliers de résultats
    * Les recherches par expression régulière sont plus lentes que les chaînes littérales

    **Solution :** utilisez des motifs spécifiques et excluez les répertoires inutiles
  </Tab>

  <Tab title="Fenêtre de contexte">
    ### Épuisement du contexte [#épuisement-du-contexte]

    **Problème :** lors de sessions longues ou d'opérations complexes, la fenêtre de contexte de l'IA peut se remplir, limitant la capacité à se référer à des échanges antérieurs.

    **Stratégies d'atténuation :**

    * Utilisez des sous-agents pour la recherche exploratoire (seuls les résultats consomment le contexte principal)
    * Lisez les fichiers de manière stratégique avec des plages de lignes
    * Utilisez `grep_file` avant de lire le contenu complet
    * Déléguez les tâches de fond au sous-agent Explorer

    <Tip>
      Pour les fichiers de plus de 500 lignes, utilisez toujours des plages de lignes afin de préserver l'espace de contexte.
    </Tip>
  </Tab>
</Tabs>

***

## Ce que Verdent ne peut pas faire [#ce-que-verdent-ne-peut-pas-faire]

<Tabs>
  <Tab title="Administration système">
    ### Pas d'administration système directe [#pas-dadministration-système-directe]

    **Ne peut pas :**

    * Modifier les paramètres de VS Code de manière programmatique
    * Installer automatiquement des extensions VS Code
    * Modifier des configurations au niveau du système
    * Redémarrer VS Code ou des services système

    **Portée :** Verdent fonctionne au sein de l'espace de travail VS Code, et non au niveau de l'administration système.
  </Tab>

  <Tab title="Exécution autonome">
    ### Pas d'exécution autonome [#pas-dexécution-autonome]

    **Contrôles Manual Accept Mode :**

    * Les utilisateurs doivent approuver les exécutions d'outils dans Manual Accept Mode
    * Aucune opération automatisée en arrière-plan sans approbation
    * Impossible d'exécuter des commandes lorsque VS Code est fermé

    **Objectif :** la sécurité et le contrôle de l'utilisateur sur toutes les opérations.

    <Warning>
      Verdent ne peut pas exécuter de commandes en arrière-plan sans l'approbation de l'utilisateur. Toutes les opérations nécessitent un consentement explicite dans Manual Accept Mode.
    </Warning>
  </Tab>

  <Tab title="Surveillance en temps réel">
    ### Pas de surveillance en temps réel [#pas-de-surveillance-en-temps-réel]

    **Ne peut pas :**

    * Surveiller en continu les processus en cours d'exécution
    * Suivre les modifications du système de fichiers en temps réel
    * Alerter sur les événements système
    * Diffuser en continu des fichiers journaux

    **Alternative :** utilisez les intégrations MCP pour des outils de surveillance externes.
  </Tab>

  <Tab title="Opérations réseau">
    ### Pas d'opérations réseau sans MCP [#pas-dopérations-réseau-sans-mcp]

    **Limitations intégrées :**

    * Impossible d'effectuer des requêtes HTTP arbitraires (utilisez `web_fetch` pour des pages spécifiques)
    * Aucune connexion directe à une base de données (nécessite MCP)
    * Impossible d'accéder directement aux services cloud (nécessite MCP)
    * Aucune intégration API en temps réel (nécessite MCP)

    **Solution :** configurez des serveurs MCP pour l'accès à des systèmes externes.
  </Tab>
</Tabs>

***

## Restrictions spécifiques à chaque plateforme [#restrictions-spécifiques-à-chaque-plateforme]

### Différences entre systèmes d'exploitation [#différences-entre-systèmes-dexploitation]

**Comportement de l'outil bash :**

| Plateforme      | Shell      | Remarques                                                                   |
| --------------- | ---------- | --------------------------------------------------------------------------- |
| **macOS/Linux** | bash/zsh   | Fonctionnalités bash complètes                                              |
| **Windows**     | PowerShell | Certaines commandes bash indisponibles, utilisez les équivalents PowerShell |
| **WSL**         | bash       | Les commandes Linux fonctionnent dans l'environnement WSL                   |

**Gestion des chemins :**

* Windows utilise des barres obliques inverses (`\`), Unix utilise des barres obliques (`/`)
* Les chemins de fichiers peuvent nécessiter des ajustements pour les projets multiplateformes

***

### Exigences de version VS Code [#exigences-de-version-vs-code]

**Exigences minimales :**

* Compatibilité de version VS Code (consultez la marketplace d'extensions pour connaître la version minimale actuelle)
* Espace disque suffisant pour la mise en cache du contexte

<Info>
  Les exigences de version spécifiques sont maintenues dans la fiche de la marketplace VS Code. Consultez les détails de l'extension pour connaître la compatibilité actuelle.
</Info>

***

### Contraintes d'espace de travail [#contraintes-despace-de-travail]

**Focus sur un seul espace de travail :**

* Verdent fonctionne au sein d'un seul espace de travail VS Code à la fois
* Impossible de modifier simultanément des fichiers dans plusieurs fenêtres VS Code ouvertes
* Les espaces de travail multi-racines sont pris en charge, mais le contexte est limité à l'espace de travail actif actuel

***

## Solutions de contournement pour les limitations courantes [#solutions-de-contournement-pour-les-limitations-courantes]

<Tabs>
  <Tab title="Fichiers binaires">
    ### Modification de fichiers binaires [#modification-de-fichiers-binaires]

    **Limitation :** impossible de modifier des images, des PDF ou des binaires compilés

    **Solutions de contournement :**

    * Référencez des outils externes dans les commandes bash : `bash("convert input.png -resize 50% output.png")`
    * Générez des scripts que des outils externes peuvent exécuter
    * Documentez les étapes manuelles pour les opérations sur fichiers binaires

    **Exemple :**

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

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

  <Tab title="Fichiers volumineux">
    ### Gestion des fichiers volumineux [#gestion-des-fichiers-volumineux]

    **Limitation :** les fichiers de plus de 10 000 lignes sollicitent fortement la fenêtre de contexte

    **Solutions de contournement :**

    * Utilisez des plages de lignes : `file_read("large.log", start_line=1000, max_lines=100)`
    * Effectuez d'abord une recherche : `grep_content("ERROR", glob="large.log")` pour trouver les sections pertinentes
    * Découpez les fichiers en modules plus petits pour une gestion plus facile

    <Tip>
      Utilisez toujours `grep_content` en premier pour identifier les sections pertinentes, puis ne lisez que ces plages de lignes spécifiques.
    </Tip>
  </Tab>

  <Tab title="Fenêtre de contexte">
    ### Épuisement de la fenêtre de contexte [#épuisement-de-la-fenêtre-de-contexte]

    **Limitation :** les conversations longues remplissent la fenêtre de contexte

    **Solutions de contournement :**

    * Déléguez la recherche dans la base de code au sous-agent Explorer
    * Utilisez le sous-agent Verifier pour des tâches de validation isolées
    * Démarrez une nouvelle conversation pour des tâches distinctes
    * Utilisez `todo_update` pour suivre la progression d'une session à l'autre

    **Bonne pratique :** déléguez la recherche en arrière-plan à des sous-agents pour préserver le contexte principal pour le développement actif.
  </Tab>

  <Tab title="Différences de plateforme">
    ### Différences de commandes selon la plateforme [#différences-de-commandes-selon-la-plateforme]

    **Limitation :** les commandes bash diffèrent entre Windows et Unix

    **Solutions de contournement :**

    * Utilisez des outils multiplateformes : des scripts npm plutôt que du bash brut
    * Commandes conditionnelles : `bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")`
    * Un fichier AGENTS.md spécifique au projet avec des notes sur les plateformes

    **Exemple :**

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

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

***

## Améliorations futures [#améliorations-futures]

<Note>
  Les limitations sont traitées en permanence. Consultez les notes de version de Verdent pour connaître les mises à jour concernant les capacités élargies, l'augmentation des limites et les nouvelles intégrations.
</Note>

***

## Voir aussi [#voir-aussi]

<CardGroup cols="2">
  <Card title="Référence des outils" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Capacités complètes des outils
  </Card>

  <Card title="Bonnes pratiques" icon="lightbulb" href="/docs/verdent-for-vscode/best-practices/prompts">
    Optimiser l'utilisation de Verdent
  </Card>
</CardGroup>
