DerrickZeng33/find-files-with-everything-cli

Find Files With Everything (Buscar archivos con Everything)

Usa es.exe como cliente de solo lectura para el índice en ejecución de Everything. Minimiza las llamadas a herramientas y el texto devuelto.

Enrutar la búsqueda

1. Usa Test-Path o Get-Item para una ruta exacta conocida.
2. Usa rg --files para nombres de archivo dentro de un espacio de trabajo conocido y rg para contenido en un árbol conocido.
3. Usa Everything primero cuando la ubicación sea desconocida, esté fuera del espacio de trabajo, sea a nivel de equipo o esté basada en metadatos indexados.

Ejecutar una consulta eficiente

1. Verifica la disponibilidad como máximo una vez por sesión, o después de una consulta fallida:

   Get-Command es.exe -ErrorAction SilentlyContinue
   

   De lo contrario, ejecuta la búsqueda directamente. Si ES falta o devuelve el error IPC 8, usa una alternativa de alcance limitado. No instales, inicies ni repares software a menos que el usuario lo solicite.

2. Limita la consulta antes de aumentar la salida:

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

   Usa /ad para carpetas, /a-d para archivos, -path para un subárbol y términos de búsqueda de Everything como ext:, size:, dm: y dc:. Pon entre comillas las rutas y términos que contengan espacios.

3. Al invocar desde PowerShell 7 o posterior, coloca -argv primero. Omítelo en Windows PowerShell 5.1 y otros shells.

4. Devuelve rutas simples por defecto. Usa -json y columnas adicionales solo cuando se requieran metadatos estructurados. Usa -get-result-count solo cuando el número importe o una consulta limitada necesite refinamiento.

5. Mantén el límite predeterminado en 20. Si se alcanza el límite, refina la consulta antes de solicitar más resultados. No exportes resultados a un archivo a menos que se solicite.

Informar el resultado

• Devuelve el conjunto mínimo suficiente de rutas exactas y resume las coincidencias omitidas.
• Indica la consulta o el alcance cuando no se encuentre ningún resultado.
• Trata una búsqueda sin resultados como evidencia sobre el índice actual de Everything, no como prueba de que una ubicación no indexada esté vacía.
• Evita content: para un árbol de proyecto conocido; no está indexado por defecto y suele ser menos eficiente que rg.

Mantén las búsquedas de solo lectura

No uses opciones de ES que cambien el estado, como -exit, -reindex, -save-db, modificadores de recuento de ejecuciones o cambios de configuración guardados. No elimines, muevas, copies ni abras resultados a menos que el usuario lo solicite explícitamente.