OCX notify插件实战：AI需要你的时候，macOS/Windows/Linux原生系统通知立刻到达-开发者社区

CLI
开发工具
AI 应用

【免费下载链接】ocx

OpenCode extension manager with portable, isolated profiles. Your setup, anywhere.

项目地址：https://gitcode.com/gh_mirrors/ocx/ocx

OCX（OpenCode extension manager）的 notify 插件让 AI 编程助手 OpenCode 在任务完成、报错或需要你授权时，立即通过 macOS、Windows、Linux 的原生系统通知提醒你，从此告别盯着终端干等。

解决什么问题：AI 干活时你不用干等

用 AI 编程工具的典型场景：你委派一个任务，切到别的窗口继续工作，然后每隔 30 秒就要切回去看一眼——完成了吗？报错了？在等我授权吗？

notify 插件的设计哲学就一句话："在 AI 需要你回来时通知人类，而不是为每个细碎事件轰炸。"

专注其他工作：AI 需要你时，系统通知立刻弹出
原生系统通知：走操作系统级通知渠道，macOS 通知中心、Windows Toast、Linuxnotify-send
智能默认值：只对有意义的事件发声，支持免打扰时段，不打扰你
零上下文开销：纯事件驱动，不往对话里注入任何工具或提示词

一键安装：30秒搞定

先确保已安装 OCX，然后在项目目录执行：

ocx add kdco/notify --from https://registry.kdco.dev

如果想一次装齐（通知 + 后台代理 + 专业 Agent + 规划工具），可以直接装 Workspace 全家桶：

ocx add kdco/workspace --from https://registry.kdco.dev

不想用 OCX？也可以手动安装：把 workers/kdco-registry/files/plugins/ 下的notify.ts及其子文件（notify/backend.ts、notify/cmux.ts、notify/status.ts、notify/title.ts）和kdco-primitives/目录整体复制到.opencode/plugins/，保持多文件目录结构，并自行安装node-notifier、detect-terminal依赖。不过手动方式更新需要重新复制，不推荐。

哪些事件会通知你？

事件	是否通知	提示音	原因
会话完成	✅ 是	Glass	主任务完成，该来验收了
会话出错	✅ 是	Basso	出了岔子，需要你处理
需要授权	✅ 是	Submarine	AI 被卡住，在等你点头
提问	✅ 是	Submarine	问题必须第一时间送达
子任务完成/出错	❌ 默认否	—	需要时开启`notifyChildSessions`

插件还会自动做三件贴心的事：

自动识别终端：支持 Ghostty、Kitty、iTerm2、WezTerm、Windows Terminal 等 37+ 种终端
焦点抑制：macOS 上如果你的终端正处于前台焦点，自动抑制完成/出错/授权通知，避免当面弹
点击聚焦：macOS 上点击通知直接切回终端窗口

提问类通知会刻意绕过焦点抑制——AI 直接问你问题时，绝不会错过。

三大平台：原生通知路径各不相同

平台	通知渠道	备注
macOS	通知中心（经`alerter`）	需要 macOS 13+ 并安装`alerter`到 PATH
Windows	Toast 通知（`SnoreToast`后端）	开箱即用
Linux	`notify-send`	依赖桌面环境的通知服务

macOS 上需额外安装alerter（Homebrew 用户执行brew install vjeantet/tap/alerter即可，MacPorts 亦可）。如果环境里有 cmux 且设置了CMUX_WORKSPACE_ID，插件会优先走cmux notify通道；失败时自动回落到上述桌面通知路径，不会出现"通知丢失"。

各平台能力对比：

功能	macOS	Windows	Linux
原生系统通知	✅	✅	✅
自定义提示音	✅	❌	❌
焦点检测	✅	❌	❌
点击聚焦终端	✅	❌	❌
终端自动识别	✅	✅	✅

可选配置：声音与免打扰

装完即能用。想定制的话，创建~/.config/opencode/kdco-notify.json：

{ "notifyChildSessions": false, "terminal": "ghostty", "sounds": { "idle": "Glass", "error": "Basso", "permission": "Submarine", "question": "Submarine" }, "quietHours": { "enabled": false, "start": "22:00", "end": "08:00" } }

配置项速览：

notifyChildSessions（默认false）：设为true后，子会话的完成/出错也发通知
terminal：手动指定终端，跳过自动识别
sounds：为完成、出错、授权、提问分别指定 macOS 提示音（可选 Basso、Blow、Bottle、Frog、Funk、Glass、Hero、Morse、Ping、Pop、Purr、Sosumi、Submarine、Tink）
quietHours：免打扰时段，比如 22:00 到 08:00 不推送