跳转到内容
展示 生态 源码解读 文档

Opencode Notify

Opencode Notify

Opencode Notify 在 OpenCode 任务完成、发生错误或 AI 需要你的输入时发送原生操作系统通知。让你专注于其他工作，在 AI 完成任务或需要关注时收到提醒。

核心特性

特性说明
保持专注在其他应用中工作，AI 需要你时收到通知
原生系统通知macOS 通知中心、Windows Toast、Linux notify-send
智能默认值仅在有意义的事件时通知，支持免打扰时段
终端焦点检测终端处于活动状态时抑制通知（macOS）
点击聚焦点击通知将终端置于前台（macOS）
支持 37+ 终端Ghostty、Kitty、iTerm2、WezTerm、Alacritty、VS Code 等

通知事件

事件是否通知声音原因
会话完成是Glass主任务完成
会话错误是Basso出现错误
需要权限是SubmarineAI 被阻塞
提问是Submarine直接提示及时传达给你
子任务完成/错误否（默认）—通过 notifyChildSessions: true 启用

平台支持

特性macOSWindowsLinux
原生系统通知是是是
自定义声音是否否
焦点检测是否否
点击聚焦是否否
终端检测是是是

安装

通过 KDCO 注册表安装（推荐）

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

或安装完整的工作区套件：

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

手动安装

将插件文件复制到 .opencode/plugins/ 目录，保留多文件布局。需要 node-notifier 和 detect-terminal 依赖。

配置

配置文件：~/.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"
  }
}

配置选项

键默认值说明
notifyChildSessionsfalse包含子会话/次会话通知
terminal自动检测覆盖终端自动检测
sounds按事件默认值按事件设置声音（idle、error、permission、question）
quietHours已禁用定时免打扰窗口

可用的 macOS 声音：Basso、Blow、Bottle、Frog、Funk、Glass、Hero、Morse、Ping、Pop、Purr、Sosumi、Submarine、Tink。

链接