┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   UI Components │    │  PreferenceService │    │  Storage Layer  │
│                 │    │                  │    │                 │
│ - TemplateManager│───▶│ - IPreferenceService│───▶│ - Web: useStorage│
│ - ThemeToggle   │    │ - ElectronProxy  │    │ - Electron: IPC │
│ - LanguageSwitch│    │ - usePreferences │    │ - Main: fs      │
└─────────────────┘    └──────────────────┘    └─────────────────┘

interface IPreferenceService {
  get<T>(key: string, defaultValue: T): Promise<T>;
  set<T>(key: string, value: T): Promise<void>;
  delete(key: string): Promise<void>;
  keys(): Promise<string[]>;
  clear(): Promise<void>;
}

// 检测Electron API完整可用性
export function isElectronApiReady(): boolean {
  const window_any = window as any;
  const hasElectronAPI = typeof window_any.electronAPI !== 'undefined';
  const hasPreferenceApi = hasElectronAPI && 
    typeof window_any.electronAPI.preference !== 'undefined';
  return hasElectronAPI && hasPreferenceApi;
}

// 异步等待API就绪
export function waitForElectronApi(timeout = 5000): Promise<boolean> {
  return new Promise((resolve) => {
    if (isElectronApiReady()) {
      resolve(true);
      return;
    }
    
    const startTime = Date.now();
    const checkInterval = setInterval(() => {
      if (isElectronApiReady()) {
        clearInterval(checkInterval);
        resolve(true);
      } else if (Date.now() - startTime > timeout) {
        clearInterval(checkInterval);
        resolve(false);
      }
    }, 50);
  });
}

if (isRunningInElectron()) {
  console.log('[AppInitializer] 检测到Electron环境，等待API就绪...');
  
  // 等待 Electron API 完全就绪
  const apiReady = await waitForElectronApi();
  if (!apiReady) {
    throw new Error('Electron API 初始化超时，请检查preload脚本是否正确加载');
  }
  
  console.log('[AppInitializer] Electron API 就绪，初始化代理服务...');
  // ... 继续初始化
}

export class ElectronPreferenceServiceProxy implements IPreferenceService {
  private ensureApiAvailable() {
    const windowAny = window as any;
    if (!windowAny?.electronAPI?.preference) {
      throw new Error('Electron API not available. Please ensure preload script is loaded and window.electronAPI.preference is accessible.');
    }
  }

  async get<T>(key: string, defaultValue: T): Promise<T> {
    this.ensureApiAvailable();
    return window.electronAPI.preference.get(key, defaultValue);
  }
  // ... 其他方法
}

# 构建core包
cd packages/core && pnpm run build

# 构建ui包  
cd packages/ui && pnpm run build

# 运行测试
pnpm run test

[isRunningInElectron] Verdict: true (via electronAPI)
[isElectronApiReady] API readiness check: {hasElectronAPI: true, hasPreferenceApi: true}
[waitForElectronApi] API already ready
[AppInitializer] Electron API 就绪，初始化代理服务...
[AppInitializer] 所有服务初始化完成