Lertaro

系統架構設計 ​

Lertaro 採用多程序隔離與模組化分層設計，在實現毫秒級檢索與視窗整合的同時，保證運行安全與穩定。

執行程序與通訊關係
lff.exe選用命令列用戶端
依使用者與工作階段隔離的搜尋管道
桌面應用程式
Lertaro.App.exe標準使用者 · WPF

搜尋視窗、設定、預覽與外掛搜尋來源

App ↔ ServiceLertaroPipe搜尋請求 ↔ 結果
索引服務Lertaro.Service.exe --serviceLocalSystem · Windows 服務

NTFS / ReFS 中繼資料、FAT / exFAT 監聽與網路目錄快取

App ↔ HookLertaro_Hook_Events / Cmds視窗事件 ↔ 命令
掛鉤與視窗配接Lertaro.Service.exe --hook互動使用者工作階段

鍵盤與滑鼠掛鉤、作用中路徑擷取、檔案對話方塊整合

Service 為已登入的使用者工作階段啟動 Hook。 僅系統管理員帳戶可提升權限執行 Hook。

共用類別庫：載入程序中，並非額外服務

Lertaro.Core索引快照、模糊比對與 IPC 契約

Lertaro.PluginSdkApp：搜尋與介面；Hook：視窗配接；Service：同時載入別名與翻譯

1. 三程序隔離模型 ​

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

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

  • 運行身份：以 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 託管：透過雙向具名管道 LertaroPipe 與後台 Service 溝通（Core.Services.Search.SearchService 是 App 端的用戶端）。同時，App 自身還託管了一條面向當前用戶的專屬具名管道服務（AppSearchPipeService），使外部伴隨工具（如 lff 命令列工具）能直接複用 App 已經構建好的記憶體別名表、外掛模組提供者與網路磁碟快取，無需重複初始化。

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

  • 運行身份：由後台服務拉起的獨立輔助程序。只有在登入帳號確為真正的管理員時才會以提權方式啟動；否則它沿用使用者自己的權杖運行，因此下述的突破只在該台機器上可用。
  • 職責範圍：託管低階全域鍵盤掛鉤（Low-Level Keyboard Hook）與滑鼠全域監聽。
  • UIPI 權限突破與崩潰隔離：在 Windows 安全體系中，低完整性級別的用戶態程序無法向以管理員身份運行的高權限視窗發送視窗訊息或模擬輸入（UIPI 隔離）。透過在該 Hook 程序中運行視窗整合適配器（IActivePathCollector、IFileDialogAdapter、IInlineSearchAdapter），只要 Hook 是以提權方式啟動，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 一併載入，請見下一點。外掛模組不會自行跨越程序邊界，因此需要自訂目錄索引時，應透過 DirectoryIndexerService 委派工作，而不是自己去走訪磁碟。
  • 選擇性雙重載入：搜尋來源、動作與介面擴充元件僅在 App 程序中運行。另有三項會被載入其他程序：視窗與檔案對話方塊適配器（IActivePathCollector、IFileDialogAdapter、IInlineSearchAdapter）會進入 Hook 程序以處理跨完整性級別的視窗自動化；而 IAliasProvider 與 ITranslationProvider 也會由 Service 載入（ServicePluginLoader），因為索引器要建立別名資料列，需要與 UI 顯示相同的轉寫與命名。