Multi File Read Tool (read_many_files)

このドキュメントでは、Qwen Code 用の read_many_files ツールについて説明します。

説明

read_many_files を使用して、パスまたは glob パターンで指定された複数のファイルからコンテンツを読み取ります。このツールの動作は、提供されたファイルによって異なります：

• テキストファイルの場合、このツールはそのコンテンツを1つの文字列に連結します。
• 画像（PNG、JPEGなど）、PDF、音声（MP3、WAV）、動画（MP4、MOV）ファイルの場合、ファイル名または拡張子で明示的に要求された場合に限り、base64エンコードされたデータとして読み込んで返します。

read_many_files は、コードベースの概要を取得したり、特定の機能が実装されている場所を見つけたり、ドキュメントをレビューしたり、複数の設定ファイルからコンテキストを収集したりするなどのタスクを実行するために使用できます。

注意： read_many_files は、提供されたパスまたは glob パターンに従ってファイルを検索します。"/docs" のようなディレクトリパスは空の結果を返します。関連するファイルを識別するには、"/docs/*" や "/docs/*.md" のようなパターンが必要です。

引数

read_many_files は以下の引数を取ります：

• paths (list[string], 必須): glob パターンまたはツールのターゲットディレクトリからの相対パスの配列（例：["src/**/*.ts"]、["README.md", "docs/*", "assets/logo.png"]）。
• exclude (list[string], 任意): 除外するファイル/ディレクトリの glob パターン（例：["**/*.log", "temp/"]）。useDefaultExcludes が true の場合、これらはデフォルトの除外リストに追加されます。
• include (list[string], 任意): 追加で含める glob パターン。これらは paths とマージされます（例：広範囲で除外された場合にテストファイルを明示的に追加する ["*.test.ts"] や、特定の画像形式を含める ["images/*.jpg"]）。
• recursive (boolean, 任意): 再帰的に検索するかどうか。これは主に glob パターン内の ** によって制御されます。デフォルトは true。
• useDefaultExcludes (boolean, 任意): デフォルトの除外パターンのリスト（例：node_modules、.git、画像/PDF 以外のバイナリファイル）を適用するかどうか。デフォルトは true。
• respect_git_ignore (boolean, 任意): ファイル検索時に .gitignore パターンを尊重するかどうか。デフォルトは true。

Qwen Code での read_many_files の使い方

read_many_files は、指定された paths および include パターンに一致するファイルを検索します。このとき、exclude パターンとデフォルトの除外設定（有効な場合）も考慮されます。

• テキストファイルの場合: 各一致したファイルの内容を読み込み（明示的に画像/PDFとしてリクエストされていないバイナリファイルはスキップ）、各ファイルの内容間に区切り文字 --- {filePath} --- を挿入して1つの文字列に結合します。デフォルトでは UTF-8 エンコーディングを使用します。
• ツールは最後のファイルの後に --- End of content --- を挿入します。
• 画像およびPDFファイルの場合: 名前または拡張子で明示的にリクエストされた場合（例: paths: ["logo.png"] や include: ["*.pdf"]）、ファイルを読み込んでその内容を base64 エンコードされた文字列として返します。
• その他のバイナリファイル（一般的な画像/PDF形式に一致せず、明示的にリクエストもされていないもの）については、ツールは先頭部分の内容に null バイトが含まれているかをチェックし、検出された場合はスキップを試みます。

使用方法:

read_many_files(paths=["Your files or paths here."], include=["Additional files to include."], exclude=["Files to exclude."], recursive=False, useDefaultExcludes=false, respect_git_ignore=true)

read_many_files の例

src ディレクトリ内のすべての TypeScript ファイルを読み込む：

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

メインの README、docs ディレクトリ内のすべての Markdown ファイル、および特定のロゴ画像を読み込み、特定のファイルを除外する：

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

すべての JavaScript ファイルを読み込むが、明示的にテストファイルと images フォルダ内のすべての JPEG を含める：

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

重要な注意事項

• バイナリファイルの取り扱い:
  • 画像/PDF/音声/動画ファイル: このツールは一般的な画像形式（PNG、JPEGなど）、PDF、音声（mp3、wav）、動画（mp4、mov）ファイルを読み込み、base64エンコードされたデータとして返すことができます。これらのファイルは、pathsまたはincludeパターンで明示的に指定する必要があります（例：video.mp4のような具体的なファイル名や*.movのようなパターン）。
  • その他のバイナリファイル: ツールは、ファイルの先頭部分にnullバイトが含まれているかをチェックすることで、その他のバイナリファイルを検出し、スキップしようとします。これらのファイルはツールの出力から除外されます。
• パフォーマンス: 多数のファイルや非常に大きなサイズの個別ファイルを読み込む場合、リソース消費が大きくなる可能性があります。
• パスの指定: パスおよびglobパターンは、ツールの対象ディレクトリからの相対パスとして正しく指定してください。画像/PDFファイルについては、それらを確実に含めるために十分な specificity を持ったパターンを使用してください。
• デフォルトの除外設定: デフォルトの除外パターン（node_modules、.gitなど）があることを認識しておき、必要に応じてuseDefaultExcludes=Falseで上書きできますが、その際は慎重に行ってください。