開発者ガイド

Lertaro 開発者向けリファレンスマニュアルへようこそ。Lertaro は疎結合なマルチプロセスアーキテクチャと拡張性の高いプラグインエコシステムを採用しており、公式 SDK アセンブリ Lertaro.PluginSdk を提供しています。この SDK を参照することで、カスタム検索ソースの追加、コンテキストメニューアクションの拡張、サードパーティ製ファイラーや標準ファイルダイアログとの高度な統合、テーマやファイルプレビューのカスタマイズが可能です。

1. アーキテクチャと開発フロー

• システムアーキテクチャ設計 —— SYSTEM 権限の Windows サービス、ユーザー権限の WPF UI、キーボードフックプロセスの 3 プロセス分離モデルと名前付きパイプ IPC の詳細。
• クイックスタートガイド —— クラスライブラリの作成、SDK の参照、IPlugin エントリポイントの実装、ローカルデバッグの手順。
• パッケージングと配布 —— ディレクトリ構造の仕様、依存ライブラリの同梱、多言語 JSON リソースの埋め込み、PostBuild 自動配置。
• 公式プラグインのサンプル解説 —— オープンソースとして同梱されている CoreExtensions、PinyinAlias、FlowLauncherBridge の設計と実装パターンの詳細解説。

2. プラグイン SDK API リファレンス

SDK カテゴリ	主要インターフェイス・サービス	主な機能
検索コアとアクション	ISearchableItemProvider IInstantResultProvider IAliasProvider IQueryTokenProvider ISearchResultAction IDynamicActionProvider	静的インデックスソース、即時計算クエリ、非 ASCII エイリアス変換エンジン、末尾属性トークンハンドラー、静的・動的コンテキストメニュー。
システムとダイアログの統合	IActivePathCollector IFileDialogAdapter IInlineSearchAdapter IQuickNavigationProvider	アクティブなファイラーのパス取得、標準ファイルダイアログのフック、インライン検索バーの埋め込みと双方向選択同期、クイックナビゲーションメニュー。
UI とプレビューの拡張	ISidebarFilterProvider IResultColumnProvider IQuickPanelTabProvider 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 ファイル操作。

NOTE

本マニュアルのすべてのインターフェイス定義、引数、動作仕様は Lertaro.PluginSdk のソースコードに基づいて厳密に記述されています。