45 lines
979 B
Markdown
45 lines
979 B
Markdown
# 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 元数据使用 `Title`、`Tags`、`X-Project`、`X-Session`、`X-Event`、`X-Task` headers。含中文的字段会写入 Base64 版本的 headers，完整中文内容始终保留在正文中。
|