跳过主要内容
终端提及功能允许你将终端输出直接带入与 Cline 的对话中。只需输入 @terminal,Cline 即可看到你终端的最新输出。 当你在聊天中输入 @ 时,从菜单中选择“终端”或直接输入 @terminal。Cline 将立即看到你活动终端的最新输出,包括错误消息、构建日志或命令结果。 我经常在处理构建错误、测试失败或调试输出时使用终端提及。与其尝试复制粘贴终端输出(这通常会丢失格式),我不如直接询问:
I'm getting this error when running my tests: @terminal

What's causing this and how can I fix it?
这会向 Cline 提供完整的终端输出,并保持所有格式完整。然后,Cline 可以分析错误消息、堆栈跟踪和周围的上下文,以提供更准确的帮助。 终端提及与文件提及结合使用时尤其强大。当我调试失败的 API 调用时,我会同时引用两者:
I'm getting this error when calling my API: @terminal

Here's my API client code: @/src/api/client.js
And the endpoint implementation: @/src/server/routes/users.js

What am I doing wrong?
这种方法为 Cline 提供了所需的一切——精确的错误输出、客户端代码和服务器实现——而无需我手动复制任何内容。 下次你在遇到命令输出或构建错误问题时,尝试使用 @terminal 而不是复制输出。你将获得更准确的帮助,因为 Cline 可以看到包含正确格式的完整终端上下文。

幕后工作原理

当你在消息中使用终端提及时,幕后会发生什么
  1. 当你发送消息时,Cline 会检测文本中的 @terminal 模式
  2. 扩展程序调用 getLatestTerminalOutput(),该函数访问 VSCode 的终端 API
  3. 它捕获活动终端的最新输出缓冲区
  4. 终端输出以结构化格式附加到你的消息中
    <terminal_output>
    $ npm run test
    > [email protected] test
    > jest
    
    FAIL src/components/__tests__/Button.test.js
    ● Button component › renders correctly
    
    [Complete terminal output with formatting preserved]
    </terminal_output>
    
  5. 此包含嵌入式终端输出的增强消息被发送给 AI
  6. AI 现在可以“看到”保留所有格式的完整终端输出
此过程在你使用终端提及时自动发生,使 AI 能够访问你的命令结果、错误消息和其他终端输出,而无需你手动复制。

解决终端问题

如果你在使用终端提及或一般的终端集成方面遇到问题(例如“Shell 集成不可用”或命令未显示输出),请参阅我们全面的终端集成故障排除指南 常见问题包括:
  • 终端提及未捕获输出
  • Cline 聊天中出现“Shell 集成不可用”消息
  • 命令已执行但输出对 Cline 不可见
  • 终端集成工作不稳定
故障排除指南提供了特定于平台的解决方案和详细的配置步骤来解决这些问题。