搜尋語法

Lertaro 的搜尋框支援模糊跳躍比對、邏輯運算符、詞邊界修飾符、磁碟機與路徑鎖定、二次篩選標記（Query Tokens）以及多語言智能別名，所有語法均可在同一條查詢中自由混合使用。

1. 基礎比對模式與大小寫

模糊匹配（預設）

Lertaro 預設啟用模糊比對（Fuzzy Matching）。只需輸入關鍵字的任意部分，只要字元按先後順序出現在檔案或資料夾名稱中，即使不連續也能精準命中：

輸入範例	比對結果範例	說明
ltro	Lertaro.exe	字元按 l → t → r → o 順序跳躍命中（Lertaro.exe）
vsc	Visual Studio Code.lnk	命中各單詞首字母（Visual Studio Code）
rt-fin	Q3-report-final.docx	命中連續子字串（Q3-report-final.docx）

在設定 → 一般 → 系統 → 啟用模糊比對中關閉該開關後，普通搜尋詞（未附加任何操作符）將轉為精確子字串比對，輸入 abc 將只比對包含連續 abc 的名稱，不再比對 a-b-c。該開關僅改變未帶修飾符的普通詞，後文介紹的所有操作符行為均保持一致。

結果如何排序

結果首先按輸入內容在名稱中怎樣命中來排序，然後才看命中從哪裏開始：

1. 完整單詞：atlas 命中 atlas、code-atlas、atlas.png 和 CodeAtlas。單詞的開頭是：名稱開頭，空格、-、_、. 或路徑分隔符之後，小寫轉大寫處，以及字母與數字的交界處。
2. 單詞開頭：atlasing。
3. 單詞中間：metatlas.txt。
4. 零散字母：像 AutofillStates（AutofillStates）這樣的模糊命中總是排在最後。

同一組內：

• 最近建立或修改的排在前面，按時段分檔：今天、過去一星期、過去一個月、更早。建立時間和修改時間取較晚的那個，所以剛複製或下載的檔案也算新的。
• 其次是路徑更淺的：D:\dev\code-atlas 排在同名命中之前，那命中埋在遊戲或套件資料夾深處十層。
• 再其次是命中起點更靠左的，然後是更緊湊完整的命中。

其餘都相同時，檔案排在資料夾之前（內嵌視窗的目前資料夾列表仍像檔案總管一樣資料夾在前）。有多個搜尋詞時，由最弱的那個詞決定分組。

在所有搜尋視窗中，明確置頂與單調證據等級共同保證排序符合直覺：

1. 明確置頂優先：標記為高優先級 + 始終置頂的規則，以及乾淨命中的我的最愛項目固定排在最前；系統快取與 Low（低優先級） 目錄始終排在一般結果之後。
2. 直接命中優先於別名與學習關聯：完整與乾淨的標題/檔案名稱直接命中始終排在跳躍模糊命中、乾淨次要別名（捷徑目標、應用程式元資料，副標題會顯示來源）以及已確認的查詢關聯之前；使用頻率僅在同等級內微調先後。

大小寫不敏感（Case Insensitive）

比對一律忽略大小寫，且雙向生效，你輸入時的大寫不會改變命中範圍，檔案名稱的實際大小寫同樣不影響。myfile、MyFile、MYFILE 之間可以互相命中。

不再有大小寫敏感模式：輸入大寫字母不會再讓該詞只比對精確大小寫。

拼音別名與排序

中文檔案名稱可用拼音檢索，有兩種形式：簡拼（每個字一個字母，如「惡性」的 ex）和全拼（完整拼出每個音節，如「證書」的 zhengshu）。

排序權重： 拼音命中算作「單詞開頭」命中（見上方「結果如何排序」），因此排在英文完整單詞命中之後、英文單詞中間命中之前。同一組內依次為：最近程度 > 路徑深度 > 比對位置 > 覆蓋率 > 英文 > 簡拼 > 全拼，因此英文/簡拼/全拼只在其餘各項都相同時才用於區分。最後一個音節只輸入一半仍然可以命中，所以輸入 zhengsh 時「證書」不會消失，便於邊打邊搜。

