杨豪
c16ae3a11d
Non-ASCII rendered titles were silently replaced by a hardcoded ASCII fallback (fetch headers are Latin-1 only), making titleTemplate appear to not work. JSON publishing carries title/message as UTF-8 body.
45 lines
1019 B
Markdown
45 lines
1019 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 采用 JSON 发布（POST 到 server 根路径）：`title`、`message` 随 UTF-8 JSON body 传输，中文标题/正文不受 HTTP header 只允许 Latin-1 的限制；`tags`/`priority`/`click`/`icon`/`email` 同样走 JSON 字段。
|