模块依赖全景图

职责概述

本页呈现 Claude Code 的完整模块依赖关系。通过对顶层 .ts/.tsx 文件的 import 语句和各子目录的交叉引用分析，构建出从入口到底层的全栈依赖图。系统按六层架构组织：入口层（main.tsx / setup.ts）、编排层（QueryEngine.ts / query.ts）、工具层（tools/）、服务层（services/）、工具库层（utils/）、原生层（native-ts/）。依赖方向严格自上而下，跨层调用通过明确接口解耦。

分层依赖架构

模块依赖网格

以下网格展示了主要模块之间的直接依赖关系。每行是一个模块，deps 列出其直接依赖。

跨层依赖关系图

循环依赖

关键类型与接口

全局状态单例 (bootstrap/state.ts)

// bootstrap/state.ts 被所有层依赖的核心状态
// 以下是被广泛 import 的函数签名：
export function getSessionId(): string
export function getCwd(): string
export function setCwd(cwd: string): void
export function getProjectRoot(): string | undefined
export function getModelUsage(): ModelUsage
export function getTokenCounter(): number
export function getCostCounter(): number
export function getMainLoopModelOverride(): string | undefined
export function getInlinePlugins(): string[]
export function getSessionBypassPermissionsMode(): boolean
export function isSessionPersistenceDisabled(): boolean
// ... 40+ getter/setter 函数

Feature Gate 模式 (bun:bundle)

// 死代码消除模式 — 外部构建时 feature() 返回 false，整个代码块被移除
import { feature } from 'bun:bundle'

const REPLTool = process.env.USER_TYPE === 'ant'
  ? require('./tools/REPLTool/REPLTool.js').REPLTool
  : null

// 或使用 feature() gate：
const reactiveCompact = feature('REACTIVE_COMPACT')
  ? require('./services/compact/reactiveCompact.js')
  : null

设计模式与亮点

代码索引