pi-notify
通过OSC或Windows Toast为Pi Agent发送桌面通知
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-notify。 它的用途是：通过OSC或Windows Toast为Pi Agent发送桌面通知 完整的 Skill 内容见：https://321skill.com/skills/pi-notify/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“运行完数据备份脚本后，用桌面通知告诉我结果。”，它会调用pi-notify，在你的电脑右下角弹出“数据备份完成”或“备份失败”的提示框，让你即使最小化了聊天窗口也能立刻看到。
介绍
pi-notify 解决了Pi Agent在后台运行时，用户无法及时获知其任务状态或重要信息的问题。它允许Pi Agent通过发送特定OSC信号（端口777、99、9）或调用Windows原生Toast通知，在用户桌面上弹出即时提醒，将AI的反馈从纯文本对话延伸至系统级的视觉提示。
使用方式非常直接。开发者只需在Pi Agent的代码或配置中集成pi-notify，并在需要通知时调用相应的API，发送消息内容。对于Windows用户，它会利用系统的通知中心；对于其他支持OSC协议的监听程序，也能可靠地接收信号并触发提醒。
这个Skill非常适合那些需要长时间运行Pi Agent执行自动化任务（如监控、数据处理、构建）的开发者或高级用户。当任务完成、出错或达到某个关键节点时，用户无需紧盯终端或聊天窗口，桌面通知能让他们及时知晓并处理。
使用建议是，确保接收通知的系统环境已正确配置。对于OSC方式，需要有一个常驻的桌面通知客户端（如某些音乐软件或专用工具）在监听指定端口。注意事项是，它主要增强的是本地或内网环境下的使用体验，对于纯远程或无图形界面的服务器环境，其效用会大打折扣。
核心特点
核心区别在于它提供了OSC和Windows Toast双通道通知机制，OSC协议使其能轻松与众多支持该协议的创意编程或媒体软件集成，而Windows Toast则提供了原生、美观的系统级提醒。
注意事项
不适合在无图形界面或严格禁止弹窗的服务器/生产环境中使用。
常见问题
pi-notify支持macOS或Linux的桌面通知吗？
主要依赖Windows Toast和OSC，在macOS/Linux上需通过OSC并搭配第三方通知客户端实现。
如何测试OSC通知是否发送成功？
可以使用OSC监听工具（如OSC Monitor）监听777、99、9端口来验证。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-notify/raw/index.md 读取 pi-notify 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-notify/raw/index.md（查看排版版本）