Claude Code 交互式启动流程与信任边界深度分析

if ("production" === 'test' || isEnvTruthy(false) || process.env.IS_DEMO) {
  return false;
}

applyConfigEnvironmentVariables();

setImmediate(() => initializeTelemetryAfterTrust());

const TRUSTED_SETTING_SOURCES = [
  'userSettings',     // ~/.claude/settings.json
  'flagSettings',     // --settings CLI 参数
  'policySettings',   // 企业管理配置
] as const;

let _trustAccepted = false;
export function checkHasTrustDialogAccepted(): boolean {
  return (_trustAccepted ||= computeTrustDialogAccepted());
}

export function getSteps(): Step[] {
  const hasClaudeMd = getFsImplementation().existsSync(join(getCwd(), 'CLAUDE.md'));
  const isWorkspaceDirEmpty = isDirEmpty(getCwd());

  return [
    {
      key: 'workspace',
      text: 'Ask Claude to create a new app or clone a repository',
      isComplete: false,
      isCompletable: true,
      isEnabled: isWorkspaceDirEmpty,    // 只在空目录时启用
    },
    {
      key: 'claudemd',
      text: 'Run /init to create a CLAUDE.md file with instructions for Claude',
      isComplete: hasClaudeMd,
      isCompletable: true,
      isEnabled: !isWorkspaceDirEmpty,   // 只在非空目录时启用
    },
  ];
}

export function startDeferredPrefetches(): void {
  if (isEnvTruthy(process.env.CLAUDE_CODE_EXIT_AFTER_FIRST_RENDER) || isBareMode()) {
    return;  // benchmark 模式或脚本模式跳过
  }

  // 进程级预取（用户还在打字时完成）
  void initUser();
  void getUserContext();
  prefetchSystemContextIfSafe();
  void getRelevantTips();

  // 云凭证预取
  void prefetchAwsCredentialsAndBedRockInfoIfSafe();
  void prefetchGcpCredentialsIfSafe();

  // 文件系统探测
  void countFilesRoundedRg(getCwd(), AbortSignal.timeout(3000), []);

  // 分析和 feature gate 初始化
  void initializeAnalyticsGates();
  void prefetchOfficialMcpUrls();
  void refreshModelCapabilities();

  // 文件变更检测器
  void settingsChangeDetector.initialize();
  void skillChangeDetector.initialize();
}

export class FpsTracker {
  private frameDurations: number[] = [];

  record(durationMs: number): void { /* 记录每帧耗时 */ }

  getMetrics(): FpsMetrics | undefined {
    // averageFps = totalFrames / totalTime
    // low1PctFps = 1000 / p99FrameTime  (最差 1% 帧率)
  }
}

const frameTimingLogPath = process.env.CLAUDE_CODE_FRAME_TIMING_LOG;
// 每帧记录 JSONL：
// { total, renderer, diff, optimize, write, patches, yoga, commit,
//   yogaVisited, yogaMeasured, yogaCacheHits, yogaLive, rss, cpu }

const flickers: FrameEvent['flickers'] = [];
for (const patch of diff) {
  if (patch.type === 'clearTerminal') {
    flickers.push({
      desiredHeight: frame.screen.height,
      availableHeight: frame.viewport.height,
      reason: patch.reason  // 'resize' | 'offscreen' | 'clear'
    });
  }
}

export function showDialog<T = void>(
  root: Root,
  renderer: (done: (result: T) => void) => React.ReactNode
): Promise<T> {
  return new Promise<T>(resolve => {
    const done = (result: T): void => void resolve(result);
    root.render(renderer(done));
  });
}

export function showSetupDialog<T = void>(
  root: Root,
  renderer: (done: (result: T) => void) => React.ReactNode,
  options?: { onChangeAppState?: typeof onChangeAppState }
): Promise<T> {
  return showDialog<T>(root, done =>
    <AppStateProvider onChangeAppState={options?.onChangeAppState}>
      <KeybindingSetup>{renderer(done)}</KeybindingSetup>
    </AppStateProvider>
  );
}

export async function renderAndRun(root: Root, element: React.ReactNode): Promise<void> {
  root.render(element);
  startDeferredPrefetches();  // 启动延迟预取
  await root.waitUntilExit();
  await gracefulShutdown(0);   // 优雅关闭
}

export async function exitWithError(root: Root, message: string, beforeExit?: () => Promise<void>): Promise<never> {
  return exitWithMessage(root, message, { color: 'error', beforeExit });
}

export async function exitWithMessage(root: Root, message: string, options?): Promise<never> {
  const { Text } = await import('./ink.js');
  root.render(color ? <Text color={color}>{message}</Text> : <Text>{message}</Text>);
  root.unmount();
  await options?.beforeExit?.();
  process.exit(exitCode);
}

const PHASE_DEFINITIONS = {
  import_time:  ['cli_entry', 'main_tsx_imports_loaded'],
  init_time:    ['init_function_start', 'init_function_end'],
  settings_time: ['eagerLoadSettings_start', 'eagerLoadSettings_end'],
  total_time:   ['cli_entry', 'main_after_run'],
};