DerrickZeng33/find-files-with-everything-cli

Find Files With Everything

Verwende es.exe als schreibgeschützten Client für den laufenden Everything-Index. Minimiere Tool-Aufrufe und zurückgegebenen Text.

Leite die Suche ein

1. Verwende Test-Path oder Get-Item für einen exakt bekannten Pfad.
2. Verwende rg --files für Dateinamen innerhalb eines bekannten Workspace und rg für Inhalte in einem bekannten Verzeichnisbaum.
3. Verwende Everything zuerst, wenn der Speicherort unbekannt ist, außerhalb des Workspace liegt, computerweit ist oder auf indizierten Metadaten basiert.

Führe eine effiziente Abfrage aus

1. Überprüfe die Verfügbarkeit höchstens einmal pro Sitzung oder nach einer fehlgeschlagenen Abfrage:

   Get-Command es.exe -ErrorAction SilentlyContinue
   

   Führe ansonsten die Suche direkt aus. Falls ES fehlt oder einen IPC-Fehler 8 zurückgibt, verwende einen eng eingegrenzten Fallback. Installiere, starte oder repariere keine Software, es sei denn, der Benutzer fordert dies ausdrücklich an.

2. Grenze die Abfrage ein, bevor du die Ausgabe erhöhst:

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

   Verwende /ad für Ordner, /a-d für Dateien, -path für einen Unterverzeichnisbaum und Everything-Suchbegriffe wie ext:, size:, dm: und dc:. Setze Pfade und Begriffe mit Leerzeichen in Anführungszeichen.

3. Wenn du von PowerShell 7 oder höher aufrufst, setze -argv zuerst. Lasse es in Windows PowerShell 5.1 und anderen Shells weg.

4. Gib standardmäßig einfache Pfade zurück. Verwende -json und zusätzliche Spalten nur, wenn strukturierte Metadaten erforderlich sind. Verwende -get-result-count nur, wenn die Anzahl wichtig ist oder eine begrenzte Abfrage verfeinert werden muss.

5. Behalte das Standardlimit von 20 bei. Wenn das Limit erreicht ist, verfeinere die Abfrage, bevor du weitere Ergebnisse anforderst. Exportiere Ergebnisse nicht in eine Datei, es sei denn, du wirst dazu aufgefordert.

Melde das Ergebnis

• Gib die kleinste ausreichende Menge exakter Pfade zurück und fasse nicht aufgeführte Treffer zusammen.
• Gib die Abfrage oder den Suchbereich an, wenn kein Ergebnis gefunden wurde.
• Behandle ein Ergebnis von null Treffern als Hinweis auf den aktuellen Everything-Index, nicht als Beweis dafür, dass ein nicht indizierter Speicherort leer ist.
• Vermeide content: für einen bekannten Projektbaum; es wird standardmäßig nicht indiziert und ist normalerweise weniger effizient als rg.

Halte Suchen schreibgeschützt

Verwende keine ES-Zustandsänderungsoptionen wie -exit, -reindex, -save-db, Laufzähler-Setter oder Änderungen an gespeicherten Einstellungen. Lösche, verschiebe, kopiere oder öffne keine Ergebnisse, es sei denn, der Benutzer fordert diese Aktion separat an.