關閉模糊比對時，拼音比對必須對齊音節起點。ex 可以命中「惡性」（兩個字的首字母），但不會命中「學習」（那需要把 xue 的結尾和 xi 的開頭拼接起來）。開啟模糊比對時，這種鬆散比對正是你所要求的，依然可用。

內嵌搜尋的「目前資料夾」區域優先顯示直屬項目，再按深度顯示子目錄中的項目。直屬項目先比較比對起點，越靠左越優先；起點相同時才將資料夾排在檔案前，再比較比對類型和檔案總管式名稱順序。名稱長短不決定直屬項目的順序。

2. 多詞組合與邏輯運算

空格：AND（與）

多個關鍵字之間使用空格分隔，表示同時滿足所有條件。各個關鍵字在檔案名稱中出現的先後順序不受限制：

report final 2024

上述輸入可以同時命中 2024-Q3-report-final.docx 與 final_report_2024.pdf。

豎線 |：OR（或）

使用豎線 | 分隔關鍵字，表示滿足其中任意一個條件即可：

png | jpg | gif

可自由混合 AND 與 OR 邏輯。例如：

report | summary

表示尋找名稱包含 report 或 summary 的檔案。在 OR 查詢中，結果名稱中所有命中條件的關鍵字都會同步反白顯示。

運算優先級：AND 優先於 OR

在同一查詢中混合使用空格（AND）與豎線 |（OR）時，預設情況下空格的優先級更高：空格分隔的連續詞會先合併為同一個 AND 組，各組之間再取 OR。查詢不支援括號，這已是標準的布林運算讀法，但舊的結合順序只需一個開關即可恢復（見下）。

report | summary 2024 | draft

等價於 report OR (summary AND 2024) OR draft。

這正是「先列出幾個候選項、再對其中一個加限定」時的預期讀法：summary 2024 會保持為一個整體條件，而不會散開成兩個彼此獨立的候選項。

切回 OR 優先

在 設定 → 一般 → 系統 → OR 優先於 AND（舊行為） 中，可以恢復 Lertaro 歷史上的結合順序，即豎線優先於空格：

report | summary 2024 | draft

此時等價於 (report OR summary) AND (2024 OR draft)。

該開關只改變這兩個運算子之間的優先級，不引入任何新運算子；對只使用其中一種運算子的查詢沒有任何影響（無論開關處於哪一側，read me 與 readme | rdm 的含義都相同）。

注意：| 必須作為獨立詞並以空格與兩側分隔，a|b 或 a |b 不會按 OR 解析；也不要把 ! 排除詞放進 | 的 OR 組（如 b | !c），它會被解析為「b 比對或 c 不比對」，若想排除某個詞，請讓它作為獨立的空格條件（如 b !c）。

引用與優先級

單引號短語 '...' 不會跨越豎線，豎線始終會終止短語的作用範圍，因此 'data | 'backup 是兩個 OR 候選項（各含一個被引用的詞），而不是一個包含豎線的短語。這一點在兩種優先級設定下都成立。

詞內空格與短語引用

若要搜尋本身包含空格的短語，可以使用反斜線轉義空格 \ ，或使用單引號 '...' 包裹短語：

final\ report
'final report'

上述寫法均會將 final report 視為一個包含空格的完整詞，而不是拆分為兩個獨立的 AND 關鍵字。

貼上多行文字自動摺疊為 OR

當從試算表、文字檔案或記錄檔中複製多行文字（一行一個檔案名稱）並直接貼上到搜尋框中時，Lertaro 會自動將各行用 | 拼接摺疊為一條 OR 查詢（自動過濾空白行）：

123
456
678

貼上後將自動轉換為：

123 | 456 | 678

3. 操作符修飾符大全

操作符速查表

操作符 / 語法	類型	效果說明	輸入範例	比對結果範例
(無)	預設模糊	字元按順序出現在名稱任意位置（開啟模糊時）	report	Q3-report-final.docx
!	排除	排除名稱中包含該精確子字串的所有結果	!temp	過濾掉含有 temp 的檔案
'	翻轉精確性	模糊開啟時轉精確子字串；模糊關閉時轉模糊比對	'report	必須包含連續的 report 子字串
'...'	詞邊界比對	精確子字串比對，且要求位於單詞邊界（非單詞內部）	'app'	比對 app.exe、my-app.log，不比對 whatsapp.exe
^	前綴比對	檔案/資料夾名稱必須以此內容開頭	^IMG	IMG_20240101.jpg（不比對 MY_IMG.jpg）
$	後綴比對	檔案/資料夾名稱必須以此內容結尾	.pdf$	document.pdf（不比對 document.pdf.bak）
^...$	完全比對	檔案/資料夾名稱必須與此內容完全相等	^readme.md$	僅精確比對 readme.md
|	或邏輯	比對管線符號任意一側的條件	doc | pdf	比對名稱包含 doc 或 pdf 的項目

