Ferramenta de Leitura de Múltiplos Arquivos (read_many_files)

Este documento descreve a ferramenta read_many_files para o Qwen Code.

Descrição

Use read_many_files para ler o conteúdo de vários arquivos especificados por caminhos ou padrões glob. O comportamento desta ferramenta depende dos arquivos fornecidos:

• Para arquivos de texto, esta ferramenta concatena o conteúdo em uma única string.
• Para arquivos de imagem (por exemplo, PNG, JPEG), PDF, áudio (MP3, WAV) e vídeo (MP4, MOV), ela lê e retorna os dados codificados em base64, desde que sejam solicitados explicitamente por nome ou extensão.

O read_many_files pode ser usado para realizar tarefas como obter uma visão geral de uma base de código, localizar onde uma funcionalidade específica é implementada, revisar documentação ou reunir contexto de vários arquivos de configuração.

Nota: O read_many_files procura arquivos seguindo os caminhos ou padrões glob fornecidos. Um caminho de diretório como "/docs" retornará um resultado vazio; a ferramenta requer um padrão como "/docs/*" ou "/docs/*.md" para identificar os arquivos relevantes.

Argumentos

O read_many_files aceita os seguintes argumentos:

• paths (list[string], obrigatório): Um array de padrões glob ou caminhos relativos ao diretório de destino da ferramenta (por exemplo, ["src/**/*.ts"], ["README.md", "docs/*", "assets/logo.png"]).
• exclude (list[string], opcional): Padrões glob para arquivos/diretórios a serem excluídos (por exemplo, ["**/*.log", "temp/"]). Eles são adicionados às exclusões padrão se useDefaultExcludes for true.
• include (list[string], opcional): Padrões glob adicionais para incluir. Eles são mesclados com paths (por exemplo, ["*.test.ts"] para adicionar especificamente arquivos de teste se eles foram amplamente excluídos, ou ["images/*.jpg"] para incluir tipos específicos de imagem).
• recursive (boolean, opcional): Indica se a busca deve ser recursiva. Isso é controlado principalmente por ** nos padrões glob. O padrão é true.
• useDefaultExcludes (boolean, opcional): Indica se deve aplicar uma lista de padrões de exclusão padrão (por exemplo, node_modules, .git, arquivos binários que não sejam imagem/PDF). O padrão é true.
• respect_git_ignore (boolean, opcional): Indica se deve respeitar os padrões do .gitignore ao localizar arquivos. O padrão é true.

Como usar read_many_files com o Qwen Code

O read_many_files procura arquivos que correspondem aos padrões paths e include fornecidos, respeitando os padrões exclude e as exclusões padrão (se habilitadas).

• Para arquivos de texto: lê o conteúdo de cada arquivo correspondente (tentando ignorar arquivos binários não solicitados explicitamente como imagem/PDF) e o concatena em uma única string, com um separador --- {filePath} --- entre o conteúdo de cada arquivo. Usa codificação UTF-8 por padrão.
• A ferramenta insere um --- End of content --- após o último arquivo.
• Para arquivos de imagem e PDF: se solicitados explicitamente por nome ou extensão (por exemplo, paths: ["logo.png"] ou include: ["*.pdf"]), a ferramenta lê o arquivo e retorna seu conteúdo como uma string codificada em base64.
• A ferramenta tenta detectar e ignorar outros arquivos binários (aqueles que não correspondem a tipos comuns de imagem/PDF ou não foram solicitados explicitamente) verificando a presença de bytes nulos no conteúdo inicial.

Uso:

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)

Exemplos de read_many_files

Ler todos os arquivos TypeScript no diretório src:

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

Ler o README principal, todos os arquivos Markdown no diretório docs e uma imagem de logotipo específica, excluindo um arquivo específico:

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

Ler todos os arquivos JavaScript, mas incluir explicitamente arquivos de teste e todos os JPEGs em uma pasta images:

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

Notas importantes

• Manipulação de arquivos binários:
  • Arquivos de imagem/PDF/áudio/vídeo: A ferramenta pode ler tipos comuns de imagem (PNG, JPEG, etc.), PDF, áudio (mp3, wav) e vídeo (mp4, mov), retornando-os como dados codificados em base64. Esses arquivos devem ser explicitamente direcionados pelos padrões paths ou include (por exemplo, especificando o nome exato do arquivo como video.mp4 ou um padrão como *.mov).
  • Outros arquivos binários: A ferramenta tenta detectar e ignorar outros tipos de arquivos binários examinando o conteúdo inicial em busca de bytes nulos. A ferramenta exclui esses arquivos da saída.
• Desempenho: Ler um número muito grande de arquivos ou arquivos individuais muito grandes pode ser intensivo em recursos.
• Especificidade do caminho: Certifique-se de que os caminhos e padrões glob estejam especificados corretamente em relação ao diretório de destino da ferramenta. Para arquivos de imagem/PDF, verifique se os padrões são específicos o suficiente para incluí-los.
• Exclusões padrão: Esteja ciente dos padrões de exclusão padrão (como node_modules, .git) e use useDefaultExcludes=False se precisar substituí-los, mas faça isso com cautela.