系統架構設計

Lertaro 採用先進的多程序隔離架構與模組化分層設計，確保在實現系統級毫秒檢索與全方位視窗整合的同時，兼顧最高級別的運行安全與穩定性。

1. 三程序隔離模型

為了徹底規避單一元件異常導致整個系統當機，並將 Windows 特權限制在最小範圍內，Lertaro 的執行階段被明確劃分為三個獨立的程序：

1. 後台索引服務（Lertaro.Service）

• 運行身份：以 Windows 系統級 LocalSystem 身份常駐運行的 Windows 服務。
• 職責範圍：承擔全盤檔案索引與增量監聽的核心重任。直接讀取 NTFS / ReFS 磁碟底層的 USN 變更記錄檔與 $MFT 主檔案表；即時監聽 FAT32 / exFAT 磁碟變更；定時抓取並快取 SMB / NAS 網路共用。
• 安全與效能考量：運行在 SYSTEM 級別使服務無需彈出任何 UAC 提權快顯視窗即可直接讀取原始磁碟卷的中繼資料；同時透過高效能具名管道向用戶態 App 返回檢索結果，徹底避免了讓前景 UI 程序持有不必要的全域高權限。

2. 用戶互動主程式（Lertaro.App）

• 運行身份：標準 Windows 用戶態、Session 隔離的 WPF 前景桌面應用程式。
• 職責範圍：承載快速搜尋置中浮動視窗、完整主搜尋視窗、設定中心、全域快捷鍵分發、動作選單（Ctrl+O）以及 QuickLook 檔案即時預覽介面。
• IPC 橋樑與 CLI 託管：透過雙向具名管道（Core.Services.SearchService）向後台 Service 發送搜尋請求與目錄管理指令；同時，App 自身還託管了一條面向當前用戶的專屬具名管道服務（AppSearchPipeService），使外部伴隨工具（如 lff 命令列工具）能直接複用 App 已經構建好的記憶體別名表、外掛模組提供者與網路磁碟快取，無需重複初始化。

3. 全域鍵盤掛鉤與視窗適配程序（Lertaro.Service --hook）

• 運行身份：由後台服務按需拉起的獨立特權輔助程序。
• 職責範圍：託管低階全域鍵盤掛鉤（Low-Level Keyboard Hook）與滑鼠全域監聽。
• UIPI 權限突破與崩潰隔離：在 Windows 安全體系中，低完整性級別的用戶態程序無法向以管理員身份運行的高權限視窗發送視窗訊息或模擬輸入（UIPI 隔離）。透過在該特權 Hook 程序中運行視窗整合適配器（IActivePathCollector、IFileDialogAdapter、IInlineSearchAdapter），Lertaro 能夠毫無阻礙地識別並嵌入由管理員身份啟動的檔案總管、Total Commander 或第三方對話方塊。同時，即使底層掛鉤因第三方遊戲的反作弊模組產生異常，也不會影響主 App 程序的正常運行。

2. 共用核心層（Shared Core Library）

Lertaro.Core 是被 Service、App 和 Hook 程序同時引用的基礎類別庫，主要包含以下關鍵模組：

• 自研 fzf 模糊比對引擎（Core/SearchIndex/Fzf/*）：高效復刻並最佳化了知名 fzf 演算法的跳躍字元模糊比對、子字串分段與字元級反白計算，配合 SearchQueryParser 實現磁碟機定向與路徑模式切分。
• 欄式記憶體索引（Core/IndexV2/*）：採用記憶體對應欄式快照（Columnar Snapshot）與記憶體增量覆蓋層（Delta Overlay），實現億級檔案項目的亞毫秒級檢索。
• 二進位 IPC 通訊契約：定義了 SearchRequestMessage、SearchResponseBinarySerializer 等標準二進位資料通訊協定，確保多程序間零拷貝高效序列化。
• 統一多程序記錄系統（Logger）：分別輸出至 service.log、app.log 與 hook.log，並由 App 的設定中心記錄檢視器統一代理讀取與呈現。

3. 外掛模組系統在架構中的定位

所有第三方及內建外掛模組均基於 Lertaro.PluginSdk 構建，由 Lertaro.App 程序在啟動時自動反射掃描並載入：

• 零特權直接通訊：外掛模組通常只與 App 程序進行互動，不直接與底層 Service 通訊。若外掛模組需要註冊自訂實體目錄進行長效索引，可透過 SDK 提供的 DirectoryIndexerService 向宿主發起代理請求。
• 雙重載入機制：常規的搜尋來源、動作與介面擴充僅在 App 程序中運行；而實作了系統與視窗適配介面（IActivePathCollector 等）的元件會被宿主額外載入一份至 Hook 程序中執行，以確保跨權限視窗自動化的穩定性。