pi-all-notification

pi 多渠道通知扩展 — macOS 桌面通知 / Bark 推送 / 自定义 Webhook。

三种推送途径

| 渠道 | 说明 | 配置 | |------|------|------| | 🖥 macOS 原生通知 | 右上角弹窗通知，基于 osascript | 零配置，开箱即用 | | 📱 Bark 推送 | 推送到 iPhone（Bark） | 需配置设备 Key + Server | | 🔗 自定义 Webhook | 任意 HTTP 端点（Slack/Discord/飞书/钉钉/企业微信…） | 配置 URL + Method + Body 模板 |

安装

pi install npm:pi-all-notification

或通过 git：

pi install git:github.com/RealAlexandreAI/pi-all-notification

重启 pi（或 /reload）。

使用

Agent 自动触发

Agent 完成响应时自动通知（agent_end 事件）。可在设置面板 toggle 触发时机。

Agent 手动调用

Agent 可主动调用 notify_user 工具发送通知：

notify_user({
  title: "Build Failed",
  message: "TypeScript compilation failed with 12 errors.",
  priority: "high"
})

| 参数 | 说明 | |------|------| | title | 通知标题 | | message | 通知内容 | | priority | normal / high / critical（影响 emoji 前缀） |

/all-notification — 设置面板

↑↓ 导航  Enter 切换/进入子面板  Esc 退出

主面板 toggle 三个渠道开关，进入子面板配置参数。

Bark 配置

| 参数 | 默认值 | 说明 | |------|--------|------| | key | (必填) | Bark 设备 Key | | server | https://api.day.app | Bark 服务器地址 | | authUser / authPass | 无 | Basic Auth（自建 Bark 服务端用） | | sound | calypso | 推送铃声：calypso alarm birdsong chime complete electronic 等 | | group | pi | 通知分组名 | | level | active | iOS 通知级别：active / timeSensitive / passive | | url | 无 | 点击通知跳转的 URL | | isArchive | 1 | 是否存入历史：1 是 / 0 否 |

Webhook 配置

Webhook 支持 GET 和 POST，Body 模板支持变量替换：

| 变量 | 说明 | |------|------| | {{title}} | 通知标题，如 "pi ✅ Complete" | | {{message}} | 通知内容，通常是任务描述 | | {{project}} | 当前项目名 | | {{timestamp}} | ISO 时间戳 |

示例 — Slack Incoming Webhook:

{
  "method": "POST",
  "url": "https://hooks.slack.com/services/xxx",
  "bodyTemplate": "{\"text\": \"{{title}}: {{message}}\"}"
}

示例 — 飞书机器人:

{
  "method": "POST",
  "url": "https://open.feishu.cn/open-apis/bot/v2/hook/xxx",
  "bodyTemplate": "{\"msg_type\":\"text\",\"content\":{\"text\":\"{{title}}\\n{{message}}\"}}"
}

示例 — 钉钉机器人:

{
  "method": "POST",
  "url": "https://oapi.dingtalk.com/robot/send?access_token=xxx",
  "bodyTemplate": "{\"msgtype\":\"text\",\"text\":{\"content\":\"{{title}}\\n{{message}}\"}}"
}

触发时机

| 事件 | 默认 | 说明 | |------|------|------| | agent_end | ✅ | Agent 完成响应，等待输入 | | agent_start | ⬜ | Agent 开始处理 | | tool_error | ⬜ | 工具执行出错 |

配置文件

运行时配置存储在 ~/.pi/agent/extensions/pi-all-notification/config.json。

首次启动自动生成默认配置。仓库中的 config.json 是模板，不含密钥。

License

MIT