Multi File Read Tool (read_many_files
)
Ce document décrit l’outil read_many_files
pour Qwen Code.
Description
Utilisez read_many_files
pour lire le contenu de plusieurs fichiers spécifiés par des chemins ou des patterns glob. Le comportement de cet outil dépend des fichiers fournis :
- Pour les fichiers texte, cet outil concatène leur contenu en une seule chaîne.
- Pour les fichiers image (ex. : PNG, JPEG), PDF, audio (MP3, WAV) et vidéo (MP4, MOV), il les lit et les retourne encodés en base64, à condition qu’ils soient explicitement demandés par nom ou extension.
read_many_files
peut être utilisé pour effectuer des tâches telles qu’obtenir un aperçu d’une base de code, trouver où une fonctionnalité spécifique est implémentée, examiner de la documentation ou rassembler du contexte à partir de plusieurs fichiers de configuration.
Note : read_many_files
recherche les fichiers correspondant aux chemins ou patterns glob fournis. Un chemin de répertoire tel que "/docs"
renverra un résultat vide ; l’outil nécessite un pattern tel que "/docs/*"
ou "/docs/*.md"
pour identifier les fichiers concernés.
Arguments
read_many_files
prend les arguments suivants :
paths
(list[string], requis) : Un tableau de glob patterns ou de chemins relatifs au répertoire cible de l’outil (ex :["src/**/*.ts"]
,["README.md", "docs/*", "assets/logo.png"]
).exclude
(list[string], optionnel) : Des glob patterns pour les fichiers/répertoires à exclure (ex :["**/*.log", "temp/"]
). Ceux-ci sont ajoutés aux exclusions par défaut siuseDefaultExcludes
est àtrue
.include
(list[string], optionnel) : Des glob patterns supplémentaires à inclure. Ceux-ci sont fusionnés avecpaths
(ex :["*.test.ts"]
pour inclure spécifiquement les fichiers de test s’ils ont été globalement exclus, ou["images/*.jpg"]
pour inclure certains types d’images).recursive
(boolean, optionnel) : Indique s’il faut effectuer une recherche récursive. Cette option est principalement contrôlée par**
dans les glob patterns. Valeur par défaut :true
.useDefaultExcludes
(boolean, optionnel) : Indique s’il faut appliquer une liste de patterns d’exclusion par défaut (ex :node_modules
,.git
, fichiers binaires non image/PDF). Valeur par défaut :true
.respect_git_ignore
(boolean, optionnel) : Indique s’il faut respecter les patterns définis dans le.gitignore
lors de la recherche des fichiers. Valeur par défaut :true
.
Comment utiliser read_many_files
avec Qwen Code
read_many_files
recherche les fichiers correspondant aux paths
et include
fournis, tout en respectant les patterns exclude
et les exclusions par défaut (si activées).
- Pour les fichiers texte : il lit le contenu de chaque fichier correspondant (en tentant de sauter les fichiers binaires non explicitement demandés comme image/PDF) et les concatène en une seule chaîne, avec un séparateur
--- {filePath} ---
entre le contenu de chaque fichier. Utilise l’encodage UTF-8 par défaut. - Pour les fichiers image et PDF : si explicitement demandés par nom ou extension (ex :
paths: ["logo.png"]
ouinclude: ["*.pdf"]
), l’outil lit le fichier et retourne son contenu sous forme de chaîne encodée en base64. - L’outil tente de détecter et ignorer les autres fichiers binaires (ceux ne correspondant pas aux types image/PDF courants ou non explicitement demandés) en vérifiant la présence d’octets null dans leur contenu initial.
Utilisation :
read_many_files(paths=["Vos fichiers ou chemins ici."], include=["Fichiers supplémentaires à inclure."], exclude=["Fichiers à exclure."], recursive=False, useDefaultExcludes=false, respect_git_ignore=true)
Exemples read_many_files
Lire tous les fichiers TypeScript dans le répertoire src
:
read_many_files(paths=["src/**/*.ts"])
Lire le README principal, tous les fichiers Markdown dans le répertoire docs
, et une image logo spécifique, en excluant un fichier particulier :
read_many_files(paths=["README.md", "docs/**/*.md", "assets/logo.png"], exclude=["docs/OLD_README.md"])
Lire tous les fichiers JavaScript mais inclure explicitement les fichiers de test et tous les JPEGs dans un dossier images
:
read_many_files(paths=["**/*.js"], include=["**/*.test.js", "images/**/*.jpg"], useDefaultExcludes=False)
Notes importantes
- Gestion des fichiers binaires :
- Fichiers image/PDF/audio/vidéo : L’outil peut lire les types d’images courants (PNG, JPEG, etc.), les fichiers PDF, audio (mp3, wav) et vidéo (mp4, mov), et les retourner en tant que données encodées en base64. Ces fichiers doivent être ciblés explicitement par les motifs
paths
ouinclude
(par exemple, en spécifiant le nom exact du fichier commevideo.mp4
ou un motif comme*.mov
). - Autres fichiers binaires : L’outil tente de détecter et d’ignorer les autres types de fichiers binaires en examinant leur contenu initial à la recherche d’octets nuls. L’outil exclut ces fichiers de sa sortie.
- Fichiers image/PDF/audio/vidéo : L’outil peut lire les types d’images courants (PNG, JPEG, etc.), les fichiers PDF, audio (mp3, wav) et vidéo (mp4, mov), et les retourner en tant que données encodées en base64. Ces fichiers doivent être ciblés explicitement par les motifs
- Performance : La lecture d’un très grand nombre de fichiers ou de fichiers individuels très volumineux peut être gourmande en ressources.
- Spécificité des chemins : Assurez-vous que les chemins et les motifs glob sont correctement spécifiés par rapport au répertoire cible de l’outil. Pour les fichiers image/PDF, veillez à ce que les motifs soient suffisamment précis pour les inclure.
- Exclusions par défaut : Soyez conscient des motifs d’exclusion par défaut (comme
node_modules
,.git
) et utilisezuseDefaultExcludes=False
si vous devez les outrepasser, mais faites-le avec prudence.