# pi-ntfy 设计说明

## 目标

只通过 NTFY 推送 pi Agent 的状态，并让并行开发时可以区分项目、Session 和任务。

## 事件

- `agent_start`：记录开始时间和当前任务
- `agent_end`：记录最终 assistant 摘要和停止原因
- `agent_settled`：唯一的 idle/interrupted 推送点
- `tool_execution_start`：记录本轮使用过的工具
- `tool_call`：检测需要用户回答的工具
- `session_shutdown`：按配置发送退出通知

## 内容

标题默认包含：

```text
[项目] 状态 · Session
```

正文默认每项独占一行：

```text
项目
会话
任务
状态
原因
摘要
耗时
模型
主机
时间
工具
```

## 通道

本插件只有一个通道：`ntfy`。其他推送通道和对应实现已移除。

NTFY 采用 JSON 发布（POST 到 server 根路径）：`title`、`message` 随 UTF-8 JSON body 传输，中文标题/正文不受 HTTP header 只允许 Latin-1 的限制；`tags`/`priority`/`click`/`icon`/`email` 同样走 JSON 字段。