desktop

デスクトップ開発ガイド

アーキテクチャの概要

LobeHub デスクトップは、メインプロセスとレンダラープロセスのアーキテクチャを採用した Electron で構築されています。

1. メインプロセス（apps/desktop/src/main）：アプリのライフサイクル、システム API、ウィンドウ管理
2. レンダラープロセス：src/ の Web コードを再利用します
3. プリロードスクリプト（apps/desktop/src/preload）：メインプロセスをレンダラープロセスに安全に公開します

新しいデスクトップ機能の追加

1. コントローラーを作成する

場所：apps/desktop/src/main/controllers/

import { ControllerModule, IpcMethod } from '@/controllers';

export default class NewFeatureCtr extends ControllerModule {
  static override readonly groupName = 'newFeature';

  @IpcMethod()
  async doSomething(params: SomeParams): Promise<SomeResult> {
    // Implementation
    return { success: true };
  }
}

apps/desktop/src/main/controllers/registry.ts に登録します。

2. IPC 型を定義する

場所：packages/electron-client-ipc/src/types/<domain>.ts。types/index.ts から再エクスポートされます

export interface SomeParams {
  /* ... */
}
export interface SomeResult {
  success: boolean;
  error?: string;
}

3. レンダラーサービスを作成する

場所：src/services/electron/

import { ensureElectronIpc } from '@/utils/electron/ipc';

const ipc = ensureElectronIpc();

export const newFeatureService = async (params: SomeParams) => {
  return ipc.newFeature.doSomething(params);
};

4. ストアのアクションを実装する

場所：src/store/

5. テストを追加する

コントローラーと同じ場所に配置します。apps/desktop/src/main/controllers/<Name>Ctr.test.ts（source-layout §2）

詳細ガイド

各トピックの詳細は references/ を参照してください。

• 機能の実装：references/feature-implementation.md
• ローカルツールのワークフロー：references/local-tools.md
• メニューの設定：references/menu-config.md
• ウィンドウ管理：references/window-management.md