Files
pi-ntfy/DESIGN.md
T
杨豪 c16ae3a11d fix: publish ntfy as JSON so Chinese titles honor titleTemplate
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.
2026-09-18 15:43:26 +08:00

1019 B

pi-ntfy 设计说明

目标

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

事件

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

内容

标题默认包含:

[项目] 状态 · Session

正文默认每项独占一行:

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

通道

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

NTFY 采用 JSON 发布(POST 到 server 根路径):titlemessage 随 UTF-8 JSON body 传输,中文标题/正文不受 HTTP header 只允许 Latin-1 的限制;tags/priority/click/icon/email 同样走 JSON 字段。