Limitations et contraintes

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 :

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.

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

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

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

É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

Pas d'administration 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.

Pas d'exé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.

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.

Pas d'opé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.

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 :

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

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

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

É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.

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 :

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

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