glossary

核心概念

• Query Loop 基于异步生成器的执行引擎，负责 AI 对话和工具执行的核心流程。

• Tool 可被 AI 调用的功能单元，如文件读写、Shell 执行、代码分析等。

• Agent 独立的 AI 实例，可以执行特定任务。包括主 Agent 和子 Agent。

• Context AI 可以访问的信息，包括对话历史、文件内容、工具结果等。

• Token AI 模型处理文本的基本单位，约等于 0.75 个英文单词。

技术术语

• Anthropic API Claude AI 的官方 API，提供消息创建、流式响应、工具调用等功能。

• MCP (Model Context Protocol) Anthropic 推出的标准协议，用于 AI 应用与外部工具的集成。

• Zod TypeScript 类型验证库，提供运行时类型检查和类型推导。

• Ink React 渲染器，将 React 组件渲染到终端。

• AST (Abstract Syntax Tree) 抽象语法树，代码的结构化表示。

系统组件

• StreamingToolExecutor 流式工具执行器，支持并发执行多个工具。

• AppStateStore 极简状态管理器，管理应用的全局状态。

• BashTool Shell 命令执行工具，包含详细的权限检查。

• FileEditTool 文件编辑工具，使用 search-and-replace 机制。

• AgentTool 子 Agent 调用工具，支持同步和异步执行。

扩展机制

• Skill Markdown 格式的上下文注入，用于添加领域知识和指令。

• Plugin TypeScript 插件，可以添加新工具和修改核心行为。

• Hook 事件驱动的自动化，当特定事件发生时执行操作。

• Power 工具包，打包多个 MCP 服务器和文档。

压缩策略

• Tool Result Budget 限制单个工具结果的大小，防止占用过多 token。

• Microcompact 压缩工具调用历史，移除 AI 的思考过程。

• Context Collapse 折叠旧对话轮次，将其压缩为摘要。

• Auto Compact 自动触发的最终压缩策略。

执行模式

• Sync Execution 同步执行，主 Agent 等待子 Agent 完成。

• Async Execution 异步执行，子 Agent 在后台运行。

• Swarm Mode 多个 Agent 并行协作完成任务。

• Bridge Mode 通过 WebSocket/SSE 连接到远程客户端。

权限相关

• Permission Mode 权限模式，包括 Auto、Manual、Supervised 三种。

• Classifier AI 分类器，辅助权限决策。

• Sandbox 沙箱执行环境，隔离危险操作。

• Worktree Git worktree，为异步 Agent 提供隔离的工作目录。

下一步

• 查看 关键文件索引

• 浏览 目录结构

• 参考 参考资源