通用输入 (旧版)

注意

这是旧版文档。 通用输入已由 智能体模态 (Agent Modality) 取代，它提供了更简洁的终端体验，并为智能体交互提供了专用的对话视图。

通用输入 (Universal Input) 曾是使用 Warp 的主要输入界面。

带有上下文建议块的通用输入。

解析通用输入

通用输入将 Warp 的所有输入功能整合到一个精简的编辑器中

• 自然语言自动检测：Warp 可以自动检测您是否在使用纯英语书写（而非 shell 命令），并将您切换到 智能模式 (Agent Mode)。
• 上下文建议块 (Contextual chips)：直接在输入框内查看您当前目录、过往对话、Git 状态、Node 版本等信息。
• 现代文本编辑：享受类似 IDE 的编辑功能，例如 命令补全、语法高亮、鼠标支持、矩形选择 和 下一条命令 预测。
• 输入工具栏：快速访问 @-上下文、斜杠命令、语音输入、图片附件 及其他 AI 功能。

如果您更喜欢传统的终端输入体验，可以在 Settings > Appearance > Input 中切换到 经典输入 (Classic Input)。经典输入同样支持 oh-my-posh、PS1 自定义和 行内提示符。

输入模式

通用输入支持三种模式，在输入切换器中显示

1. 智能模式 (Agent Mode，自然语言)

用自然语言要求 Warp 的智能体构建、调试或运行任务。Warp 使用领先的大语言模型 (LLM) 来理解您的请求、运行正确的命令、展示代码差异，并将结果直接流式传输到您的会话中。

指示器： 切换器中高亮显示智能体图标。

锁定在智能模式下的通用输入。

2. 终端模式 (Terminal Mode，shell 命令)

像在任何终端中一样输入 shell 命令，并享受 Warp 的现代编辑功能——包括补全、语法高亮、错误下划线等。

指示器：切换器中高亮显示终端图标

锁定在终端模式下的通用输入。

3. 自动检测模式

Warp 会自动检测您的输入是自然语言还是 shell 命令。您可以停留在检测模式，也可以明确锁定在终端模式或智能模式。

指示器：没有模式高亮。

处于空状态/零状态的通用输入。

当 Warp 检测到输入类型时，输入切换器会轻微高亮显示相应的模式。

已检测到智能模式 (自然语言)。

已检测到终端模式 (shell)。

注意

Warp 用于自动检测自然语言的模型完全在本地运行。

禁用自然语言自动检测

默认情况下，自动检测是开启的。这意味着 Warp 会决定将您的输入视为命令还是智能体提示。

• 关闭自动检测：前往 Settings > AI > Input > Natural Language Detection
• 禁用后：您将明确处于终端模式或智能模式。使用以下键盘快捷键在模式间切换
  • CMD+I (macOS)
  • CTRL+I (Windows/Linux)

已启用智能模式 (自然语言)。

已启用终端模式 (shell)。

进入智能模式 (Agent Mode)

智能模式 (Agent Mode) 是您直接与 Warp 的 AI 交互以提问、运行任务和进行自然语言协作的方式。根据您的工作流程，有多种进入智能模式的方法

macOS

• 直接输入自然语言：如果启用了自动检测，您可以在输入框中键入任务或问题，Warp 会使用其本地自动检测功能将其识别为自然语言。
• 使用键盘快捷键：使用 CMD + I 快速切换到智能模式。
• 将块附加到提示词：从任何您想要用作上下文的块中，点击工具栏中的 ✨ 图标，或从块的右键菜单中选择“Attach block(s) to AI query”。
• 用特殊字符强制切换模式:
  • ! 在输入开头强制进入终端模式。
  • * 在输入开头强制进入智能模式。
• 手动切换模式：点击输入切换器中的智能体图标以锁定智能模式，或点击终端图标切换到终端模式。

Windows

• 直接输入自然语言：如果启用了自动检测，您可以在输入框中键入任务或问题，Warp 会使用其本地自动检测功能将其识别为自然语言。
• 使用键盘快捷键：使用 CTRL + I 快速切换到智能模式。
• 将块附加到提示词：从任何您想要用作上下文的块中，点击工具栏中的 ✨ 图标，或从块的右键菜单中选择“Attach block(s) to AI query”。
• 用特殊字符强制切换模式:
  • ! 在输入开头强制进入终端模式。
  • * 在输入开头强制进入智能模式。
