Find Files With Everything

Localizar Arquivos com Everything

Use es.exe como um cliente somente leitura para o índice do Everything em execução. Minimize chamadas de ferramenta e texto retornado.

Roteie a pesquisa

1. Use Test-Path ou Get-Item para um caminho exato conhecido.
2. Use rg --files para nomes de arquivo dentro de um espaço de trabalho conhecido e rg para conteúdo em uma árvore conhecida.
3. Use o Everything primeiro quando a localização for desconhecida, estiver fora do espaço de trabalho, em todo o computador ou com base em metadados indexados.

Execute uma consulta eficiente

1. Verifique a disponibilidade no máximo uma vez por sessão, ou após uma consulta com falha:

   Get-Command es.exe -ErrorAction SilentlyContinue
   

   Caso contrário, execute a pesquisa diretamente. Se o ES estiver ausente ou retornar erro IPC 8, use um fallback de escopo restrito. Não instale, inicie ou repare software a menos que o usuário solicite.

2. Restrinja a consulta antes de aumentar a saída:

   es.exe -n 20 "relatorio"
   es.exe -path "C:\Trabalho" /a-d -n 20 "ext:xlsx"
   es.exe -size -dm -n 20 "size:>1gb"
   

   Use /ad para pastas, /a-d para arquivos, -path para uma subárvore e termos de pesquisa do Everything como ext:, size:, dm: e dc:. Coloque entre aspas caminhos e termos que contenham espaços.

3. Ao invocar do PowerShell 7 ou posterior, coloque -argv primeiro. Omita-o no Windows PowerShell 5.1 e em outros shells.

4. Retorne caminhos simples por padrão. Use -json e colunas extras apenas quando metadados estruturados forem necessários. Use -get-result-count apenas quando a contagem for importante ou uma consulta limitada precisar de refinamento.

5. Mantenha o limite padrão de 20. Se o limite for atingido, refine a consulta antes de solicitar mais resultados. Não exporte resultados para um arquivo a menos que solicitado.

Reporte o resultado

• Retorne o menor conjunto suficiente de caminhos exatos e resuma as correspondências omitidas.
• Declare a consulta ou o escopo quando nenhum resultado for encontrado.
• Trate uma pesquisa com zero resultados como evidência sobre o índice atual do Everything, não como prova de que um local não indexado está vazio.
• Evite content: para uma árvore de projeto conhecida; ele não é indexado por padrão e geralmente é menos eficiente que rg.

Mantenha as pesquisas somente leitura

Não use opções de mudança de estado do ES, como -exit, -reindex, -save-db, configuradores de contagem de execução ou alterações de configurações salvas. Não exclua, mova, copie ou abra resultados a menos que o usuário solicite separadamente essa ação.