zed-notify
在Zed终端中发送响铃通知代理完成
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：zed-notify。 它的用途是：在Zed终端中发送响铃通知代理完成 完整的 Skill 内容见：https://321skill.com/skills/zed-notify/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我安装zed-notify并配置Zed终端通知'，它会自动执行`pi install npm:zed-notify`命令，然后指导你在Zed的settings.json中添加`"terminal.bell": "system"`和`"agent.notify_when_agent_waiting": "primary_screen"`。之后每次Pi代理完成对话，Zed都会弹出视觉通知，让你无需频繁切换窗口。
介绍
这个Skill解决了在Zed终端线程中使用Pi代理时，无法及时获知任务完成的问题。实际开发中，开发者经常在终端中运行AI代理执行代码生成、数据分析等耗时任务，但切换窗口后容易错过完成时刻，需要频繁手动检查。
使用方式很简单，你只需要通过pi install npm:zed-notify安装，然后在Zed的settings.json中将terminal.bell设为"system"，并配置agent.notify_when_agent_waiting为"primary_screen"。之后Pi代理每次完成一轮对话时，会自动向终端写入\x07（BEL字符），Zed收到后会在屏幕上弹出视觉通知。
它非常适合需要在Zed终端中长时间运行AI代理工作流的开发者，尤其是那些同时处理多个任务、需要后台代理完成时立即知晓的团队或个人。对于已经习惯终端操作、希望保持工作流不中断的用户来说，这个轻量方案比系统弹窗更自然。
建议在配置时注意不要手动拷贝index.ts到扩展目录，否则会导致双源漂移，同一事件触发两次响铃。另外，Zed的视觉通知仅在终端线程非聚焦时生效，如果线程已处于前台，可能不会弹出通知，这是Zed本身的设计限制。
常见问题
如何验证zed-notify是否正常工作？
在Zed终端线程中运行`printf '\a'`，如果看到系统通知或听到响铃，说明bell通路正常；然后执行`pi --no-session -e /absolute/path/to/zed-notify -p "reply once: test"`测试扩展。如果Zed弹出视觉通知，则安装成功。
为什么安装了扩展但没有看到通知？
请检查Zed的`settings.json`中是否设置了`"terminal.bell": "system"`，以及`agent.notify_when_agent_waiting`是否为`"primary_screen"`或`"all_screens"`。另外，如果终端线程当前处于聚焦状态，Zed可能不会显示视觉通知，这是正常行为。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/zed-notify/raw/index.md 读取 zed-notify 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/zed-notify/raw/index.md（查看排版版本）