操作符進階說明與實戰組合

1. 排除修飾符 !：!term 會將包含 term 精確子字串的結果直接剔除。排除項不會進行拼音擴展，以避免誤排除無辜檔案。
2. 精確性翻轉 '：在全域模糊比對開啟的狀態下，前綴 ' 可使特定關鍵字臨時走精確子字串比對。
   • 例如 lertaro 'v1.2 表示 lertaro 走模糊搜尋，而 v1.2 必須作為連續字元精準出現。
   • 即便開啟了精確搜尋，程式仍將比對存在拼音別名的檔名，如 'exe$ 可搜尋到 古恩希爾（拼音映射為 gexe）。
3. 詞邊界精確比對 '...'：用單引號包裹單個詞（如 'app'）時，比對引擎會檢查前後邊界（空白字元、標點符號、減號、底線或字串首尾），避免在長單詞中間發生誤命中。
4. 完全比對 ^...$：僅當 ^ 和 $ 作用於同一個詞時生效。如果分別寫在不同詞上（如 ^src md$），則仍分別作為前綴和後綴條件。

多操作符組合實戰範例：

• ^IMG !.png$ 2024：尋找以 IMG 開頭、包含 2024、且後綴不是 .png 的檔案。
• 'data | 'backup ^2024 .zip$：尋找以 2024 開頭、以 .zip 結尾，且名稱中精確包含 data 或 backup 的壓縮檔。
• ^report '公告 | 'gw .pdf$ !draft：名稱以 report 開頭、以 .pdf 結尾、不包含 draft，且名稱中精確包含 公告 或 gw 或 公文 及其他符合 gw 拼音的文字組合（'公告 | 'gw 組成一個 OR 組，其餘空格條件與它取 AND）。

4. 路徑模式與磁碟機限定

指定磁碟機

在搜尋框開頭輸入磁碟機代號加冒號，可將搜尋範圍嚴格限定在指定磁碟機：

d: report

空格可以省略，d:report 與 d: report 等效。

完整路徑模式

當搜尋內容包含路徑分隔符號（\ 或 /）時，Lertaro 會自動切換為全路徑比對模式：

D:\Projects\Lertaro

若以路徑分隔符號結尾（如 D:\Projects\），則會直接搜尋該資料夾內部的所有子項目。

智能上級資料夾回退比對（Folder Matching）

當針對檔案名稱的普通搜尋未填滿結果列表上限時，Lertaro 會自動使用查詢詞中未命中檔案名稱的部分去比對上級祖先資料夾名稱，無需額外語法：

d01j dcj

即使 dcj 沒有出現在檔案本身的名字中，也能找到位於名為（或拼音別名為）dcj 的資料夾下的 d01j.txt 檔案。

NOTE

該特性要求至少有一個詞命中檔案名稱本身，且僅在檔案名稱直接比對未填滿結果時觸發。回退補全的結果始終排列在常規結果之後，絕不會頂替或打亂檔案名稱直接比對的結果。

5. 查詢標記與二次篩選（Query Tokens）

Lertaro 支援在主搜尋詞後追加以冒號 :（可在設定 → 一般 → 系統 → 查詢標記總前導字元中自訂）引導的查詢標記（Query Tokens），對初篩結果進行鏈式二次篩選與排序。

支援在單個 : 後使用逗號 , 組合多個標記，例如 report :@doc,M-。

檔案分類篩選（:@<分類名>）

快速套用預設的副檔名分類規則，支援使用 | 組合多個分類：

