CC源码剖析 #02 · 入口点解析：从 CLI 到 REPL

1
2
3
4

// 这些副作用必须在所有 import 之前执行
profileCheckpoint('main_tsx_entry');
startMdmRawRead();       // 并行读取 MDM 配置（macOS 企业配置）
startKeychainPrefetch(); // 并行读取 Keychain（OAuth + API Key）

1
2
3
4
5
6
7

program
  .name('claude')
  .description('Cloudshell enhanced with AI')
  .option('--model <model>', 'Specify model')
  .option('--no-input', 'Non-interactive mode')
  // ... 80+ 选项
  .parse(args);

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// 这些异步操作在 REPL 渲染前并行启动，不阻塞首屏
fetchBootstrapData();           // 获取启动引导数据
prefetchPassesEligibility();    // 用户推荐资格检查
prefetchOfficialMcpUrls();      // 官方 MCP 服务器 URL 预取
prefetchFastModeStatus();       // 快速模式状态
prefetchAwsCredentialsIfSafe(); // AWS 凭证
prefetchGcpCredentialsIfSafe(); // GCP 凭证
initializeGrowthBook();         // Feature Flag 服务
refreshPolicyLimits();          // 策略限制
loadRemoteManagedSettings();    // 企业托管设置

1
2
3
4
5
6
7

import { initializeGrowthBook } from './services/analytics/growthbook.js';

// GrowthBook 是功能开关系统，决定哪些实验特性对当前用户开放
initializeGrowthBook().then(() => {
  // 特性开关就绪后，注册条件命令
  registerConditionalCommands();
});

1
2
3
4
5
6
7
8
9

const permissionMode = initialPermissionModeFromCLI()  // CLI 参数
  ?? (await checkAutoModeEnabledStateIfCached())       // 缓存的自动模式
  ?? getDefaultPermissionMode();                       // 默认值

const allowedTools = parseToolListFromCLI();            // --allowed-tools
const removedTools = removeDangerousPermissions(       // 过滤危险权限
  allowedTools,
  permissionMode
);

1
2
3
4
5
6
7
8
9

import { feature } from 'bun:bundle';

const proactive = feature('PROACTIVE') || feature('KAIROS')
  ? require('./commands/proactive.js').default
  : null;

const voiceCommand = feature('VOICE_MODE')
  ? require('./commands/voice/index.js').default
  : null;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

const COMMANDS = memoize((): Command[] => [
  addDir, advisor, agents, branch,
  // ... 基础命令
  ...(webCmd ? [webCmd] : []),           // CCR_REMOTE_SETUP
  ...(forkCmd ? [forkCmd] : []),         // FORK_SUBAGENT
  ...(buddy ? [buddy] : []),             // BUDDY
  ...(process.env.USER_TYPE === 'ant'
    ? INTERNAL_ONLY_COMMANDS              // 内部命令
    : []),
]);

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

interface Command {
  type: 'prompt' | 'builtin' | 'alias';
  name: string;
  aliases?: string[];
  description: string;
  contentLength?: number;
  progressMessage?: string;
  source?: 'builtin' | 'plugin' | 'skill';
  // prompt 类型命令有生成器函数
  getPromptForCommand?: (args: string[], context: Context) => Promise<string>;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

// 命令以逗号分隔列表静态导入（~80 个文件）
import commit from './commands/commit.js';
import diff from './commands/diff/index.ts';
import doctor from './commands/doctor/index.ts';
// ...

// 所有命令汇聚到 COMMANDS 数组
const COMMANDS = memoize((): Command[] => [
  addDir, advisor, agents, branch, btw, chrome, clear, color,
  compact, config, copy, desktop, context, // ...
]);

// 别名映射
export const builtInCommandNames = memoize(
  (): Set<string> => new Set(
    COMMANDS().flatMap(_ => [_.name, ...(_.aliases ?? [])])
  )
);

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

async function getSkills(cwd: string): Promise<{
  skillDirCommands: Command[];   // 用户自定义 skills 目录
  pluginSkills: Command[];       // 插件提供的 skills
  bundledSkills: Command[];      // 内置 skills（Markdown/Explain/Review）
  builtinPluginSkills: Command[]; // 内置插件命令
}> {
  const [skillDirCommands, pluginSkills] = await Promise.all([
    getSkillDirCommands(cwd),
    getPluginSkills(),
  ]);
  const bundledSkills = getBundledSkills();
  const builtinPluginSkills = getBuiltinPluginSkillCommands();
  return { skillDirCommands, pluginSkills, bundledSkills, builtinPluginSkills };
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

export async function launchRepl(
  root: Root,
  appProps: AppWrapperProps,
  replProps: REPLProps,
  renderAndRun: (root: Root, element: React.ReactNode) => Promise<void>
): Promise<void> {
  const { App } = await import('./components/App.js');
  const { REPL } = await import('./screens/REPL.js');
  await renderAndRun(root, <App {...appProps}><REPL {...replProps} /></App>);
}

1
2
3
4
5
6
7
8
9

// REPL 是状态最重的组件，持有大量状态
interface REPLState {
  messages: Message[];          // 对话消息历史
  toolUses: ToolUse[];          // 工具调用记录
  agents: Agent[];              // 子 Agent
  tasks: Task[];                // 后台任务
  queuedCommands: QueuedCommand[]; // 队列中的命令
  // ... 100+ 状态字段
}

1
2
3
4
5
6
7

const messages = useLogMessages();           // 消息订阅
const tools = useMergedTools();             // 工具组合
const commands = useMergedCommands();        // 命令组合
const mcpClients = useMergedClients();      // MCP 客户端
const appState = useAppState();             // 全局状态
const replBridge = useReplBridge();         // IDE 桥接
const remoteSession = useRemoteSession();   // 远程会话

1
2
3
4

// main.tsx 中将 CLI 参数转换为环境变量供子模块使用
// CLAUDE_CODE_MODEL → model
// CLAUDE_CODE_PERMISSION_MODE → permissionMode
// CLAUDE_CODE_OUTPUT_FORMAT → outputFormat