2.2 2026.4.28 开源：不是慈善，是战略

2026 年 4 月 28 日，Warp 宣布客户端代码开源，采用双许可证：

• AGPL-3.0：主代码（强 copyleft，防止竞品直接 fork 商业化）
• MIT：UI 框架 crates（warpui_core + warpui，鼓励社区采用）

• Warp 的 Oz Agent 工作流默认使用 GPT 模型
• OpenAI 在终端层获得了一个"代理入口"

2.3 商业模式的真相

Warp 的开源揭示了一个经典模式：Vercel / Supabase 路线。

开源部分（AGPL）          闭源部分（商业）
┌──────────────┐        ┌──────────────┐
│ Warp Client  │   →    │ Oz 云编排平台 │
│  终端渲染     │        │ Agent 调度    │
│  Block 引擎   │        │ 多Agent协作   │
│  本地索引     │        │ 云沙盒       │
└──────────────┘        └──────────────┘
       ↓                       ↓
   获客/心智               $12/月 Pro  tier
   开发者社区              企业 Oz 平台

真正的产品是 Oz（cloud agent orchestration platform）。客户端开源 = "there is nothing left in the client worth cloning" 的诚实承认。

2.4 中国模型的进入

开源同时，Warp 新增 Kimi / MiniMax / Qwen 支持，加上 "auto (open)" 自动路由。这是中国开源大模型首次进入美国 frontier 开发者工具的默认选择面板——一个值得注意的信号。

---

第③章 4 层 Rust 全栈架构——98.2% Rust，63 Crates

3.1 为什么选 Rust？

Warp 的代码库 98.2% Rust。这不是炫技，而是工程刚需：

• 内存安全：终端处理不可信的 shell 输出、网络数据，use-after-free 和 buffer overflow 是传统 C/C++ 终端的噩梦
• 零成本抽象：GPU 渲染需要精细控制，Rust 的抽象不带来运行时开销
• fearless 并发：Tokio async runtime 管理多个 shell 会话、AI 通信、网络请求

3.2 四层架构

┌─────────────────────────────────────────┐
│  Application Layer (app/)               │
│  - ai/：Agent 系统集成                   │
│  - terminal/：Shell 会话管理             │
│  - drive/：云同步                        │
│  - workspace/：会话状态                  │
├─────────────────────────────────────────┤
│  WarpUI Framework (crates/warpui/)        │
│  - warpui_core：平台无关的组件模型       │
│  - warpui：wgpu 渲染后端 + winit 窗口    │
├─────────────────────────────────────────┤
│  Core Libraries (crates/)               │
│  - warp_core：平台抽象                   │
│  - editor：文本编辑                      │
│  - warp_terminal：终端模拟               │
│  - persistence：Diesel + SQLite         │
│  - command：Shell 命令处理               │
│  - computer_use：截图/自动化             │
├─────────────────────────────────────────┤
│  Cross-Platform Runtime                   │
│  - Tokio 1.47.1：Async runtime          │
│  - wgpu 29.0.1：WebGPU 渲染             │
│  - macOS / Windows / Linux / WASM        │
└─────────────────────────────────────────┘

3.3 关键依赖

3.4 63 Crates + 180+ Feature Flags

Warp 的模块化程度极高：63 个 workspace crates，180+ feature flags（dogfood / preview / release 三级）。这意味着每个组件可以独立开发、测试、编译——大规模系统编程的设计模式。

---

第④章 Block 模型——终端 40 年最大创新

4.1 什么是 Block？

Block 是 Warp 的核心抽象。每一个 shell 命令+输出被封装为一个独立的、可操作的单元：

传统终端：
┌─────────────────────────┐
│ $ ls -la                │ ← 只是文本
│ drwxr-xr-x  5 user ...  │
│ -rw-r--r--  1 user ...  │
│ $ git status             │ ← 只是文本
│ On branch main           │
└─────────────────────────┘

