DerrickZeng33/find-files-with-everything

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、執行計數設定器或已儲存設定變更。除非使用者另外要求，否則不要刪除、移動、複製或開啟搜尋結果。