• :@doc：文件類（*.txt; *.md; *.log; *.doc; *.docx; *.rtf; *.odt; *.pdf; *.xls; *.xlsx; *.csv; *.ods; *.ppt; *.pptx; *.odp; *.epub; *.mobi; *.one; *.vsdx; *.vsd; *.wps; *.et; *.dps; *.odf; *.odg; *.odb; *.eqp; *.mmx; *.tex; *.ini; *.conf）
• :@img：圖片類（*.jpg; *.jpeg; *.png; *.jfif; *.gif; *.bmp; *.webp; *.svg; *.ico; *.tif; *.tiff; *.heic; *.heif; *.avif; *.raw; *.psd; *.ai; *.jxl）
• :@video：影片類（*.mp4; *.mkv; *.avi; *.mov; *.wmv; *.flv; *.webm; *.m4v; *.mpg; *.mpeg; *.ts; *.m2ts; *.mts; *.3gp; *.rmvb; *.rm; *.vob; *.ogv）
• :@audio：音訊類（*.mp3; *.wav; *.flac; *.aac; *.ogg; *.oga; *.m4a; *.wma; *.ape; *.opus; *.aiff; *.aif; *.mid; *.midi; *.dsf; *.dff）
• :@zip：壓縮檔類（*.zip; *.rar; *.7z; *.tar; *.gz; *.bz2; *.xz; *.iso; *.wim; *.esd）
• :@app：應用程式類（*.exe; *.url; *.appref-ms; *.msi; *.msix; *.appx; *.bat; *.cmd; *.com）

NOTE

這六條預設規則與下列兩處使用同一張分類表：完整搜尋視窗左側的類型篩選器，以及快速視窗搜尋框下方的類型篩選欄。同一個檔案在三處不會被認成三種類型。規則本身可以在設定 → 外掛模組 → CoreExtensions → 設定 → 自訂篩選器裡修改，改完三處同時生效。

指向某個檔案的捷徑按其目標歸類，而不是按「它是捷徑」歸類：指向文件的捷徑算文件，只有在目標無法讀取時才退回按應用程式處理。

範例：

• 財務 :@doc：在文件中搜尋「財務」。
• 桌布 :@img：在圖片中搜尋「桌布」。
• clip :@video|audio：在影片或音訊檔案中搜尋「clip」。

你可以在設定 → 外掛模組 → CoreExtensions中自由修改分類規則或新增自訂分類。

完整搜尋視窗的側邊欄篩選與快速視窗的類型篩選欄使用同一批篩選列，在同一外掛模組的搜尋篩選器設定群組中設定，並非兩套獨立設定。側邊欄篩選的名稱只用於顯示；@關鍵字 引用只在側邊欄篩選的規則欄位中解析，並引用自訂篩選器清單中的關鍵字，包括未啟用的篩選器。

副檔名精準篩選（:.ext 或 :.ext1.ext2）

使用點號直接指定一個或多個副檔名（會自動排除資料夾）：

• report :.pdf：只保留 .pdf 檔案。
• data :.csv.xlsx：只保留 .csv 或 .xlsx 試算表檔案。

結果排序與檔案/資料夾篩選（:[SCMAF]）

使用單個字母指定排序屬性：S（檔案大小）、C（建立時間）、M（修改時間）、A（存取時間）、F（資料夾/檔案篩選）。

預設字母代表升冪（從小到大 / 從舊到新）；加入減號 -（前綴或後綴均可，如 M- 或 :-M）代表降冪（從大到小 / 從新到舊）或反向篩選：

標記語法	效果說明	典型應用場景
:S	按檔案大小升冪排列（最小在前）	尋找空檔案或極小檔案
:S- 或 :-S	按檔案大小降冪排列（最大在前）	log :S-（排查體積最大的記錄檔）
:M	按修改時間升冪排列（最早修改在前）	尋找長期未更新的歷史檔案
:M- 或 :-M	按修改時間降冪排列（最新修改在前）	report :M-（快速尋找最近修改過的文件）
:C / :C-	按建立時間升冪 / 降冪排列	build :C-（尋找最新產生的建置產物）
:A / :A-	按存取時間升冪 / 降冪排列	project :A-（尋找最近開啟過的專案）
:F	僅保留資料夾（過濾掉所有普通檔案）	config :F（僅尋找名為 config 的目錄）
:-F 或 :F-	僅保留檔案（過濾掉所有資料夾目錄）	config :-F（僅尋找名為 config 的檔案）

萬用字元二次篩選（:?<表達式>）

