终端集成

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

​

右键终端集成

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

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

这非常适合用于

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

当您已经在终端中工作并遇到问题时，右键终端集成特别有用。 您无需切换到 Cline 聊天面板并输入问题的描述，只需点击几下即可将终端输出直接发送给 Cline。 或者，您可以使用 @terminal 提及来将完整的终端输出发送给 Cline。

​

终端集成的工作原理

当您使用右键终端集成时，Cline

1. 捕获终端输出并保留所有格式
2. 包括完整的上下文，包括命令历史记录和结果
3. 将其格式化以便 AI 理解
4. 使 AI 能够准确地看到您所看到的内容

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

​

幕后原理

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

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

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

​

有效使用的技巧

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

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

​

终端问题排查

如果您遇到终端集成问题，例如“Shell Integration Unavailable”或命令未显示输出，请参阅我们全面的 终端集成故障排除指南。 故障排除指南涵盖：

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