> ## Documentation Index
> Fetch the complete documentation index at: https://cat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 终端提及

终端提及让你可以将终端输出直接引入与 Cline 的对话中。只需输入 `@terminal`，Cline 就能看到终端的最近输出。

当你在聊天中输入 `@` 时，从菜单中选择"终端"或直接输入 `@terminal`。Cline 将立即看到活动终端的最近输出，包括错误消息、构建日志或命令结果。

当我处理构建错误、测试失败或调试输出时，我一直在使用终端提及。不再需要尝试复制粘贴终端输出（这通常会丢失格式），我只需询问：

```
运行测试时出现这个错误：@terminal

这是什么原因，我该如何修复？
```

这为 Cline 提供了完整的终端输出，所有格式都保持完整。然后 Cline 可以分析错误消息、堆栈跟踪和周围上下文，提供更准确的帮助。

当与文件提及结合使用时，终端提及特别强大。当我调试失败的 API 调用时，我会引用两者：

```
调用我的 API 时出现这个错误：@terminal

这是我的 API 客户端代码：@/src/api/client.js
这是端点实现：@/src/server/routes/users.js

我做错了什么？
```

这种方法为 Cline 提供了所需的一切 - 确切的错误输出、客户端代码和服务器实现 - 而我无需手动复制任何内容。

下次遇到命令输出或构建错误问题时，尝试使用 `@terminal` 而不是复制输出。你会得到更准确的帮助，因为 Cline 可以看到具有正确格式的完整终端上下文。

## 底层工作原理

当你在消息中使用终端提及时，这是背后发生的情况：

1. 当你发送消息时，Cline 检测文本中的 `@terminal` 模式

2. 扩展程序调用 `getLatestTerminalOutput()`，它访问 VSCode 的终端 API

3. 它捕获活动终端的最近输出缓冲区

4. 终端输出以结构化格式附加到你的消息中：

   ```
   <terminal_output>
   $ npm run test
   > project@1.0.0 test
   > jest

   FAIL src/components/__tests__/Button.test.js
   ● Button component › renders correctly

   [保留格式的完整终端输出]
   </terminal_output>
   ```

5. 这个带有嵌入终端输出的增强消息被发送给 AI

6. AI 现在可以"看到"完整的终端输出，所有格式都得到保留

每当你使用终端提及时，这个过程都会自动发生，为 AI 提供你的命令结果、错误消息和其他终端输出的访问权限，而无需你手动复制。

## 终端问题故障排除

如果你在终端提及或终端集成方面遇到问题（例如"Shell 集成不可用"或命令不显示输出），请参考我们的综合[终端集成故障排除指南](https://cat.mintlify.site/troubleshooting/terminal-integration-guide.md)。

常见问题包括：

* 终端提及无法捕获输出
* Cline 聊天中出现"Shell 集成不可用"消息
* 命令执行但输出对 Cline 不可见
* 终端集成工作不一致

故障排除指南提供特定于平台的解决方案和详细的配置步骤来解决这些问题。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.