• 手动切换模式：点击输入切换器中的智能体图标以锁定智能模式，或点击终端图标切换到终端模式。

Linux

• 直接输入自然语言：如果启用了自动检测，您可以在输入框中键入任务或问题，Warp 会使用其本地自动检测功能将其识别为自然语言。
• 使用键盘快捷键：使用 CTRL + I 快速切换到智能模式。
• 将块附加到提示词：从任何您想要用作上下文的块中，点击工具栏中的 ✨ 图标，或从块的右键菜单中选择“Attach block(s) to AI query”。
• 用特殊字符强制切换模式:
  • ! 在输入开头强制进入终端模式。
  • * 在输入开头强制进入智能模式。
• 手动切换模式：点击输入切换器中的智能体图标以锁定智能模式，或点击终端图标切换到终端模式。

当您处于智能模式时，智能体图标将在 [通用输入](/terminal/input/universal-input/) 中高亮显示

通用输入中的智能模式指示器。

在经典输入中，您还会看到一个行内的 ✨ 闪烁指示器。

经典输入中的智能模式激活指示器。

默认情况下，进入智能模式后会启动 配对模式 (Pair Mode)，您可以通过提出后续问题或分配任务来继续正在进行的对话。在此模式下，您可以要求智能体根据需要构建、调试、修复甚至部署代码。

退出智能模式或终端模式

您可以通过以下几种方式退出智能模式或终端模式

macOS

• 键盘快捷键
  • 按 ESC 退出当前模式。
  • 使用 CMD + I 切换模式
• 用特殊字符强制切换模式
  • ! 在输入开头强制进入终端模式。
  • * 在输入开头强制进入智能模式。
• 手动切换：点击输入切换器中的智能体图标或终端图标直接切换模式。

Windows

• 键盘快捷键
  • 按 ESC 退出当前模式。
  • 使用 CTRL + I 切换模式
• 用特殊字符强制切换模式
  • ! 在输入开头强制进入终端模式。
  • * 在输入开头强制进入智能模式。
• 手动切换：点击输入切换器中的智能体图标或终端图标直接切换模式。

Linux

• 键盘快捷键
  • 按 ESC 退出当前模式。
  • 使用 CTRL + I 切换模式
• 用特殊字符强制切换模式
  • ! 在输入开头强制进入终端模式。
  • * 在输入开头强制进入智能模式。
• 手动切换：点击输入切换器中的智能体图标或终端图标直接切换模式。

自然语言自动检测设置

Warp 可以自动检测您何时使用纯英语书写，并将您切换到智能模式。如有需要，您可以自定义或禁用此行为。

修复误报

如果某些 shell 命令被错误地检测为自然语言，您可以将它们添加到拒绝列表： Settings > AI > Input > Natural language denylist

关闭自动检测

要完全禁用自然语言检测，请前往： Settings > AI > Input Auto-detection

禁用自动检测后，您需要使用 CMD + I (macOS) 或 CTRL + I (Windows/Linux) 在终端模式和智能模式之间显式切换。

首次设置

首次进入智能模式时，Warp 会显示一个横幅，其中包含为您命令行关闭自然语言检测的选项

自然语言检测开关。

---

上下文建议块 (Chips)

通用输入的上下文建议块。

通用输入包含 上下文建议块 (contextual chips)，可提供有关您当前环境的行内信息。这些建议块显示目录路径、Git 状态、对话或运行时版本等相关详细信息，使您无需离开输入框即可轻松导航、管理上下文并执行快速操作。

对话管理建议块

对话管理建议块显示您最近的 智能体对话，允许您直接引用或重新打开它们。

这些建议块在智能模式和终端模式下都会出现，因此您可以继续之前的对话而无需从头开始。更多详细信息，请参阅 智能体对话。

对话管理建议块。

这些建议块在智能模式和终端模式下都会出现，帮助您继续之前的对话而无需从头开始。更多详细信息，请参考 智能体对话。

