開發者手冊

歡迎查閱 Lertaro 開發者參考手冊。Lertaro 採用解耦架構與開放的外掛模組生態，提供官方 SDK 組件 Lertaro.PluginSdk。開發者可以透過引用該 SDK，為 Lertaro 貢獻自訂搜尋來源、擴充快顯動作、適配第三方檔案管理器與原生對話方塊，或者自訂主題與檔案預覽元件。

1. 架構與開發流程

• 系統架構設計 —— 詳解 SYSTEM 級 Windows 索引服務、使用者態 WPF 互動處理程序與獨立鍵盤攔截處理程序的三處理程序隔離模型與具名管道 IPC 通訊機制。
• 快速上手指南 —— 從零建立外掛模組類別庫專案、引用 SDK、實作 IPlugin 入口以及本機偵錯的最佳實踐。
• 封裝與分發 —— 外掛模組組件目錄結構規範、第三方託管/原生相依庫打包、多語言 JSON 資源內嵌與 PostBuild 自動部署。
• 官方外掛模組範例 —— 剖析隨包開源的 CoreExtensions、PinyinAlias、FlowLauncherBridge 與 FileUnlocker 等真實外掛模組的實作程式碼。

2. 外掛模組 SDK 介面參考

SDK 模組分類	核心介面與服務	關鍵功能說明
核心檢索與動作	ISearchableItemProvider IInstantResultProvider IAliasProvider IQueryTokenProvider ISearchResultAction IDynamicActionProvider	貢獻靜態索引來源、高頻即時計算答案、非 ASCII 別名轉寫引擎、尾部 Token 後綴處理器以及靜態/動態快顯動作選單。
系統與對話方塊適配	IActivePathCollector IFileDialogAdapter IInlineSearchAdapter IQuickNavigationProvider	探測前景管理器活動目錄、掛載原生檔案對話方塊、內嵌搜尋列並雙向同步選取狀態、貢獻滑鼠快速導航選單。
介面與預覽擴充	ISidebarFilterProvider IResultColumnProvider IQuickPanelTabProvider ICalendarTextProvider IFilePreviewProvider IThumbnailProvider IThemeProvider ITranslationProvider	擴充側邊欄篩選分類、表格檢視自訂欄、快速面板動態工作區索引標籤、搜尋視窗時鐘列的日期文字、QuickLook 自訂轉譯器與縮圖擷取、WPF 資源字典主題包與多語言 i18n。
共用抽象契約	ISearchResult FileMetadata IPluginSearchWindow IConfigurable	檢索結果唯讀資料契約、奈秒級檔案時間戳記與大小中繼資料、宿主視窗安全控制控制代碼與基於結構描述驅動的原生設定表單。
宿主開放服務	FuzzyMatchService TranslationService IconService FavoritesService HistoryService FileMetadataService DirectoryIndexerService MemoryMaintenanceService RecentFilesService ExplorerPathService PluginSettingsService SettingsSearchService SettingsWindowService SearchRefreshService UserDataService Logger	宿主暴露的高效能基礎設施：fzf 模糊比對與反白遮罩、多語言剖析、帶快取圖示擷取、收藏管理與歷程讀取、背景目錄索引代理、延遲記憶體維護、使用者資料目錄隔離及 Shell 原生檔案操作。
通知	PluginNotificationService NotificationRequest INotificationHandle NotificationLevel NotificationPosition NotificationResult NotificationFailure	透過宿主自己的視窗取得背景注意：右下角的卡片堆或下方置中的一行提示、由宿主裁剪的時長、依 Id 取代、逐外掛模組上限，以及一個總是會完成的工作。

NOTE

本手冊各頁的介面簽章、成員名稱、預設值與參數順序均取自 Lertaro.PluginSdk 原始碼。當某一頁同時描述宿主對外掛模組呼叫的反應時，該句只是目前行為的文件，並非外掛模組可以依賴的契約。