Warp 项目介绍

Warp 项目介绍

项目定位

Warp 是一个 Agentic 开发环境（Agentic Development Environment），本质上是一个用 Rust 构建的现代化终端模拟器。它不只是「更快的终端」，而是将 AI 编码 Agent 深度嵌入终端体验的核心层——用户既可以使用内置的 Agent Mode，也可以接入外部 CLI Agent（Claude Code、Codex、Gemini CLI 等）。

一句话总结：Warp 用 Rust 重写了终端体验，将终端模拟、自研 UI 框架、AI Agent 编排和多模型管理融合为一个统一的开发环境。

核心能力

1. 终端模拟：基于 VT100/ANSI 标准的完整终端仿真，支持多 Shell 管理、SSH 远程会话、WSL 和 tmux 集成
2. AI Agent Mode：内置 AI 编码 Agent，支持代码编辑、命令执行、代码搜索、MCP 工具调用等多种工具
3. 多 Agent 编排：通过 OrchestrationV2 系统编排多个子 Agent 协同工作，支持本地和云端两种执行模式
4. 多 Harness 支持：可切换 Oz（Warp 自有）、Claude Code、Codex、Gemini CLI、OpenCode 等多种 AI Agent CLI 作为后端
5. MCP 协议集成：通过 rmcp Rust 客户端实现 MCP SSE 传输层，Agent 可调用外部 MCP Server 的工具和资源
6. Skills 系统：兼容 .agents/skills、.claude/skills、.codex/skills 等多 Provider 的 Skill 目录标准
7. 代码索引与 RAG：基于 tree-sitter 的代码库索引，支持源码嵌入（full source code embedding）与语义搜索
8. Cloud Mode：将 Agent 执行卸载到云端环境，支持远程工作空间与持久化对话
9. Computer Use：支持 AI 控制鼠标/键盘的计算机使用能力

技术栈

层级	技术
语言	Rust (2021 edition)
构建系统	Cargo Workspace（60+ crates）
异步运行时	Tokio + Smol
UI 框架	WarpUI（自研 Entity-Component-Handle 模式）
GPU 渲染	wgpu（支持 Metal/Vulkan/DX12/GLES）
终端仿真	warp_terminal（fork 自 Alacritty 核心逻辑）
ORM	Diesel + SQLite
API 协议	GraphQL（Cynic 客户端）
MCP 客户端	rmcp（SSE 传输层）
代码解析	tree-sitter（arborium 绑定）
跨平台	macOS / Windows / Linux / WASM
崩溃报告	Sentry
内存分配	jemalloc（Warp fork）

架构概览

架构要点：

• warpui_core 是基础框架层：定义了 App（全局状态持有者）、Entity（视图/模型实体）、Handle（实体间引用）、Element（Flutter 风格的视觉描述）和 Presenter（事件/布局/渲染管线）
• app/ 是主应用，通过 WarpUI 框架组织所有视图和模型
• Agent Driver 是 AI Agent 的核心执行引擎：接收 prompt → 准备环境（MCP Server、Skills、代码索引）→ 启动 Harness CLI → 通过 SSE 监听事件流 → 将 Agent 动作（工具调用）结果反馈给终端
• Harness 抽象 将不同 AI CLI 统一为一个 ThirdPartyHarness trait，每个 Harness 自行处理 CLI 参数、环境变量、恢复协议和输出解析
• Feature Flag 系统 使用编译时枚举 + 运行时 AtomicBool 数组，支持 Dogfood/Preview/Release 三层渐进式发布

快速体验

Warp 目前主要支持 macOS，Linux/Windows 支持正在完善中。

# 1. 克隆仓库
git clone https://github.com/warpdotdev/warp.git
cd warp

# 2. 平台依赖安装
./script/bootstrap

# 3. 构建并运行
./script/run

# 4. 运行预提交检查（fmt + clippy + 测试）
./script/presubmit

教程导读

本教程从两个维度分析 Warp 项目：

AI 应用通用知识（ai/ 目录）

章节	知识点	关联 Common 教程
01	Agent 工具调用协议	工具调用协议
02	多 Agent 编排架构	多 Agent 路由
03	MCP 协议集成	MCP 协议
04	Skills 系统设计	Skill 设计
05	代码索引与 RAG	RAG 策略
06	Feature Flag 与渐进式发布	首次覆盖

编程核心技术（dev/ 目录）

章节	知识点
01	Rust Cargo Workspace 架构设计
02	WarpUI Entity-Component-Handle 框架
03	终端仿真核心（warp_terminal）
04	GPU 加速渲染管线（wgpu）
05	跨平台适配策略（macOS/Windows/Linux/WASM）
06	构建系统与 Profile 优化