SuperAPI AI 工具集

warp

编程与开发

查看项目

更新于 10-16 06:56

技能介绍

Warp 是一款面向 macOS、Windows 与 Linux 的现代终端。

一、用途 Warp 将终端命令与其输出组织为 Block(命令块),每个 Block 可独立选中、复制和搜索,输入区是一个真正的文本编辑器。它内置编码智能体,可运行于应用内、作为 warp CLI,或以云端智能体形式工作,同时也可以运行 Claude Code、Codex 等第三方 CLI 智能体。应用为开源项目(AGPL v3,仓库 warpdotdev/warp)。该技能涵盖的是通过文件配置的部分:Workflows、Warp Drive、主题、Tab Configs 与 Launch Configurations。文档依据 docs.warp.dev 于 2026 年 10 月核对,其中 Workflows 文件格式为旧版 YAML 格式,Warp 表示仍然受支持。

二、安装 macOS 安装命令:brew install --cask warp Windows 与 Linux 使用 warp.dev 提供的安装程序或软件包(快速入门文档还列出了 WinGet 与 apt)。

三、Workflows(工作流) 工作流是带 {{argument}} 占位符的命名命令。参数名可使用字母、数字、连字符和下划线,且不能以数字开头。可在 Warp Drive(云端同步、可与团队共享)中创建,也可写成 YAML 文件;在 macOS 上,本地 YAML 文件放在 ~/.warp/workflows/。用 Ctrl+Shift+R 打开工作流搜索。社区集合位于 commands.dev(仓库 warpdotdev/workflows)。 YAML 字段包括:name、command、description、arguments(每项含 name、description、default_value)、tags、shells(为空表示全部)、source_url、author、author_url。文件格式没有条件判断,因此每个操作写一个工作流。

四、Warp Drive Warp Drive 是用于存放工作流、Notebook 及其他保存项的同步空间;团队在此共享内容,避免重复输入部署命令。通过 UI 创建的条目存放在云端,需要 Warp 账号。应将 Drive 条目视为共享内容:不要在默认值中放置令牌;在命令中从环境变量读取密钥。

五、Notebooks Notebook 是 Warp Drive 中可运行的文档:Markdown 加 shell 代码块。用 Cmd+Enter(macOS)或 Ctrl+Enter(Windows/Linux)运行代码块;{{name}} 占位符会变成参数。适合用于运行手册(runbook)。

六、自定义主题 主题文件为 YAML。目录:macOS ~/.warp/themes/,Windows %APPDATA%\warp\Warp\data\themes\,Linux ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/themes/。颜色必须为十六进制字符串。details 可取 darker 或 lighter;cursor 可选。现成主题见 github.com/warpdotdev/themes。

七、Tab Configs Tab Configs 是当前用于打开已保存标签页布局的方式;Warp 将 Launch Configurations 标记为旧版。它们是 TOML 文件,位于 ~/.warp/tab_configs/(macOS)、%APPDATA%\warp\Warp\data\tab_configs\(Windows)或 ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/tab_configs/(Linux)。可从标签栏的 + 菜单创建,也可右键标签并选择“Save as new config”,或者手动编写。

八、Launch Configurations(旧版) YAML 文件,位于 ~/.warp/launch_configurations/(macOS)、$env:APPDATA\warp\Warp\data\launch_configurations\(Windows)或 ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/launch_configurations/(Linux)。cwd 必须为绝对路径:使用 ~ 时该文件不会出现在列表中。

九、Blocks、智能体与编辑器 用 Cmd+Up/Down(macOS)或 Ctrl+Up/Down(Windows/Linux)选择最近的 Block;加 Shift 可扩展选择范围。失败的命令显示红色背景;粘性表头(sticky header)可在输出很长时保持命令可见。Shift+Enter 在输入编辑器中插入换行。Ctrl+Shift+Enter 打开智能体模式以提交自然语言请求。在应用之外,运行 warp 可使用 Warp Agent CLI。

十、使用准则 为不同环境之间会变化的内容都设置参数;为每个参数提供描述和贴近实际的默认值。将破坏性步骤置于确认之后(read -p),绝不让破坏性操作的参数默认指向生产目标。使用唯一且一致的标签(deploy、database、git)以便搜索。Warp 的文件位置因操作系统以及 Stable/Preview 版本而异;在排查主题或配置“缺失”问题之前,先确认所用平台对应的文档路径。团队条目使用 Warp Drive,同时在仓库中保留重要工作流的副本。智能体模式中输入的命令文本以及 Drive 内容可能被同步或发送给模型提供方;不要粘贴密钥。Warp 需要桌面图形界面,不适用于无头服务器。