第 03 章：准备工具箱

// 普通（同步）函数：调用后等待结果
function readFile(path: string): string {
  return fs.readFileSync(path, 'utf-8') // 阻塞，什么都做不了
}

// async 函数：调用后可以继续做别的事
async function readFileAsync(path: string): Promise<string> {
  return fs.promises.readFile(path, 'utf-8') // 非阻塞，等文件读完后自动继续
}

// 使用 await 等待 async 函数完成
const content = await readFileAsync('package.json')
console.log(content) // 文件已读完，可以用了

// → src/entrypoints/cli.tsx 的 feature() 导入
import { feature } from 'bun:bundle'

// 假设 feature('DUMP_SYSTEM_PROMPT') 在外部构建中 = false

if (feature('DUMP_SYSTEM_PROMPT')) {
  // 这段代码在外部构建的产物中根本不存在
  const prompt = await getSystemPrompt()
  console.log(prompt)
}

// → src/entrypoints/cli.tsx 的 main() 函数（简化版）
async function main(): Promise<void> {
  const args = process.argv.slice(2)

  // 快速路径 1：--version — 零模块加载
  if (args.length === 1 && (args[0] === '--version' || args[0] === '-v')) {
    console.log(`${MACRO.VERSION} (Claude Code)`)  // MACRO.VERSION 在编译时内联
    return
  }

  // 启动性能追踪
  const { profileCheckpoint } = await import('../utils/startupProfiler.js')
  profileCheckpoint('cli_entry')

  // 快速路径 2：--dump-system-prompt（仅内部版本）
  if (feature('DUMP_SYSTEM_PROMPT') && args[0] === '--dump-system-prompt') {
    // ...输出 system prompt 后退出
  }

  // 快速路径 3-10+：其他子命令...
  // --claude-in-chrome-mcp, --chrome-native-host, --daemon-worker 等
  // 每个都通过动态 import 按需加载
}

// → src/entrypoints/cli.tsx 的完整 CLI 加载（简化版）
startCapturingEarlyInput()  // 在启动过程中就开始捕获按键！
const { main: cliMain } = await import('../main.js')
await cliMain()

// → src/main.tsx 的导入部分
// 启动性能追踪（最先执行）
import { profileCheckpoint } from './utils/startupProfiler.js'
profileCheckpoint('main_tsx_entry')

// 并行启动 MDM 和 Keychain 预读取
import { startMdmRawRead } from './utils/settings/mdm/rawRead.js'
startMdmRawRead()  // 在 macOS 上并行启动 plutil 进程
import { startKeychainPrefetch } from './utils/secureStorage/keychainPrefetch.js'
startKeychainPrefetch()  // 并行预读取 OAuth 和 API key

// → src/entrypoints/init.ts 的 init() 函数
export const init = memoize(async () => {
  // 初始化配置系统
  enableConfigs()
  // 初始化遥测
  initializeTelemetry()
  // 初始化 GrowthBook（远程功能开关）
  await initializeGrowthBook()
  // 初始化代理设置
  // 初始化证书
  // ...
})

// → src/main.tsx 的 main() 函数（简化版）
export async function main() {
  // Step 1: 安全检查（Windows PATH 加固等）
  // Step 2: 解析 CLI 参数（Commander.js）
  // Step 3: 处理 --print / -p 模式（单次执行后退出）
  // Step 4: 交互模式设置
  const actionHandler = async () => {
    // Step 4a: 初始化（init — memoized，只执行一次）
    await init()
    await initializeTelemetryAfterTrust()

    // Step 4b: 认证（OAuth / API key）
    // Step 4c: 获取 bootstrap 数据（模型列表、功能配置等）
    const bootstrapData = await fetchBootstrapData()

    // Step 4d: 组装工具列表
    const tools = getTools(permissionContext)

    // Step 4e: 启动 REPL（终端交互界面）
    await launchRepl(root, appProps, replProps, renderAndRun)
  }
}

// → src/screens/REPL.tsx 的 query() 调用（简化版）
for await (const event of query({
  messages: messagesIncludingNewMessages,
  systemPrompt,
  userContext,
  systemContext,
  canUseTool,
  toolUseContext,
  querySource: getQuerySourceForREPL()
})) {
  onQueryEvent(event)  // 处理每个流式事件（渲染到终端）
}

console.log('[DEBUG] args =', args)

console.log('[DEBUG] main.tsx loaded at', Date.now())

console.log('[DEBUG] about to launch REPL at', Date.now())