# 文档总览

## 当前范围

`zed-notify` 只解决一个问题：

- `pi` 在 **Zed Terminal Thread** 中完成一轮后，如何触发 Zed 的完成通知。

## 当前设计

- 钩子：`agent_end`
- 输出：终端 `BEL`（`\x07`）
- 通知承载：Zed Terminal Thread

## 为什么不用别的方案

- 不用 `OSC 9`：Zed 当前不把它作为终端通知主路径
- 不用系统通知：当前目标是复用 Zed 自己的 Terminal Thread 提醒
- 不做跨终端兼容：项目定位就是给 Zed 用

## 已知限制

- 视觉通知主要面向 **thread 不在焦点** 的场景
- 是否显示到所有屏幕、是否播放声音，由 Zed 配置决定，不由扩展控制