Function startHttpServer

apps/cli/src/http/index.ts:92–245

(options?: HttpServerOptions)

 * 启动独立 HTTP API 服务
 */
export async function startHttpServer(options?: HttpServerOptions): Promise<{
  port: number
  host: string
  token: string
}> {
  if (server) {
    throw new Error('HTTP server is already running')
  }

  let config = loadConfig()
  const port = options?.port ?? config.api.port
  const host = options?.host ?? config.api.host
  const token = options?.token ?? ensureToken(config)

  const pendingMigration = applyPendingNodeDataDirMigrationIfNeeded()
  if (!pendingMigration.skipped) {
    if (pendingMigration.success) {
      console.log('[Migration] Pending data directory migration completed')
      config = loadConfig()
    } else {
      console.error('[Migration] Pending data directory migration failed:', pendingMigration.error)
    }
  }

  const userDataDir = config.data.user_data_dir || undefined
  const pathProvider = new NodePathProvider(userDataDir)
  pathProvider.ensureAllDirs()
  const runtime = assertCliDataDirCompatible(pathProvider, 'cli')

  if (hasPendingElectronDataWarning() || !verifyCliDataPath(pathProvider.getDatabaseDir())) {
    console.error(
      '\n' +
        '='.repeat(68) +
        '\n' +
        '  ChatLab: Electron desktop data not found\n' +
        '='.repeat(68) +
        '\n\n' +
        '  Detected that ChatLab desktop app was installed on this machine,\n' +
        '  but could not locate your chat databases.\n\n' +
        '  This usually means you changed the data directory in desktop settings.\n\n' +
        '  To fix this, choose one of:\n\n' +
        '  1. Open ChatLab desktop app — it will auto-migrate your data\n' +
        '  2. Set the data directory manually:\n' +
        '     export CHATLAB_DATA_DIR="/path/to/your/data"\n' +
        '  3. Edit ~/.chatlab/config.toml:\n' +
        '     [data]\n' +
        '     user_data_dir = "/path/to/your/data"\n\n' +
        '='.repeat(68) +
        '\n'
    )
  }

  const migrationRunner = new MigrationRunner(ALL_MIGRATIONS, {
    dataDir: pathProvider.getSystemDir(),
    aiDataDir: pathProvider.getAiDataDir(),
    logger: {
      info: (_cat: string, msg: string) => console.log(`[Migration] ${msg}`),
      warn: (_cat: string, msg: string) => console.warn(`[Migration] ${msg}`),