# Terminal Integration

Cline 的终端集成让您可以直接将终端输出带到与 Cline 的对话中。无需复制和粘贴错误消息或命令结果，您只需在终端中右键单击即可将其发送给 Cline。

![终端集成](https://storage.googleapis.com/cline_public_images/docs/assets/terminal-integration.png)

### 右键单击终端集成

当您在 VSCode 终端中工作并看到想要与 Cline 讨论的输出时：

1. 在终端中右键单击
2. 从上下文菜单中选择"添加到 Cline"
3. 终端输出会立即发送到 Cline 聊天面板

这非常适合：

* 调试构建错误
* 理解测试失败
* 分析命令输出
* 获取错误消息的帮助

右键单击终端集成特别适合您已经在终端中工作并遇到问题的情况。

无需切换上下文到 Cline 聊天面板并输入问题描述，只需几次单击即可将终端输出直接发送给 Cline。

或者，您可以使用 [`@terminal`](https://github.com/HybridTalentComputing/cline-chinese/blob/main/features/at-mentions/terminal-mentions/README.md) 指令将完整的终端输出发送给 Cline。

有关在聊天消息中使用 \`@terminal\` 指令的信息，请参阅\[终端 指令]\(/features/at-mentions/terminal-mentions)文档。

### 终端集成的工作原理

当您使用右键单击终端集成时，Cline 会：

1. 捕获终端输出，保留所有格式
2. 包含完整的上下文，包括命令历史和结果
3. 为 AI 理解进行适当格式化
4. 使 AI 能够准确看到您所看到的内容

这为 Cline 提供了提供与终端相关问题准确帮助所需的完整上下文。

### 幕后工作

终端集成使用一种巧妙的技术来捕获终端输出：

1. 当您触发集成时，Cline 会：
   * 临时保存您当前的剪贴板内容
   * 选择所有终端内容（或使用您现有的选择）
   * 将其复制到剪贴板
   * 读取剪贴板以获取终端内容
   * 恢复您的原始剪贴板内容
2. 然后终端内容会：
   * 使用适当的语法高亮进行格式化
   * 添加到您的消息或作为新消息发送
   * 需要时使用其他上下文进行增强

这种方法确保所有终端输出（包括颜色和格式）都被准确捕获，而不会影响您的剪贴板。

### 有效使用的提示

* **对错误消息使用终端集成**：当您在终端中遇到错误时，将其发送给 Cline 通常比尝试描述错误能更快地解决问题。
* **需要时选择特定输出**：默认情况下，集成会捕获所有终端内容，但您也可以在右键单击之前选择特定行，以便仅关注相关输出。
* **将终端输出与文件提及结合使用**：将终端输出发送给 Cline 后，您可以使用 @ 指令功能提及相关文件来增强您的问题。
* **使用终端为构建和测试输出提供上下文**：终端集成特别适合理解跨越多行的复杂构建错误或测试失败。

下次您在终端中盯着一条神秘错误消息时，尝试使用 Cline 的终端集成而不是复制和粘贴。您将获得更准确的帮助，因为 Cline 可以看到具有正确格式的完整终端上下文。

### 终端问题故障排除

如果您在使用终端集成时遇到问题，例如"Shell 集成不可用"或命令不显示输出，请参阅我们的综合[终端集成故障排除指南](https://github.com/HybridTalentComputing/cline-chinese/blob/main/troubleshooting/terminal-integration-guide/README.md)。

故障排除指南涵盖：

* 常见的终端集成问题和快速修复
* Windows、macOS 和 Linux 的特定平台解决方案
* zsh、bash、PowerShell 等的特定 Shell 配置
* 高级调试技术
* 终端设置优化

\*\*快速修复\*\*：大多数终端问题可以通过在 Cline 设置中切换到 bash 并增加 shell 集成超时到 10 秒来解决。