终端 > 更多功能
桌面通知
# 桌面通知 import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; ## 这是什么 当命令在可配置的秒数后完成,或者正在运行的命令需要您输入密码才能继续时,可以发送通知。对于这两个触发器,Warp 仅在您在触发器触发时正在使用其他应用程序的情况下,才会向您发送桌面通知。 :::note 有关来自编码代理(Warp 内置的 Agent 以及 Claude Code 和 OpenCode 等第三方 CLI 代理)的通知,请参阅 [代理通知](/agent-platform/capabilities/agent-notifications/)。 ::: ## 自定义通知挂钩 (OSC 9 / OSC 777) Warp 支持由终端转义序列触发的可插拔通知,因此脚本和工具可以在无需额外依赖的情况下引发桌面通知。 - OSC 9(仅限正文):发送仅包含正文的通知。 - 格式:`ESC ] 9 ; BEL` - 示例 (bash/zsh):`printf '\033]9;构建完成\007'` - OSC 777(标题 + 正文):发送带有标题和正文的通知。 - 格式:`ESC ] 777 ; notify ;当长时间运行的命令完成或需要您的输入时,接收桌面通知。
它是什么
标题为“它是什么”的章节当命令在可配置的秒数后完成,或者正在运行的命令需要您输入密码才能继续时,可以发送通知。对于这两个触发器,Warp 仅在您在触发器触发时正在使用其他应用程序的情况下,才会向您发送桌面通知。
自定义通知挂钩 (OSC 9 / OSC 777)
标题为“自定义通知挂钩 (OSC 9 / OSC 777)”的章节Warp 支持由终端转义序列触发的可插拔通知,因此脚本和工具可以在无需额外依赖的情况下引发桌面通知。
- OSC 9(仅限正文):发送仅包含正文的通知。
- 格式:
ESC ] 9 ; BEL - 示例 (bash/zsh):
printf '\033]9;构建完成\007'
- 格式:
- OSC 777(标题 + 正文):发送带有标题和正文的通知。
- 格式:
ESC ] 777 ; notify ;; BEL - 示例 (bash/zsh):
printf '\033]777;notify;部署;生产环境成功\007'
- 格式:
注意
- 适用于允许 Warp 显示通知的 macOS、Windows 和 Linux。
- 负载中应避免使用或转义换行符和分号。
- 此功能在当前的 Warp 版本中默认启用。
如何访问
标题为“如何访问”的章节- 通知默认开启,需要系统权限才能显示。
- 如果您之前关闭了通知,请转到 设置 > 功能 > 会话 重新切换开启,或者使用 命令面板 快速切换通知。
- 转到 设置 > 功能 > 通知,自定义长时间运行命令或密码提示的通知触发器。
工作原理
标题为“工作原理”的章节通知故障排除
标题为“通知故障排除”的章节Warp 需要两个不同的通知设置才能工作。必须同时启用 > 系统设置 > 通知与专注模式 中的 macOS 系统设置和 设置 > 功能 > 会话 中的 Warp 应用设置,通知才能显示。
如果您已在系统和 Warp 中启用了通知,但仍未收到桌面通知,请尝试以下操作
- 确保当您期望收到通知时,您已切换离开 Warp。
- 确保 > 系统设置 > 通知 > 通知与专注模式 > 专注模式 中的 勿扰模式 已关闭。
- 转到 > 系统设置 > 通知与专注模式 > 通知 并在列表中选择 Warp。确保选中了横幅样式或提醒样式通知,然后退出并重启 Warp。
- 要让 macOS 再次显示 Warp 的通知提示,请运行
defaults delete dev.warp.Warp-Stable Notifications,然后重启 Warp 并切换开启 设置 > 功能 > 接收来自 Warp 的桌面通知。 - 完成上述所有操作后,请重启 macOS 以应用更改,这应该有助于恢复 Warp 中的通知。
Warp 需要两个不同的通知设置才能工作。必须同时启用 设置 > 系统 > 通知 > Warp 中的 Windows 系统设置和 设置 > 功能 > 会话 中的 Warp 应用设置,通知才能显示。
如果您已在系统和 Warp 中启用了通知,但仍未收到桌面通知,请尝试以下操作
- 确保当您期望收到通知时,您已切换离开 Warp。
- 确保 勿扰模式 或 专注模式 已关闭。
- 转到 系统 > 通知 并在列表中选择 Warp。确保通知已开启,然后退出并重启 Warp。
Warp 需要两个不同的通知设置才能工作。必须同时启用 设置 > 通知 > Warp 中的 Linux 系统设置和 设置 > 功能 > 会话 中的 Warp 应用设置,通知才能显示。
如果您已在系统和 Warp 中启用了通知,但仍未收到桌面通知,请尝试以下操作
- 确保当您期望收到通知时,您已切换离开 Warp。
- 确保 勿扰模式(如果您的发行版支持)已关闭。
- 转到 设置 > 通知 并在列表中选择 Warp。确保通知已开启,然后退出并重启 Warp。
如果您有任何其他问题,请 联系我们。