DerrickZeng33/find-files-with-everything-cli

Find Files With Everything

使用 es.exe 作為執行中 Everything 索引的唯讀客戶端。最小化工具呼叫次數與回傳文字量。

路由搜尋

1. 對於確切已知路徑，使用 Test-Path 或 Get-Item。
2. 在已知工作區內搜尋檔名時使用 rg --files，在已知樹狀結構中搜尋內容時使用 rg。
3. 當位置未知、在工作區外、全電腦範圍或需依索引中繼資料查詢時，優先使用 Everything。

執行高效查詢

1. 每個工作階段最多檢查一次可用性，或在查詢失敗後檢查：

   Get-Command es.exe -ErrorAction SilentlyContinue
   

   否則直接執行搜尋。若 ES 缺失或回傳 IPC 錯誤 8，則使用範圍限縮的後備方案。除非使用者要求，否則請勿安裝、啟動或修復軟體。

2. 在增加輸出量之前先縮小查詢範圍：

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

   使用 /ad 表示資料夾，/a-d 表示檔案，-path 指定子樹狀路徑，以及 Everything 搜尋詞句如 ext:、size:、dm: 和 dc:。若路徑或詞句包含空格請加上引號。

3. 從 PowerShell 7 或更新版本呼叫時，請將 -argv 放在最前面。在 Windows PowerShell 5.1 及其他 Shell 中請省略。

4. 預設回傳純文字路徑。僅在需要結構化中繼資料時才使用 -json 及額外欄位。僅在計數重要或需要調整上限查詢時才使用 -get-result-count。

5. 維持預設上限為 20。若達到上限，請在要求更多結果之前先精煉查詢。除非被要求，否則請勿將結果匯出至檔案。

回報結果

• 回傳最小且足夠的精確路徑集合，並總結省略的匹配項。
• 若無結果，請說明查詢內容或範圍。
• 將零結果搜尋視為關於目前 Everything 索引的證據，而非未索引位置為空的證明。
• 避免對已知專案樹狀結構使用 content:，因為它預設未被索引，且通常效率低於 rg。

保持搜尋為唯讀

請勿使用 ES 的狀態變更選項，例如 -exit、-reindex、-save-db、執行計數設定器或已儲存設定變更。除非使用者另有要求，否則請勿刪除、移動、複製或開啟結果。