Skip to main content

终端集成

Caret 的终端集成让您可以将终端输出直接带入与 Caret 的对话中。无需复制和粘贴错误消息或命令结果，您可以通过在终端中简单的右键单击将它们发送给 Caret。

终端集成

右键终端集成​

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

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

这非常适合：

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

当您已经在终端中工作并遇到问题时，右键终端集成特别有用。

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

或者，您可以使用 @terminal 引用将完整的终端输出发送给 Caret。

tip

有关在聊天消息中使用 @terminal 引用的信息，请参阅终端引用文档。

终端集成的工作原理​

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

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

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

幕后工作原理​

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

  1. 当您触发集成时，Caret：

    • 临时保存您当前的剪贴板内容
    • 选择所有终端内容（或使用您现有的选择）
    • 将其复制到剪贴板
    • 读取剪贴板以获取终端内容
    • 恢复您原始的剪贴板内容

  2. 然后终端内容：

    • 使用适当的语法高亮格式化
    • 添加到您的消息或作为新消息发送
    • 在需要时增强额外的上下文

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

有效使用技巧​

  • 为错误消息使用终端集成：当您在终端中遇到错误时，将其发送给 Caret 通常比尝试描述错误能更快地解决问题。

  • 在需要时选择特定输出：默认情况下，集成捕获所有终端内容，但您也可以在右键单击之前选择特定行以专注于相关输出。

  • 将终端输出与文件引用结合：将终端输出发送给 Caret 后，您可以通过使用 @ 引用功能提及相关文件来增强您的问题。

  • 用终端将构建和测试输出上下文化：终端集成对于理解跨多行的复杂构建错误或测试失败特别有用。

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

终端问题故障排除​

如果您遇到终端集成问题，例如"Shell Integration Unavailable"或命令不显示输出，请参考我们的综合终端集成故障排除指南。

故障排除指南涵盖：

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

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