术语表（Glossary）¶

Claude Code 源码学习手册中出现的所有专业术语 / 缩略语 / 内部概念的 A~Z 索引。每个词条包含：定义 + 在哪个文档/章节详细解释 + 关联词条链接。用法：Ctrl+F 搜索术语，或按字母浏览。

A¶

AbortController¶

Web 标准的"取消信号"。Claude Code 在 agent 循环、API 请求、subprocess 中都用它做硬中断。
controller.abort() 触发后，所有监听 signal 的资源都会收到通知。
关联：AbortError、Async Generator

AbortError¶

AbortController.abort() 触发后抛出的错误。Claude Code 的 try/catch 里专门处理这类错误（区分于"真实错误"）。
关联：AbortController、withRetry

Activity Manager¶

src/utils/activityManager.ts —— 追踪"用户活跃度"（最后一次交互时间）。用于 idle 提示、自动 compact 等。
关联：Idle Dialog、Compact

Agent（Agent / Sub-agent）¶

LLM 驱动的、能"自主决策 + 调用工具"的执行单元。Claude Code 的 phase-05-tools.md「5.9 子 Agent 工具」和 phase-06-agent-loop.md「6.7 多 Agent 协调」深入讲解。
关联：AgentTool、Swarm、Teammate

AgentTool¶

src/tools/AgentTool/AgentTool.tsx —— 启动子 agent 的工具。它本身不"做事"，而是递归启动一次新的 LLM 循环。
关联：Agent、Task

Anti-Distillation¶

防止他人"蒸馏"训练 Claude Code 的输出。feature('ANTI_DISTILLATION_CC') 旗标控制。
关联：Feature Flag

AppState¶

src/state/AppStateStore.ts —— 全局应用状态类型。包含 messages、tasks、settings、permissions 等 40+ 字段。
详见 phase-03-state.md。
关联：Store、Selectors

Astro¶

（不是 Claude Code 概念） —— 列出避免混淆。

Async Generator（`async function*`）¶

TC39 标准的异步生成器。Claude Code 流式架构的核心惯用法：query()、QueryEngine.ask()、tool.call()、api.stream() 全部用 async function* + yield 实现。
关联：Stream Event、Async Iterator Protocol、Backpressure

Ant-only¶

仓库里一种特殊的内部版本专属代码。process.env.USER_TYPE === 'ant' 时启用，外部构建里是 null。
例子：REPLTool、RemoteTriggerTool、AntModelSwitchCallout。
关联：DCE、Feature Flag

API Microcompact¶

phase-06-agent-loop.md「6.6 上下文压缩」里 Anthropic API 自带的 microcompact 能力（与 Claude Code 自研的 microCompact 区分）。
关联：MicroCompact、Context Compaction

Async Generator（`async function*`）¶

TC39 标准的异步生成器。Claude Code 流式架构的核心惯用法：query()、QueryEngine.ask()、tool.call()、api.stream() 全部用 async function* + yield 实现。
关联：Stream Event、Async Iterator Protocol、Backpressure

Async Iterator Protocol¶

Symbol.asyncIterator 接口。for await...of 消费 async function* 返回的对象时依赖此协议。
关联：Async Generator

AuthCodeListener¶

OAuth 回调端口的监听器。src/services/mcp/oauthPort.ts —— 启动本地 HTTP server 等 OAuth 回调。
关联：OAuth、MCP

AutoUpdater¶

src/components/AutoUpdater.tsx + NativeAutoUpdater.tsx + PackageManagerAutoUpdater.tsx —— 多种自动更新策略。
关联：Native Client

Attribution¶

归因。Claude Code 的 attributionState 追踪"哪些 commit 是 Claude 改的"（用于 phase-05-tools.md「5.4 工具全生命周期」和 phase-03-state.md「3.3.1 AppState 字段」）。
关联：Commit Attribution

B¶

Backpressure（背压）¶

数据生产速度 > 消费速度时的反向压力。Claude Code 在 phase-07-advanced.md「7.3 Bridge」用 flushGate.ts 防止 IDE 跟不上 CLI 速度。
关联：Async Generator、Buffer

BoundedUUIDSet¶

src/utils/... —— 容量有限的 UUID 集合。
关联：Task、Session

BridgeFatalError¶

致命 bridge 错误。src/bridge/ 里某些错误是不可恢复的（如认证彻底失败），立刻退出而不是重试。
关联：Bridge、Error Handling

BashTool¶

src/tools/BashTool/ —— 16 个文件的安全敏感型工具。涉及 shell 命令解析、危险命令检测、沙箱策略。
关联：Phase 5 - BashTool 16 个文件拆解

Bedrock（AWS Bedrock）¶

phase-06-agent-loop.md「6.4 传输层」提到 Claude Code 支持的 4 种 API provider 之一（Anthropic 直连、AWS Bedrock、GCP Vertex、claude.ai OAuth）。
关联：Vertex、API Provider

