---
url: /zh/apps/warp.md
---

# Warp

[Warp](https://www.warp.dev/) 是一款面向开发者的现代终端。**Protocol Launcher** 允许你生成深度链接，用于打开新的 Warp 窗口、标签页、Launch Configuration 和 Tab Config。

## 使用

提供两种使用方式：

* 按需加载（通过子路径导入），支持 Tree Shaking，体积更小。
* 全量导入（从根包导入），使用简单，但会包含所有应用模块。

生产环境建议使用按需加载以减小体积；快速脚本或演示可选择全量导入。

### 打开新窗口

```ts-vue [{{currentMethod}}]
import { {{ currentMethod === 'On-Demand' ? 'newWindow' : 'warp' }} } from '{{ importPath }}'

const url = {{currentMethod === 'On-Demand' ? '' : 'warp.'}}newWindow({
  path: 'path_to_folder',
})
```

### 打开新标签页

```ts-vue [{{currentMethod}}]
import { {{ currentMethod === 'On-Demand' ? 'newTab' : 'warp' }} } from '{{ importPath }}'

const url = {{currentMethod === 'On-Demand' ? '' : 'warp.'}}newTab({
  path: 'path_to_folder',
})
```

### 打开 Launch Configuration

```ts-vue [{{currentMethod}}]
import { {{ currentMethod === 'On-Demand' ? 'launchConfiguration' : 'warp' }} } from '{{ importPath }}'

const url = {{currentMethod === 'On-Demand' ? '' : 'warp.'}}launchConfiguration({
  path: 'launch_configuration_path',
})
```

### 打开 Tab Config

```ts-vue [{{currentMethod}}]
import { {{ currentMethod === 'On-Demand' ? 'tabConfig' : 'warp' }} } from '{{ importPath }}'

const url = {{currentMethod === 'On-Demand' ? '' : 'warp.'}}tabConfig({
  name: 'my_tab',
  newWindow: true,
})
```

### Warp Preview

Warp 官方 URI scheme 文档说明 Warp Preview 使用 `warppreview://` scheme。传入 `scheme: 'warppreview'` 即可让同一组 helper 指向 Warp Preview。

```ts-vue [{{currentMethod}}]
import { {{ currentMethod === 'On-Demand' ? 'newTab' : 'warp' }} } from '{{ importPath }}'

const url = {{currentMethod === 'On-Demand' ? '' : 'warp.'}}newTab({
  path: 'path_to_folder',
  scheme: 'warppreview',
})
```

[Warp URI Scheme 官方文档](https://docs.warp.dev/terminal/more-features/uri-scheme)

### 打开设置

打开设置，可选传入 page、搜索词 q 或设置项 widget ID。autoinstall 用于 mcp 页面；invite 在 teams 页面预填邮箱。scheme 也支持 warppreview。

```ts-vue [{{currentMethod}}]
import { {{ currentMethod === 'On-Demand' ? 'openSettings' : 'warp' }} } from '{{ importPath }}'

const url = {{currentMethod === 'On-Demand' ? '' : 'warp.'}}openSettings({
  page: 'mcp',
  autoinstall: 'my-server'
})
```

## 官方文档

* [URL scheme 官方说明](https://docs.warp.dev/terminal/more-features/uri-scheme#settings-deep-links)