DerrickZeng33/find-files-with-everything-cli

Encontrar 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 busca

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

Execute uma consulta eficiente

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

   Get-Command es.exe -ErrorAction SilentlyContinue
   

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

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

   es.exe -n 20 "relatório"
   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 busca 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 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 em 20. Se o limite for atingido, refine a consulta antes de solicitar mais resultados. Não exporte resultados para um arquivo a menos que seja solicitado.

Relate o resultado

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

Mantenha as buscas somente leitura

Não use opções do ES que alteram o estado, 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 essa ação separadamente.