Biome¶

Web 项目里 ESLint + Prettier 的"二合一"替代品。Claude Code 大量使用 // biome-ignore 注释。
关联：ESLint

Branded Type¶

TypeScript 的"打标签"原始类型：

type AgentId = string & { __brand: 'AgentId' }

编译时防止 string 误传给 AgentId 参数。
关联：TypeScript Utility Types、Phase 3 状态管理

Bun¶

Claude Code 的运行时（不是 Node.js）。import { feature } from 'bun:bundle' 是构建时死代码消除门控。
关联：DCE、Bun Bundle Feature

Bun Bundle Feature¶

Bun 的构建时特性：import { feature } from 'bun:bundle'; if (feature('XXX')) { ... } —— feature('XXX') 在 Bun 构建时被替换为 false，整个 if 分支被消除。
关联：DCE、Bun

Bridge¶

src/bridge/（20+ 文件）—— Claude Code 和 IDE / 远程 实时双向同步的管道。
关联：IDE Integration、Direct Connect

Bun¶

Claude Code 的运行时（不是 Node.js）。import { feature } from 'bun:bundle' 是构建时死代码消除门控。
关联：DCE、Bun Bundle Feature

Bun Bundle Feature¶

Bun 的构建时特性：import { feature } from 'bun:bundle'; if (feature('XXX')) { ... } —— feature('XXX') 在 Bun 构建时被替换为 false，整个 if 分支被消除。
关联：DCE、Bun

C¶

Caret¶

光标。use-declared-cursor.ts Ink hook 让用户能"声明"光标位置（TTY 里没真实光标，靠 ANSI 转义码模拟）。
关联：Ink

CCR（Cloud Code Runtime）¶

Ant 内部的云端 Claude Code 运行环境。CLAUDE_CODE_REMOTE=true 时启用，启用 NODE_OPTIONS 增加 heap。
关联：Feature Flag、Env Vars

CCR Client¶

src/bridge/... —— CCR 客户端实现。和 Bridge 类似但走云端。
关联：Bridge、Remote

Chakra¶

（不是 Claude Code 概念） —— Web UI 库。

Chmod¶

文件权限设置。bashSecurity.ts 里检查文件权限。
关联：Bash Security

Chord（chord binding）¶

键位组合（先按 Ctrl+K 再按 Ctrl+S）。详见 topics/keybindings-system.md。
关联：Keybinding、State Machine - Chord

Circuit Breaker¶

熔断器模式。可重试错误连续失败 N 次后，短期拒绝而不是无脑重试。Claude Code 的 withRetry 推测有这个机制。
关联：Retry、Error Handling

CLI（Command Line Interface）¶

命令行界面。Claude Code 是 CLI 工具，所有交互发生在 TTY 里。
关联：TUI、REPL

Commander.js¶

Node.js 最流行的 CLI 参数解析库。Claude Code 用 @commander-js/extra-typings（增强版）解析 process.argv。
关联：Argv

Compact（Context Compaction）¶

phase-06-agent-loop.md「6.6 上下文压缩」—— LLM 上下文窗口快满时，把历史消息摘要成更短版本以腾出空间。
关联：MicroCompact、AutoCompact、Token Budget

Component¶

React 风格的"可复用 UI 单元"。Claude Code 用 Ink 在 TTY 里渲染组件，和 Web React 同种范式。
关联：Ink、Component Design Pattern

Context Compaction¶

见 Compact。

Context Provider¶

React Context 的 Provider 组件。Claude Code 在 phase-03-state.md「3.4 React 集成层」用 <AppStateProvider> 注入 store。
关联：Context API

Controlled Component¶

React 受控组件模式。Tabs 同时支持受控（selectedTab + onTabChange）和非受控（defaultTab）两种用法。
关联：Phase 4 - Tabs 设计

Coordinator¶

src/coordinator/coordinatorMode.ts —— 多 agent swarm 模式的协调器。决定谁是 leader、消息怎么路由。
关联：Swarm、Teammate

CRDT¶

Conflict-free Replicated Data Type。协同编辑的数据结构（Git、协同文档等用）。Claude Code 的 Bridge 协议不是 CRDT，但解决同种"双向同步"问题。
关联：Bridge、Phase 7 - Bridge 双向通信

D¶

DCE（Dead Code Elimination）¶

死代码消除。Claude Code 用 Bun 的 feature('XXX') 门控 + process.env.USER_TYPE === 'ant' 在构建时消除不需要的分支。
关联：Bun Bundle Feature、Ant-only、Tree Shaking

Debug Logger¶

src/utils/debug.ts —— 调试日志。
关联：Logging、Sentry

DECRQM¶

终端查询模式（CSI ? p）。用于查询终端能力（如是否支持焦点事件）。
关联：Terminal Capabilities

DeepImmutable¶