活动目录建议块

活动目录建议块显示您当前的工作目录并实现简单的文件导航。点击文件夹可进入该文件夹，点击文件则会在 Warp 的原生代码编辑器 中打开它。这使得从输入框内无缝地移动工作空间成为可能。

活动目录建议块。

Git 状态建议块

当您位于 Git 跟踪的仓库中时，Git 状态建议块会显示文件和行级的变更。您可以点击分支名称切换分支，或在 Warp 的 原生代码审查面板 中查看已修改的文件。

随着文件的添加、删除或更改，建议块会自动更新，让您实时了解仓库状态。

Git 状态建议块。

文件附件建议块

文件附件建议块允许您直接向提示词添加图片和其他文件。您可以使用工具栏中的上传按钮或通过拖放文件到输入框，一次上传最多五个 图片 (作为智能体上下文)。这使得将截图、图表、PDF 或其他参考资料直接添加到查询中成为可能，从而为智能体提供更丰富的上下文。

文件附件建议块。

Node 版本建议块

在包含 package.json 的仓库中，会显示一个 Node 版本建议块以显示检测到的 Node.js 版本。这使您无需运行额外命令即可了解运行时环境。

Node 版本建议块。

注意

目前，上下文建议块不可配置，但它们会根据您的工作空间和仓库状态自动更新。

---

输入工具栏

输入工具栏 (Input Toolbelt) 提供通用输入旁边的快速访问控件。这些工具允许您附加上下文、运行快捷方式以及配置智能体行为，而无需离开输入字段。根据您所处的模式，某些功能会自动启用或将您置入智能模式。

通用输入中的输入工具栏。

@ - 上下文

@ 上下文建议块 在您于 Git 仓库中工作时可用。在 Git 仓库之外，它显示为灰色。

此功能允许您附加特定文件、文件夹、代码符号、Warp Drive 对象或来自其他会话的块作为提示词的上下文。在输入框内键入 @ 也会打开一个上下文菜单，您可以在其中搜索并选择要包含的文件或目录。

使用 @ 附加上下文在智能模式（与智能体交互时）和经典终端命令（用于引用文件路径时）下均可使用。

斜杠命令

斜杠命令 在智能模式和自动检测模式下可用。它们允许您在不离开输入字段的情况下快速运行内置操作或保存的提示词。键入 / 会显示可用命令的菜单，这些命令可以自定义或扩展。

语音输入

语音输入 会自动将您置入智能模式。直接对着 Warp 说话，让您可以用自然语言表述任务、命令或查询，Warp 会像您键入一样解释它们。当您想要免提交互或口述较长任务时，此功能特别有用。

图片附件

您可以直接向提示词 附加图片作为上下文，这会自动将您置入智能模式。当您希望智能体参考截图、图表或其他素材等视觉材料时，这非常有用。

您可以使用工具栏中的图片上传按钮（根据您的输入布局位于左下方或右下方）添加图片。有关附加图片的更多方法，请参阅 图片作为上下文。

快速前进 (Fast Forward)

快速前进赋予智能体在任务或对话剩余部分的完全自主权。启用后，您输入的下一个提示词将允许智能体执行命令、读取文件并应用代码差异，而无需每次都请求确认。这对于那些逐步审批会拖慢速度的复杂工作流程非常有用。

配置选择器 (Profile Picker)

配置选择器允许您在不同的 智能体配置 之间进行选择，每个配置都有其各自的自主权、工具和默认模型设置。如果您只有一个配置，选择器将不会出现在 UI 中。

从配置选择器中，您可以查看所有可用配置、在它们之间切换，并快速查看附加到每个配置的默认模型。配置使得根据不同类型的任务或项目定制智能体行为成为可能。

模型选择器

模型选择器与您当前的智能体配置绑定。每个配置都有一个默认模型，但您可以随时使用选择器覆盖它。Warp 为您精心策划了一系列顶尖的大语言模型 (LLM)，根据您的需求平衡速度、质量和推理能力。

有关受支持模型的完整列表以及何时使用它们的指南，请参阅 模型选择。