Method init

apps/desktop/main/index.ts:99–178

()

  // 初始化程序
  async init() {
    initAnalytics()
    logger.info('Desktop app starting')

    // E2E 测试模式：跳过遗留数据迁移
    // 遗留迁移会删除 Documents/ChatLab，在本地测试时可能破坏用户数据
    if (!this.isTestMode) {
      // 应用上次设置页登记的数据目录切换；必须早于任何数据库连接初始化
      this.applyPendingDataDirMigrationIfNeeded()

      // 清理上次切换目录后的旧数据目录
      cleanupPendingDeleteDir()

      // 执行数据目录迁移（从 Documents/ChatLab 迁移到 userData）
      this.migrateDataIfNeeded()

      // 执行统一目录结构迁移（Electron 旧布局 → 双根目录）
      this.migrateToUnifiedDirsIfNeeded()
    }

    // 验证数据路径是否正确（安全网：防止 config.toml 指向空目录）
    verifyDataPath()

    // 确保应用目录存在
    ensureAppDirs()

    let runtime: RuntimeIdentity
    try {
      runtime = assertDesktopDataDirCompatible(getPathProvider(), getDesktopAppVersion(app.getVersion()))
    } catch (error) {
      console.error('[Main] Data directory compatibility check failed:', error)
      dialog.showErrorBox(
        'ChatLab Data Directory Incompatible',
        `ChatLab cannot open this data directory with the current desktop version.\n\n${
          error instanceof Error ? error.message : String(error)
        }`
      )
      app.quit()
      return
    }

    // 执行配置数据迁移（Migration Runner，Electron 和 CLI 共享）
    await new MigrationRunner(ALL_MIGRATIONS, {
      dataDir: getSystemDataDir(),
      aiDataDir: getAiDataDir(),
      logger: {
        info: (_cat: string, msg: string) => console.log(`[Migration] ${msg}`),
        warn: (_cat: string, msg: string) => console.warn(`[Migration] ${msg}`),
        error: (_cat: string, msg: string, ...args: unknown[]) => console.error(`[Migration] ${msg}`, ...args),
      },
    }).run()

    // 初始化主进程国际化（在 ensureAppDirs 之后，确保 settings 目录存在）
    await initLocale()

    // 执行数据库 schema 迁移（确保所有数据库在 Worker 查询前已是最新 schema）
    try {
      this.migrateDatabasesIfNeeded(runtime)