type DeepImmutable<T> = { readonly [K in keyof T]: DeepImmutable<T[K]> } —— 递归只读。Claude Code 用它防止意外 mutation。
关联：TypeScript Utility Types

Disposable¶

"可释放资源"模式。Symbol.dispose 接口（TC39 标准）。Claude Code 用 using 语句自动清理 subprocess、file handle 等。
关联：Resource Management

Drift Detection¶

检测 prompt cache 是否失效（系统 prompt 变了但 cache 还在）。src/services/api/promptCacheBreakDetection.ts。
关联：Performance、Compact

Dialog¶

src/components/design-system/Dialog.tsx（137 行）—— TUI 模态对话框基底。对应 Web 项目的 Radix Dialog。
关联：Phase 4 - Dialog 设计

Diff Hunk¶

统一 diff（unified diff）格式里的"一段变化"。一个文件改动可拆成多个 hunk。StructuredDiffList 渲染 hunk 列表。
关联：Structured Diff、Unified Diff

Dispatch Table¶

message.type → 渲染器的映射表。Messages.tsx 用 switch 把消息类型分发到对应的 *Message.tsx 组件。
关联：Phase 4 - Dispatch 模式

Direct Connect¶

src/server/（3 文件）—— Claude Code 本地起 HTTP/WebSocket 服务，让其他进程直连。不走远程 broker。
关联：Bridge、Remote Session

E¶

Elicitation¶

MCP 1.0 协议特性。MCP server 可以反过来向用户提问（"需要哪个项目？"），UI 弹 ElicitationDialog 让用户回答。
关联：MCP、Phase 7 - Elicitation 协议

ElicitationDialog¶

src/components/mcp/ElicitationDialog.tsx —— MCP elicitation 的 UI 渲染。
关联：MCP

Embedding¶

向量嵌入。Claude Code 不直接用 embedding，但记忆系统（memdir/）可能用 embedding 做相似度搜索。
关联：Memory、Skills

ErrorBoundary¶

React 错误边界。Claude Code 用了 src/components/ErrorBoundary.tsx（推测），捕获子组件的渲染错误并降级。
关联：Error Handling

ESLint¶

JavaScript/TypeScript linter。Claude Code 配了自定义规则集（如 custom-rules/no-top-level-side-effects）。
关联：Biome

Event Loop¶

JavaScript 运行时的事件循环。Claude Code 大量用 Async Generator 和 for await...of，本质是事件循环 + Promise 的协作式调度。

Executable（.exe / 二进制）¶