Warp Block 模型：
┌─────────────────────────┐
│ ┌─────────────────────┐ │
│ │ Block #1: ls -la    │ │ ← 结构化对象
│ │ [exit: 0] [2.3s]    │ │
│ │ drwxr-xr-x ...      │ │
│ └─────────────────────┘ │
│ ┌─────────────────────┐ │
│ │ Block #2: git status│ │ ← 结构化对象
│ │ [exit: 0] [0.8s]    │ │
│ │ On branch main      │ │
│ └─────────────────────┘ │
└─────────────────────────┘

4.2 Block 的 6 元数据

每个 Block 携带结构化元数据：

4.3 FlatStorage：O(1) 索引

Block 存储采用 FlatStorage 设计：

• 所有 Block 存储在连续的扁平缓冲区中
• 通过 SumTree 数据结构实现 O(log n) 视口查找
• BlockList 只关心每个 Block 的高度，不关心内部内容
• 双层虚拟化：

这意味着即使滚动 10 万行输出，Warp 仍保持 60fps。

4.4 结构化历史

5.2 五阶段渲染流水线

Element 树（描述 UI 结构）
    ↓
Layout（计算大小和位置）
    ↓
Paint（生成 Scene：矢量图元、文本字形、图像）
    ↓
Scene Graph（保留模式场景图，支持高效部分更新）
    ↓
wgpu Pipeline（顶点缓冲区 + GPU 绘制调用）
    ↓
Display（Metal / Vulkan / DX12）

5.3 Entity-Component-Handle：ECS 架构在终端中的应用

WarpUI 受 Flutter 启发，采用 Entity-Component-Handle 模式：

// 核心 Trait 体系
trait Entity { ... }     // 框架管理的对象句柄，引用计数，可观察变更
trait Model {            // 数据和业务逻辑
    fn update(&mut self, ctx: &mut ModelContext<Self>);
}
trait View {             // 可视化表示
    fn render(&self, ctx: &ViewContext<Self>) -> Element;
}

5.4 Glyph Atlas 批量渲染

首次渲染：
字符 'A' → CPU 光栅化（swash/cosmic-text）→ 上传 GPU 纹理图集
                                                         ↓
后续帧：                                               直接查找图集坐标
                                                         ↓
绘制纹理四边形（2 个三角形）←── 单次 draw call 完成整个终端

关键优化：

• 每个字符表示为带纹理坐标和颜色属性的纹理四边形
• 整个可见终端内容在一帧内通过 1-2 次 GPU 绘制调用完成
• 跨平台零成本：同一套代码编译为 Metal（macOS）、Vulkan（Linux）、DX12（Windows）

5.5 性能基准

---

第⑥章 3 步跑通 Warp Agent——5 分钟上手 AI Agent

6.1 Oz Agent 是什么？

Warp 的内置 Agent 代号 "Oz"，运行在内嵌的 Agent Mode 中。它有 25+ action types：

6.2 3 步上手

第 1 步：安装

# macOS
brew install --cask warp

# 或从源码构建
git clone https://github.com/warpdotdev/warp.git
cd warp
./script/bootstrap
./script/run

第 2 步：启用 Agent Mode

用户："set up a TypeScript project with ESLint and Prettier, init Git"

Oz：
1. 运行 npm init -y
2. 安装 TypeScript 依赖
3. 配置 ESLint + Prettier
4. 生成 .gitignore
5. 初始化 Git 仓库
6. （每一步等待用户确认或自动执行）

6.3 MCP 协议集成

Warp 支持 Model Context Protocol（MCP），这是 Anthropic 2024 年 11 月开源的标准：

Warp Agent ←── MCP ──→ Postgres MCP Server
        ←── MCP ──→ Linear MCP Server
        ←── MCP ──→ Sentry MCP Server
        ←── MCP ──→ 自定义工具

配置方式：

6.4 第三方 Agent Harness