Skip to content

Notifications zh CN

ChrAlpha edited this page Nov 12, 2026 · 2 revisions
🇬🇧English | 🇨🇳中文

通知

@tmag-notify 是可选的本地命令,在 @tmag-alert 启用的 blocked 和 finished 提醒发生时运行,也适用于没有 pane 的 sessions。命令只接收元数据,独立于 agent hook 执行,运行上限为 20 秒。

tmag notify 会发送测试提醒,并保留受大小限制的命令输出,用于前台结果。每个 state directory 最多同时运行四个遵循协作协议的外部通知命令,通过 shell 直接继承的永久本地 lock slots 限制并发;槽位满时直接拒绝,不排队。该限制约束外部命令执行数量,不涵盖所有短暂运行的 detached launchers。

普通子孙进程会保留 slot;主动关闭继承的 FDs 或逃离所管理 process group 的命令不在此保证范围内。20 秒执行上限仍然有效。

变量 含义
TMAG_ALERT blocked、finished 或 test。
TMAG_AGENT, TMAG_SESSION Agent 和 session 身份。
TMAG_STATE, TMAG_KIND 状态及状态类别。
TMAG_REQUEST, TMAG_TOOL Request id 和 tool 名称。
TMAG_CWD, TMAG_TARGET, TMAG_HOST 本地工作目录、pane target 和 host。
TMAG_TITLE, TMAG_MESSAGE 由元数据生成的通用摘要。

如果某个 pane 正在显示该 session,且用户在它所在的 tmux server 中于最近一分钟内输入过,则跳过通知命令;其他情况会执行。没有 pane 的 sessions 总会通知。

这项本地通知策略不改变完整 event stream。投递渠道及客户端专属链接由配置的命令负责。

Clone this wiki locally