使用標準 Windows 萬用字元（? 比對單個字元，* 比對任意字元序列）對結果進行精確比對，支援用 | 或 ; 分隔多個 OR 條件：

• mp4 :?(2026???????????)：比對包含 2026 且後跟 11 位時間戳記的影片檔案。
• photo :?IMG_????.jpg|DSC_????.jpg：同時比對兩種相機格式的特定相片編號。

路徑模糊二次比對（::<路徑表達式>）

要求結果的任意一級上級目錄名或檔案名稱本身比對指定的模糊關鍵字：

• report ::2024：要求檔案所在路徑的各級目錄中必須包含 2024。
• main ::"src\core"：要求檔案位於 src\core 及其子目錄下。

鏈式組合實戰範例

各個標記可以組合在同一個 : 後使用：

• 財務報表 :@doc,M-：搜尋「財務報表」，限定文件類型，按修改時間倒序排列（最新修改在前）。
• backup :.zip,S-,F-：搜尋「backup」，限定 .zip 格式，按體積從大到小排列，且僅顯示檔案。
• icon ::assets,?*128*：搜尋「icon」，限定路徑包含 assets，且檔案名稱中包含 128 尺寸標識。

6. 特殊搜尋技巧

單次搜尋臨時繞過排除規則

在查詢最開頭輸入 *，可讓本次搜尋臨時忽略在排除規則中設定的路徑排除、Glob 和正則表達式，無需修改設定：

*node_modules

* 本身會在搜尋前自動剝離，不會參與文字比對。該功能僅能召回已建立索引的內容（網路磁碟機或 WSL 中未被建立索引的排除項不會出現）；系統隱藏檔案等基礎過濾依然保持生效。

結果類型觸發符

在設定 → 一般 → 快速搜尋視窗 → 結果類型優先級中，可以為特定結果類型（應用程式、系統設定、檔案分類、外掛模組項目、普通檔案等）設定單字元觸發符。

在快速搜尋列最前面輸入該觸發符，將只顯示該類型的結果，其他類型全部隱藏：

;vs

若 ; 被設定為「應用程式」類型的觸發符，上述輸入將只在應用程式中搜尋 Visual Studio。在快速搜尋視窗中，輸入觸發符會暫時抑制歷史記錄候選項，而我的最愛不受觸發符影響，始終置頂展示。

7. 多語言智能別名

中文檔名：拼音別名

內建拼音別名外掛模組（PinyinAlias），無需設定即可直接使用拼音搜尋中文檔案名稱：

• 全拼搜尋：輸入 chongqing 即可精準命中名為 重慶.docx 的檔案。
• 簡拼 / 首字母：輸入 cq 同樣可比對 重慶.docx；輸入 wzry 可比對 王者榮耀.exe。
• 多音字支援：系統會為漢字的常見讀音同時建立別名索引（如「重慶」可同時比對 chongqing 與 zhongqing，「銀行」可比對 yinhang 與 yinxing）。

可在設定 → 外掛模組中確認 PinyinAlias 外掛模組是否處於啟用狀態。

西班牙語檔名：重音別名

內建 SpanishAlias 外掛模組，支援使用標準無重音 ASCII 字母搜尋包含西班牙語重音字元（á、é、í、ó、ú、ü、ñ）的檔案名稱：

• 輸入 cancion 比對 Canción.mp3。
• 輸入 nino 比對 Niño.txt。
• 輸入 ciguena 比對 Cigüeña.png。

命中的字元（包含原檔案名稱中的重音字元）將保持精準反白。可在設定 → 外掛模組中管理 SpanishAlias 外掛模組。

8. 常見疑問與我的最愛

我的最愛，而非自訂別名

Lertaro 並未設計通用的「自訂搜尋別名/巨集」機制。最接近的替代方案：

• 我的最愛：將任意檔案、資料夾或網址加入我的最愛並指定自訂顯示名稱後，即可透過該名稱直接搜尋到它（結果中帶有 ★ 標記）。
• 檔案篩選器（參閱即時答案）：為觸發關鍵字綁定若干資料夾後，在快捷搜尋框輸入 關鍵字 詞 即可將一般索引搜尋限定在這些資料夾內。

如果你需要透過自訂關鍵字快速啟動外部程式或執行指令碼，請參閱自訂命令。