# 上游来源

- 项目：`@smoose/pi-notify`
- 仓库：<https://github.com/smoosex/pi-notify>
- 导入 npm 版本：`0.1.1`
- 导入 commit：`3a3691ab690b4bc37a4412ab0dcbd35ef14adcbf`
- Commit 日期：2026-06-02
- 导入前已对比 npm tarball 与仓库源码。

源码由本仓库直接维护。它不是 submodule，也不保留内嵌 `.git` 目录或上游构建产物。

## 本地改动

- 在 `agent_settled` 而非 `agent_end` 时通知，在重试期间保留已用时长和最新消息。
- 将终端输出限制在 TUI 模式，使 OSC 序列不会破坏 RPC、JSON 或 print 输出。
- 为每个 Pi Session 提供稳定的唯一 OSC 99 通知 ID。
- 将 Kitty 点击聚焦改为显式设置，并把可见性默认值设为 `always`，同时保留 `unfocused` 与 `invisible` 作为可选策略。
- 新增时长过滤、启用/隐私/动作设置、状态模板字段和 `/notify` 控制。
- 保留 Base64 Kitty payload，加固 OSC 元数据/回退净化，并忽略分离进程的 spawn 错误。
- 新增生命周期、多窗口元数据、回退、解析器和配置测试。
- 持久配置由 `PI_NOTIFY_*` 环境变量改为组合包 `config/pi-notify.json`（`src/settings.ts` 读取并逐字段回退默认值）。

上游声明本项目使用 MIT 许可证，但在导入的 commit 和 npm tarball 中都没有包含 `LICENSE` 文件。本目录使用上游作者的 GitHub 身份和 commit 年份补充标准 MIT 文本，使声明的许可证随维护源码一起保留。