vendor/*.node 是 N-API 二进制文件。Claude Code 用 N-API 集成 C/C++ 实现的 native 模块。
关联：N-API、Vendor

ESLint¶

JavaScript/TypeScript linter。Claude Code 配了自定义规则集（如 custom-rules/no-top-level-side-effects）。
关联：Biome

Event Loop¶

JavaScript 运行时的事件循环。Claude Code 大量用 Async Generator 和 for await...of，本质是事件循环 + Promise 的协作式调度。

F¶

Fallback Model¶

降级模型。当主模型（Opus）失败或限流时，自动切换到次要模型（Sonnet 或 Haiku）。
src/services/api/claude.ts 推测有 FallbackTriggeredError。
关联：Error Handling、Model

FallbackTriggeredError¶

降级触发的信号错误。
关联：Fallback Model、Error Handling

Feature Flag¶

特性开关。Claude Code 用 feature('XXX') 控制 build-time 行为。
关联：DCE、GrowthBook

FileEditTool¶

src/tools/FileEditTool/（7 个文件）—— 编辑文件 的工具。是"安全敏感度中"的工具范例。
关联：Phase 5 - FileEditTool 目录结构

Flexbox¶

CSS 弹性盒布局。Claude Code 在 TTY 里通过 Yoga 引擎实现 flexbox。
关联：Yoga Layout

Flexport¶

（不是 Claude Code 概念，这里列出是因为你可能搜过）

G¶

Graceful Degradation¶

优雅降级。失败时返回部分结果或备选而不是崩溃。Claude Code 大量用这个模式。
关联：Fallback Model、Error Handling

GrowthBook¶

src/services/analytics/growthbook.js —— A/B 测试 / 特性开关服务。Claude Code 用它做远程 feature flag 管理。
关联：Feature Flag

Grouped Tool Use¶

phase-04-components.md「4.4.3 性能模式」—— 多个连续 tool_use 合并渲染，避免 N 个 ToolUseMessage 实例。
关联：Virtualization

H¶

Handler¶

事件处理函数。Claude Code 的 hooks（use* 命名的 85 个文件）大多是 useEffect + handler 模式。
关联：Hook

Hook（React Hook）¶

React 的特殊函数（useState、useEffect 等）。Claude Code 把"业务编排"全部封装成自定义 hook（useLogMessages、useReplBridge 等）。
关联：Phase 2 - 85 个 hooks 文件

Hunk¶

见 Diff Hunk。

I¶

IDE Integration¶

IDE 集成。Claude Code 通过 src/bridge/ 实现和 VSCode / JetBrains 的双向通信。
关联：Bridge

Idle Dialog¶

src/components/IdleReturnDialog.tsx —— 用户闲置过久后弹的对话框。
关联：Activity Manager

Image Resize¶

图像缩放。src/utils/imageResizer.ts 把过大图片缩到可接受尺寸。
关联：Attachment、ImageSizeError

ImageResizeError¶

图像缩放失败错误。
关联：Image Resize、Error Handling

ImageSizeError¶

图像尺寸超限错误。
关联：Image Resize、Error Handling

Inbox¶

收件箱。src/hooks/useInboxPoller.ts 多 agent 模式下队友消息的轮询。
关联：Teammate、Mailbox

InProcess Teammate¶

src/tasks/InProcessTeammateTask/ —— 进程内 队友 agent（不创建子进程，在同一进程内跑）。
关联：Teammate、Task

InboxPoller¶

轮询队友消息的 hook。
关联：Inbox、Mailbox

Ink¶

src/ink/（50+ 文件 / 13306 行）—— 整套 React-for-CLI 框架的源码 fork。Claude Code 把 Ink 整个 fork 进来（因为没 package.json）。
关联：Phase 7 - Ink 框架

Immer¶

不可变状态更新库（"draft mutation" API）。Claude Code 没有用 Immer，而是用手动 spread（{...prev, foo: bar}）。
关联：Phase 3 - 手动 spread 模式

Ink¶

src/ink/（50+ 文件 / 13306 行）—— 整套 React-for-CLI 框架的源码 fork。Claude Code 把 Ink 整个 fork 进来（因为没 package.json）。
关联：Phase 7 - Ink 框架

Ink Component¶

Ink 提供的内置组件。<Box> = 终端里的 <div>，<Text> = <span>。
关联：Box、Text

InProcess Teammate¶

src/tasks/InProcessTeammateTask/ —— 进程内 队友 agent（不创建子进程，在同一进程内跑）。
关联：Teammate、Task

Island Rendering¶

（不是 Claude Code 概念。Astro 框架的术语）。Claude Code 的"Grouped Tool Use"和这个概念无关，列出避免混淆。

J¶

JSON Schema¶

JSON 数据结构描述格式。Anthropic API 的 tools 参数用 JSON Schema 描述工具输入。
关联：Zod

JWT（JSON Web Token）¶

src/bridge/jwtUtils.ts —— Bridge 通信的鉴权 token 格式。
关联：Bridge

K¶

KAIROS¶

Ant 内部大模型代号。feature('KAIROS') + 多种 KAIROS_* 旗标。
关联：Feature Flag

Keybinding¶

键位绑定。src/keybindings/ —— 自研的"键位总线"，支持 chord 组合（先按 Ctrl+K 再按 Ctrl+S）、context-aware、可发现性。
关联：Phase 2 - 键位系统

Keyboard Event¶

按键事件。Ink 的 useInput(handler) 接收 KeyboardEvent。
关联：Phase 2 - ink.js 渲染层 hook 列表

KAIROS¶

feature('KAIROS') —— Ant 内部旗标。SleepTool 在 feature('PROACTIVE') || feature('KAIROS') 时加载。
关联：DCE

L¶

Leader¶

Swarm 模式中的"队长" agent。负责调度、消息路由、权限决策。
关联：Teammate、Coordinator、Mailbox

LRU Cache¶

Least Recently Used 缓存。Markdown.tsx 用模块级 LRU tokenCache（500 项）缓存 marked.lexer 结果。
关联：Phase 4 - Markdown 优化、topics/markdown-rendering-optimization.md

M¶

Mailbox¶

多 agent 模式中的"邮箱"。src/utils/swarm/ 推测有 mailbox 实现，队友之间通过 mailbox 发消息。
关联：Teammate、Leader、Inbox

Mapped Type¶

TypeScript 的映射类型。Pick<AppState, 'viewingAgentTaskId' | 'tasks'> 是 Pick<> 内置映射类型。
关联：TypeScript Utility Types

MCP（Model Context Protocol）¶

Anthropic 推动的 "LLM 工具扩展标准"。Claude Code 是 MCP 的标杆实现，既是 client 又是 server。
关联：Phase 7 - MCP 专题

Message Type¶

消息类型。Claude Code 的 Message 是判别联合（discriminated union），type 字段决定渲染器。
关联：Dispatch Table、Phase 4 - 21 个消息渲染器

MicroCompact¶

phase-06-agent-loop.md「6.6 上下文压缩」里的"轻量级压缩"—— 只压缩工具结果，不动对话历史。
关联：Compact、AutoCompact

模态对话框。TUI 里的"模态"靠"渲染顺序靠后 + 全屏 Box 覆盖"实现（没有真正的 z-index）。
关联：Dialog

Module-level Cache¶

Map 在模块顶部声明，作为 LRU 缓存。关键洞察：useMemo 在 unmount/remount 时失效，模块级 cache 不依赖 React 生命周期。
关联：LRU Cache、Phase 4 - Markdown.tsx 模块级 cache

Mounter / Mount¶

React 组件挂载。useEffect(() => { ... }, []) 在 mount 后运行一次，return 的 cleanup 在 unmount 前运行。

Node.js 的 C/C++ 原生模块 API。Claude Code 用 N-API 集成： - Yoga Layout（flexbox 实现） - AVFoundation（macOS 音频） - TCC（macOS 权限） - 颜色差异 - 文件索引 - 键盘修饰键
关联：Phase 7 - Native 桥接、Vendor、topics/native-napi-integration.md

Normalized State¶

Redux 社区的"扁平化"状态设计。Claude Code 的 AppState 用了类似的扁平化（tasks: Record<TaskId, TaskState>）。
关联：Phase 3 - AppState 字段分类

O¶

OAuth¶

开放授权协议。Claude Code 用 OAuth 2.0 接 claude.ai 订阅（getClaudeAIOAuthTokens）。
关联：Phase 6 - 4 种认证方式、AuthCodeListener

Object.is¶

JavaScript 内置方法。Claude Code 的 store 用 Object.is(next, prev) 判断引用相等，跳过相同引用避免不必要渲染。
关联：Phase 3 - 60 行 store.ts 核心

OTel¶

OpenTelemetry。Claude Code 大量使用 OTel 标准（OTLP 协议）做遥测。
关联：Telemetry、Env Vars

Object.is¶

JavaScript 内置方法。Claude Code 的 store 用 Object.is(next, prev) 判断引用相等，跳过相同引用避免不必要渲染。
关联：Phase 3 - 60 行 store.ts 核心

onChange Hook¶

Store 工厂的 onChange 钩子。同步触发（在 setState 内、通知 listeners 之前），用于持久化、通知、清缓存。
关联：Phase 3 - 副作用编排

Optimistic Update¶

乐观更新。Claude Code 不用这种模式（流式场景下不适合）。

P¶

Pane¶

src/components/design-system/Pane.tsx —— 面板容器。对应 Web 项目的 Card。
关联：Design System

Permission Decision¶

权限决策结果。type PermissionResult = { behavior: 'allow' } | { behavior: 'deny', message } | { behavior: 'ask' }。
关联：Permission Mode、Tool Permission

Plan Mode¶

工具不执行、只生成 plan 的模式。用户审批后再实际执行。
关联：EnterPlanModeTool、Permission Mode

Permission Mode¶

phase-05-tools.md「5.7 工具权限系统」—— 4 种权限模式：default / acceptEdits / bypassPermissions / plan。
关联：Tool Permission Context

Plan Mode¶

工具不执行、只生成 plan 的模式。用户审批后再实际执行。
关联：EnterPlanModeTool、Permission Mode

Plugin¶

src/plugins/ —— 用户扩展点。比 Skill 重：是完整 TypeScript 模块。
关联：Skill、Phase 7 - Plugins vs Skills

Proactive¶

feature('PROACTIVE') —— Ant 内部旗标。SleepTool 在此模式加载。
关联：DCE

Process Argv¶

process.argv —— Node/Bun 进程的启动参数。src/entrypoints/cli.tsx 用它做 fast-path 分流。
关联：Phase 1 - fast-path 模式

Prompt Cache¶

Anthropic API 的 prompt caching 能力（在 SDK 1.0+ 提供）。Claude Code 3419 行的 claude.ts 用了。
关联：Compact

Provider¶

API provider。Claude Code 支持 4 种：Anthropic 直连、AWS Bedrock、GCP Vertex、claude.ai OAuth。
关联：Bedrock、Vertex

Provider (React)¶

React Context Provider。<AppStateProvider value={store}>...children...</AppStateProvider>。

Q¶

Query Engine¶

src/QueryEngine.ts（1295 行，class）—— 单次对话的状态机封装。内部维护重试、配额、链式调用追踪。
关联：Phase 6 - QueryEngine 状态机

Queue¶

排队。PromptInputQueuedCommands 展示用户输入但还没提交的命令。
关联：Phase 2 - PromptInput 子组件

Quota¶

配额。claudeAiLimits.ts 追踪 claude.ai 订阅的剩余配额。
关联：Phase 6 - 重试与限流

R¶

React Compiler¶

React 19+ 的编译器优化。Claude Code 顶部大量 import { c as _c } from "react/compiler-runtime"; 是用了 React Compiler。
关联：Phase 4 - 组件顶部 _c 标识

Reconciler¶

React 的协调器（"diff 算法 + 应用"）。src/ink/reconciler.ts 是 Ink 的 reconciler。
关联：Phase 7 - Ink reconciler

Reference Equality¶

引用相等。Object.is(a, b) 判断是否是同一个对象。Claude Code 的 store 用它做性能优化。
关联：Object.is

Remote Session¶

src/remote/（4 文件）—— 云端 session 同步。claude.ai 网页启动的对话可 attach 到本地 CLI。
关联：Bridge

REPL（Read-Eval-Print Loop）¶

读取输入、求值、打印、循环的交互式环境。src/screens/REPL.tsx（5005 行）是 Claude Code 的主屏幕。
关联：Phase 2 - REPL 主循环

Resume¶

恢复会话。/resume 命令打开历史会话。src/screens/ResumeConversation.tsx 是它的屏幕。
关联：Phase 1 - 三个非默认屏幕

Role¶

消息角色。Anthropic API 的 message 有 role: 'user' | 'assistant' | 'system' 三种。
关联：Message Type

S¶

Sampling¶

LLM 推理（生成 token）。
关联：Anthropic API、Stream Event

Sandbox¶

沙箱。Claude Code 把危险命令隔离在沙箱里跑。shouldUseSandbox.ts 决定是否走沙箱。
关联：BashTool、Sandbox Violation

Seatbelt¶

macOS 的 sandbox-exec 沙箱机制。Claude Code 在 macOS 上用 Seatbelt 限制 subprocess。
关联：Sandbox、N-API

Sentry¶

错误监控服务。src/services/diagnosticTracking.ts 推测集成 Sentry。
关联：Error Handling、Telemetry

SDK（Software Development Kit）¶

软件开发工具包。Claude Code 有 src/entrypoints/sdk/（被其他程序嵌入用）。
关联：Claude Code SDK

SDK Mode¶

Claude Code 作为库被其他程序调用。claude -p "..." 的非交互模式属于此。
关联：SDK

Selector Pattern¶

从 store 派生数据的纯函数。src/state/selectors.ts 全部是纯函数。
关联：Phase 3 - 选择器层

Service Worker¶

（不是 Claude Code 概念）。Claude Code 不在浏览器跑，没有 Service Worker。

Side-effect¶

副作用。eslint-disable custom-rules/no-top-level-side-effects 是 Claude Code 的代码规范（启动优化是例外）。
关联：Phase 1 - Top-level side-effect 的合理性

Skill¶

src/skills/ —— 任务级 prompt 模板。比 Plugin 轻，是 Markdown + 资源。
关联：Plugin、Phase 7 - Plugins vs Skills

Spinner¶

加载动画。<SpinnerWithVerb> 显示"Running for 5s, doing X"。
关联：Loading State

SSE（Server-Sent Events）¶

服务器推送事件。Anthropic API 的流式响应基于 SSE。
关联：Stream Event

State Tree¶

状态树。Claude Code 的 AppState 是扁平大对象（不是嵌套 tree）。

Stream Event¶

流式事件。message_start、content_block_start、content_block_delta、content_block_stop、message_delta、message_stop。
关联：Phase 6 - 解析 stream 事件

Stream JSON¶

流式 JSON。--output-format stream-json 模式让 Claude Code 输出 JSON Lines 格式。

Structured Diff¶

src/components/StructuredDiff.tsx —— 结构化的 diff 渲染。
关联：Diff Hunk、Phase 4 - StructuredDiff.tsx 性能考古

Swarm¶

多 agent 协作模式。多个 agent 组成"队伍"，有 leader / teammate 关系。
关联：Teammate、Coordinator

T¶

Tab Status¶

Tab 状态。useTabStatus hook 给 Tab 提供状态。
关联：Tabs

Tabs¶

src/components/design-system/Tabs.tsx（339 行）—— Tab 切换组件。
关联：Phase 4 - Tabs 设计

Tabs¶

src/components/design-system/Tabs.tsx（339 行）—— Tab 切换组件。
关联：Phase 4 - Tabs 设计

Task¶

src/Task.ts —— 任务抽象。TaskType（local_bash / local_agent / remote_agent / in_process_teammate / ...）+ TaskStatus（pending / running / completed / failed / killed）。
关联：Phase 6 - Task 抽象

TaskType¶

任务类型。见 Task。

TaskStatus¶

任务状态。见 Task。

macOS 的权限系统。microphoneAuthorizationStatus() 返回 0~3 对应未决定/限制/拒绝/授权。
关联：N-API、Vendor

Teammate¶

队友 agent。Swarm 模式下，每个 agent 是 leader 的一个 teammate。
关联：Swarm、Coordinator

Terminal¶

终端。Claude Code 跑在 TTY 里。

Theme¶

主题。src/components/design-system/ThemeProvider.tsx（169 行）—— 支持 'auto' / 'light' / 'dark'，有 preview 机制。
关联：Phase 4 - 主题系统

Themed Box / Text¶

ThemedBox.tsx / ThemedText.tsx —— 读 theme 的 <Box> / <Text>。
关联：Theme

Tmpdir¶

os.tmpdir() —— 操作系统临时目录。Claude Code 用于临时文件。
关联：REPL.tsx 头部 import

TUI（Text User Interface）¶

文本用户界面。和 GUI 相对，在终端里渲染。Claude Code 是 TUI 应用。
关联：Ink、Terminal

Tool Permission Context¶

工具权限上下文。utils/permissions/PermissionMode.ts 定义。
关联：Permission Mode

Tool Use Block¶

Anthropic API 的 tool_use content block。LLM 通过它表达"我要调工具"。
关联：Stream Event

Tree Shaking¶

打包时消除未使用代码。Claude Code 通过 feature('XXX') 主动做。
关联：DCE

Type Guard¶

TypeScript 类型守卫。isInProcessTeammateTask(task): task is InProcessTeammateTaskState。
关联：Phase 6 - TaskState 类型守卫

TypeScript Utility Types¶

TypeScript 内置类型工具：Pick<>、Omit<>、Readonly<>、DeepImmutable<> 等。Claude Code 大量用 Pick<AppState, ...> 显式声明依赖。
关联：Phase 3 - selector 类型签名

U¶

UDS（Unix Domain Socket）¶

Unix 域套接字。本地进程间通信。feature('UDS_INBOX') 旗标推测用于启用 UDS 通信。
关联：Feature Flag、Bridge

Uncontrolled Component¶

React 非受控组件模式（defaultValue / defaultChecked）。Claude Code 的 Tabs 同时支持受控和非受控。
关联：Controlled Component

unsubscribe¶

取消订阅。store.subscribe(listener) 返回 () => listeners.delete(listener)。
关联：Phase 3 - subscribe 模式

Use¶

React 19 的 use() hook 读 Promise。Markdown.tsx 用 use() + Suspense 异步加载语法高亮。
关联：Phase 4 - Markdown 异步高亮

useDeferredValue¶

React 18 的并发 API。流式响应时低优先级更新。
关联：Phase 2 - 性能优化点

useEffect¶

React 的副作用 hook。Claude Code 85 个 use* hook 内部大多用 useEffect。
关联：Hook

useInput¶

Ink 提供的 hook，相当于 Web 的 onKeyDown 全局监听。
关联：Phase 2 - ink.js 渲染层 hook 列表

useMemo¶

React 的记忆化 hook。警告：useMemo 在 unmount/remount 时会失效，Claude Code 的 Markdown.tsx 因此用 module-level cache 替代。
关联：Module-level Cache

useSyncExternalStore¶

React 18 的 hook，把外部 store 接入 React 树的官方推荐 API。Claude Code 用它做 store 订阅。
关联：Phase 3 - React 集成层

V¶

Vendor¶

vendor/（仓库根目录，不在 src/ 下）—— 4 个 native 模块的 JS 侧 TypeScript 类型定义： - audio-capture-src（macOS AVFoundation 音频） - image-processor-src（剪贴板图像） - modifiers-napi-src（键盘修饰键） - url-handler-src（URL scheme handler）
关联：Phase 7 - N-API 集成模板、topics/native-napi-integration.md

Vertex（GCP Vertex）¶

phase-06-agent-loop.md「6.4 传输层」提到的 4 种 API provider 之一。

Vim Mode¶

src/vim/（5 文件）—— vim 编辑器模式的状态机实现。
关联：Phase 7 - Vim 模式

Virtual List¶

虚拟列表。长列表只渲染可见窗口。VirtualMessageList.tsx（1081 行）实现。
关联：Phase 2 - 虚拟化

Voice Mode¶

src/voice/voiceModeEnabled.ts —— 语音输入功能标志。

W¶

Waku¶

（不是 Claude Code 概念）

Webview¶

（不是 Claude Code 概念）

Worker¶

后台工作进程。CLAUDE_CODE_WORKER_EPOCH env var 推测用于多 worker 协调。
关联：Task、Background

Worktree¶

Git worktree。EnterWorktreeTool / ExitWorktreeTool 让 LLM 在独立 worktree 里操作（隔离修改）。
关联：Tool、Git

WebSocket¶

Web 双向通信协议。SessionsWebSocket.ts 用于远程会话。
关联：Remote Session

Webview¶

（不是 Claude Code 概念）

WeakMap¶

ES6 的弱引用 Map。StructuredDiff.tsx 用 WeakMap 缓存 NAPI 高亮结果。

Y¶

Yield¶

async function* 的关键字，把值推送给消费者。Claude Code 的 query loop 每次 yield 一个 stream event。
关联：Async Generator

Yoga Layout¶

Facebook 的 flexbox C++ 实现，通过 N-API 暴露给 Node/Bun。Claude Code 在 TTY 里实现 flexbox 布局的关键。
关联：Phase 7 - Yoga layout

YAML¶

（Claude Code 不直接用 YAML，但 MCP 配置 ~/.mcp.json 是 JSON）。

Z¶

Zod¶

TypeScript 优先的 schema 验证库。Claude Code 用 zod/v4 做工具输入校验。
关联：JSON Schema、Tool

Zustand¶

流行的 React 状态管理库（Claude Code 不依赖 Zustand，但 store.ts 60 行核心和 Zustand v4 API 几乎一样）。
关联：Phase 3 - 60 行 store.ts 核心

缩略语速查¶

缩略	全称	解释
API	Application Programming Interface	应用编程接口
CRDT	Conflict-free Replicated Data Type	无冲突复制数据类型
DCE	Dead Code Elimination	死代码消除
DSL	Domain-Specific Language	领域特定语言
GC	Garbage Collection	垃圾回收
IDE	Integrated Development Environment	集成开发环境
IO	Input/Output	输入/输出
JWT	JSON Web Token	JSON 网络令牌
LRU	Least Recently Used	最近最少使用（缓存淘汰策略）
MCP	Model Context Protocol	模型上下文协议
N-API	Node-API	Node.js 原生模块 API
OAuth	Open Authorization	开放授权
REPL	Read-Eval-Print Loop	交互式执行环境
SDK	Software Development Kit	软件开发工具包
SSE	Server-Sent Events	服务器推送事件
TCC	Transparency, Consent, and Control	macOS 权限系统
TUI	Text User Interface	文本用户界面
TTY	TeleTypewriter	终端设备
UI	User Interface	用户界面
URL	Uniform Resource Locator	统一资源定位符
WSL	Windows Subsystem for Linux	Windows Linux 子系统
YAML	YAML Ain't Markup Language	YAML 数据序列化

项目内部概念速查¶

概念	路径	解释
`REPL`	`src/screens/REPL.tsx`	主屏幕（5005 行）
`replLauncher`	`src/replLauncher.tsx`	启动 REPL 的函数
`main()`	`src/main.tsx:585`	主入口函数
`query()`	`src/query.ts:219`	核心 agent 循环
`QueryEngine`	`src/QueryEngine.ts:184`	状态机 class
`AppState`	`src/state/AppStateStore.ts`	状态对象类型
`createStore`	`src/state/store.ts`	60 行 store 工厂
`Tool`	`src/Tool.ts:362`	工具接口类型
`buildTool`	`src/Tool.ts:783`	工具工厂函数
`MCPConnectionManager`	`src/services/mcp/MCPConnectionManager.tsx`	MCP 连接管理
`Bridge`	`src/bridge/bridgeMain.ts`	IDE 桥接主控
`Ink`	`src/ink/ink.tsx`	TUI 框架核心（1722 行）
`Yoga`	`src/native-ts/yoga-layout/`	flexbox 布局引擎

还在增长¶

如果你在文档里看到没收录的术语，告诉我 —— 我会加进来。

术语表（Glossary）¶

A¶

AbortController¶

AbortError¶

Activity Manager¶

Agent（Agent / Sub-agent）¶

AgentTool¶

Anti-Distillation¶

AppState¶

Astro¶

Async Generator（async function*）¶

Ant-only¶

API Microcompact¶

Async Generator（async function*）¶

Async Iterator Protocol¶

AuthCodeListener¶

AutoUpdater¶

Attribution¶

B¶

Backpressure（背压）¶

BoundedUUIDSet¶

BridgeFatalError¶

BashTool¶

Bedrock（AWS Bedrock）¶

Biome¶

Branded Type¶

Bun¶

Bun Bundle Feature¶

Bridge¶

Bun¶

Bun Bundle Feature¶

C¶

Caret¶

CCR（Cloud Code Runtime）¶

CCR Client¶

Chakra¶

Chmod¶

Chord（chord binding）¶

Circuit Breaker¶

CLI（Command Line Interface）¶

Commander.js¶

Compact（Context Compaction）¶

Component¶

Context Compaction¶

Context Provider¶

Controlled Component¶

Coordinator¶

CRDT¶

D¶

DCE（Dead Code Elimination）¶

Debug Logger¶

DECRQM¶

DeepImmutable¶

Disposable¶

Drift Detection¶

Dialog¶

Diff Hunk¶

Dispatch Table¶

Direct Connect¶

E¶

Elicitation¶

ElicitationDialog¶

Embedding¶

ErrorBoundary¶

ESLint¶

Event Loop¶

Executable（.exe / 二进制）¶

ESLint¶

Event Loop¶

F¶

Fallback Model¶

FallbackTriggeredError¶

Feature Flag¶

FileEditTool¶

Flexbox¶

Flexport¶

G¶

Graceful Degradation¶

GrowthBook¶

Grouped Tool Use¶

Async Generator（`async function*`）¶

Async Generator（`async function*`）¶