Multi File Read Tool (read_many_files)

Dieses Dokument beschreibt das read_many_files Tool für Qwen Code.

Beschreibung

Verwende read_many_files, um Inhalte aus mehreren Dateien zu lesen, die durch Pfade oder Glob-Muster angegeben werden. Das Verhalten dieses Tools hängt von den übergebenen Dateien ab:

• Für Textdateien verbindet dieses Tool deren Inhalt zu einem einzigen String.
• Für Bilddateien (z. B. PNG, JPEG), PDFs, Audiodateien (MP3, WAV) und Videodateien (MP4, MOV) liest es diese ein und gibt sie als base64-kodierte Daten zurück, sofern sie explizit nach Name oder Erweiterung angefordert wurden.

read_many_files kann für Aufgaben wie das Überblicken einer Codebasis, das Finden bestimmter Funktionalität, das Prüfen von Dokumentationen oder das Sammeln von Kontext aus mehreren Konfigurationsdateien verwendet werden.

Hinweis: read_many_files sucht nach Dateien anhand der angegebenen Pfade oder Glob-Muster. Ein Verzeichnispfad wie "/docs" liefert ein leeres Ergebnis; das Tool benötigt ein Muster wie "/docs/*" oder "/docs/*.md", um die relevanten Dateien zu identifizieren.

Argumente

read_many_files akzeptiert die folgenden Argumente:

• paths (list[string], erforderlich): Ein Array von Glob-Patterns oder Pfaden relativ zum Zielverzeichnis des Tools (z. B. ["src/**/*.ts"], ["README.md", "docs/*", "assets/logo.png"]).
• exclude (list[string], optional): Glob-Patterns für Dateien/Verzeichnisse, die ausgeschlossen werden sollen (z. B. ["**/*.log", "temp/"]). Diese werden zu den Standard-Ausschlüssen hinzugefügt, wenn useDefaultExcludes auf true gesetzt ist.
• include (list[string], optional): Zusätzliche Glob-Patterns, die explizit eingeschlossen werden sollen. Diese werden mit paths zusammengeführt (z. B. ["*.test.ts"], um Testdateien gezielt hinzuzufügen, falls sie allgemein ausgeschlossen wurden, oder ["images/*.jpg"], um bestimmte Bildtypen einzuschließen).
• recursive (boolean, optional): Gibt an, ob rekursiv gesucht werden soll. Dies wird hauptsächlich durch ** in den Glob-Patterns gesteuert. Standardwert ist true.
• useDefaultExcludes (boolean, optional): Legt fest, ob eine Liste von Standard-Ausschlussmustern angewendet wird (z. B. node_modules, .git, binäre Dateien, die keine Bilder oder PDFs sind). Standardwert ist true.
• respect_git_ignore (boolean, optional): Bestimmt, ob .gitignore-Muster beim Suchen von Dateien berücksichtigt werden sollen. Standardwert ist true.

Wie man read_many_files mit Qwen Code verwendet

read_many_files sucht nach Dateien, die den angegebenen paths und include-Mustern entsprechen, wobei exclude-Muster und Standard-Ausschlüsse (falls aktiviert) berücksichtigt werden.

• Für Textdateien: liest der Tool den Inhalt jeder gefundenen Datei (und versucht, Binärdateien zu überspringen, es sei denn, sie wurden explizit als Bild/PDF angefordert) und fügt diesen zu einem einzigen String zusammen. Zwischen den Inhalten der einzelnen Dateien wird ein Trennzeichen --- {filePath} --- eingefügt. Standardmäßig wird UTF-8-Encoding verwendet.
• Der Tool fügt nach der letzten Datei ein --- End of content --- hinzu.
• Für Bilder und PDF-Dateien: wenn diese explizit nach Name oder Erweiterung angefordert wurden (z. B. paths: ["logo.png"] oder include: ["*.pdf"]), liest der Tool die Datei und gibt ihren Inhalt als base64-kodierten String zurück.
• Der Tool versucht, andere Binärdateien (die weder gängigen Bild-/PDF-Typen entsprechen noch explizit angefordert wurden) durch Prüfung auf Null-Bytes im Anfangsinhalt zu erkennen und zu überspringen.

Verwendung:

read_many_files(paths=["Deine Dateien oder Pfade hier."], include=["Zusätzliche Dateien zum Einbeziehen."], exclude=["Auszuschließende Dateien."], recursive=False, useDefaultExcludes=false, respect_git_ignore=true)

read_many_files Beispiele

Lese alle TypeScript-Dateien im src Verzeichnis:

read_many_files(paths=["src/**/*.ts"])

Lese die Haupt-README, alle Markdown-Dateien im docs Verzeichnis und ein bestimmtes Logo-Bild, ausschließlich einer bestimmten Datei:

read_many_files(paths=["README.md", "docs/**/*.md", "assets/logo.png"], exclude=["docs/OLD_README.md"])

Lese alle JavaScript-Dateien, aber schließe Testdateien explizit ein und alle JPEGs in einem images Ordner:

read_many_files(paths=["**/*.js"], include=["**/*.test.js", "images/**/*.jpg"], useDefaultExcludes=False)

Wichtige Hinweise

• Umgang mit Binärdateien:
  • Bild-/PDF-/Audio-/Videodateien: Das Tool kann gängige Bildformate (PNG, JPEG, etc.), PDF-, Audio- (mp3, wav) und Videodateien (mp4, mov) lesen und gibt diese als base64-kodierte Daten zurück. Diese Dateien müssen explizit über die paths- oder include-Muster angesprochen werden (z. B. durch Angabe des exakten Dateinamens wie video.mp4 oder eines Musters wie *.mov).
  • Andere Binärdateien: Das Tool versucht, andere Binärdateitypen zu erkennen und überspringt diese, indem es den Anfang der Datei auf null-Bytes prüft. Solche Dateien werden von der Ausgabe ausgeschlossen.
• Performance: Das Lesen einer sehr großen Anzahl an Dateien oder einzelner sehr großer Dateien kann ressourcenintensiv sein.
• Pfadangaben: Stelle sicher, dass Pfade und Glob-Muster korrekt relativ zum Zielverzeichnis des Tools angegeben sind. Bei Bild-/PDF-Dateien sollten die Muster spezifisch genug sein, um diese einzuschließen.
• Standardmäßig ausgeschlossene Pfade: Beachte die standardmäßig ausgeschlossenen Muster (wie node_modules, .git) und verwende useDefaultExcludes=False, wenn du diese überschreiben musst – aber tue dies mit Bedacht.