pi-terminal-notifier
Pi 终端的 macOS 原生通知工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-terminal-notifier。 它的用途是：Pi 终端的 macOS 原生通知工具 完整的 Skill 内容见：https://321skill.com/skills/pi-terminal-notifier/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用pi-terminal-notifier运行数据备份脚本，备份完成后通知我'，它会执行 npm install -g pi-terminal-notifier，然后运行命令 pi-notifier --cmd 'backup.sh' --title '备份完成'，备份完成后弹出 macOS 原生通知，点击通知即可切换回 Pi 终端窗口。
介绍
在日常使用 Pi 终端（Pi.ai 的终端界面）时，常常需要长时间运行脚本、训练模型或执行异步任务，却无法实时感知任务完成状态。pi-terminal-notifier 解决了这一痛点，它通过 macOS 原生通知中心向用户发送任务完成、失败或中断的提醒，并支持专注模式感知（勿扰模式下自动静音），点击通知后可直接激活终端窗口，让你无需持续盯屏。
该工具内置了事件总线机制，允许开发者自定义通知触发条件，例如监听特定命令退出码、输出关键字或时间阈值。安装后只需在 Pi 终端中运行 npm 包提供的 CLI 命令，即可将当前命令的 stdout/stderr 与通知绑定，或通过 API 在脚本中嵌入通知逻辑。所有通知均采用系统原生样式，支持图标、标题和正文，并适配 macOS 的焦点模式。
适合经常使用 Pi 终端进行长时间任务的后端开发、运维工程师、智能体开发者，尤其是需要同时处理多个终端会话或频繁切换上下文的用户。对于依赖树莓派做边缘计算、本地 AI 推理或自动化脚本的开发者，也能显著提升任务监控效率。
建议在需要长时间运行的任务（如数据备份、模型训练、批量处理）中配合使用，避免因遗忘检查导致任务空转。注意该工具仅支持 macOS 系统，且依赖 Pi 终端环境（非标准终端模拟器），若需在 Linux 或 Windows 上使用，请考虑其他跨平台通知方案。
核心特点
与通用的终端通知工具（如 terminal-notifier）不同，pi-terminal-notifier 专为 Pi 终端设计，深度集成其事件总线，支持专注感知（勿扰/睡眠模式自适应）和点击激活 Pi 终端窗口，而非仅弹出通知。
注意事项
仅适用于 macOS 系统，且需要 Pi 终端运行时环境，不适合标准终端模拟器（如 iTerm2、Terminal.app）或 Linux/Windows 系统。
常见问题
如何安装 pi-terminal-notifier？
通过 npm 全局安装：npm install -g pi-terminal-notifier
是否支持在勿扰模式下静音？
支持，工具会检测 macOS 的专注模式，在勿扰状态下自动调整通知行为，避免打扰用户。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-terminal-notifier/raw/index.md 读取 pi-terminal-notifier 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-terminal-notifier/raw/index.md（查看排版版本）