# 通过 Copilot CLI 使用语音输入

使用 CLI 的语音转文本功能，向 GitHub Copilot CLI说出你的提示词，而不必键入它们。

语音输入让你可以通过对着麦克风说话，向 Copilot CLI 口述提示词，而不是用键盘输入。 转录完全在您的本地设备上运行。 音频不会通过网络发送。 识别的文本插入到提示输入区域中的光标位置，你可以在其中编辑它，然后再提交。

## 先决条件

你需要一个已连接到你的计算机且可正常工作的麦克风。 默认情况下，语音输入使用系统的默认麦克风。

## 限度

语音输入目前仅支持英语和西班牙语听写。 英语是语音识别的默认语言。

## 启用语音输入

在可以听写提示之前，需要下载支持语音识别的语音运行时和语音模型。

1. 在交互式 Copilot CLI 会话中，输入 `/voice` 斜杠命令。

2. 出现提示时，选择 **“继续** ”下载语音运行时。

   下载在后台进行。 在其完成期间，您仍可继续使用 Copilot CLI。

3. 当系统提示你选择语音模型时，按 <kbd>Enter</kbd> 并选择“下载默认模型”以下载英语语音转文本模型。

   或者，如果要用西班牙语口述：

   1. 使用键盘上的箭头键选择“浏览模型”，然后按 <kbd>Enter</kbd>。
   2. 在语音模型选取器中，使用箭头键选择西班牙语语音转文本模型，然后按 <kbd>Enter</kbd> 下载它。
   3. 按 <kbd>Esc</kbd> 退出选取器。

## 使用语音输入

有两种口述提示词的方式。

### 用于简短提示

1. 按住键盘上的空格键。

   片刻之后，录制开始。

2. 说出你的提示词。

3. 释放空格键。

Copilot CLI 会将你的语音转写成文字，并将转写结果插入提示词输入区域中光标所在的位置。

### 对于较长的提示

你可以打开和关闭语音录制，而不是按住空格键。 对于较长的提示词，这样更方便。

1. 按 <kbd>Ctrl</kbd>+<kbd>X</kbd>，然后按 <kbd>V</kbd> 开始录制。
2. 说出你的提示词。
3. 按任意键停止录制并插入听录。

### 清理通过语音输入的提示词

（可选）若要通过说话来清理输入的提示，可以使用 `/refine` 斜杠命令。 此命令：

* 删除填充词、错误的开头或重复。
* 应用你所做的所有自行更正。
* 修复语法错误。
* 为了清楚起见，将相关点分组。

要清理当前提示，请执行以下操作：

1. 在提交提示之前，请按 <kbd>Ctrl</kbd>+<kbd>X</kbd> ，然后快速按 <kbd>/</kbd>。
2. 键入 `/refine`，然后按 <kbd>Enter</kbd>。

## 切换麦克风

如果系统上有多个麦克风可用，则可以切换输入设备。

1. 输入`/voice devices`斜杠命令。

   将显示可用输入设备的列表。

2. 使用键盘上的箭头键选择要使用的麦克风，然后按 <kbd>Enter</kbd>。

## 切换语音模型

您可以用英语或西班牙语口述提示，但必须下载并启用与您想使用的语言对应的语音模型。

若要更改为其他语音模型，请执行以下操作：

1. 输入`/voice models`斜杠命令。

   语音模型选择器已显示。 对勾表示当前处于活动状态的模型。

2. 在语音模型选取器中，使用键盘上的箭头键选择英语或西班牙语语音转文本，然后按 <kbd>Enter</kbd>。

   如果模型尚未下载，则会将其下载到计算机。

3. 如果下载了模型，请再次按 <kbd>Enter</kbd> 将其设为活动模型。

选择的模型（以及语音输入是启用还是禁用）存储在 Copilot 设置文件中（通常 `~/.copilot/settings.json`），以便首选项在 CLI 会话之间持久保存。

## 延伸阅读

* [使用 GitHub Copilot CLI](/zh/copilot/how-tos/copilot-cli/use-copilot-cli/overview)