opencode-notifier：桌面通知插件下载|多平台在终端里跑长任务最磨人的

8次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 opencode-notifier

opencode-notifier 桌面通知插件下载|多平台

在终端里跑长任务最磨人的，不是等，而是不知道什么时候该回来看一眼：权限卡住了、生成跑完了、出错了，你都得隔一会儿切回去瞄一下。这篇讲的 opencode-notifier 桌面通知插件，就是给这种等待加一个提醒：OpenCode 在终端里遇到关键节点时，用桌面弹窗、声音或终端响铃把你叫回来，不用一直守着屏幕刷进度。

opencode-notifier 软件信息表

软件名称	opencode-notifier
软件类型	OpenCode 桌面通知与声音插件
适用平台	macOS、Linux、Windows（含 WSL 场景）
提醒事件	权限请求、任务生成完成、错误、问题工具调用、子代理完成、用户取消
反馈方式	桌面弹窗、声音、终端响铃、Ghostty 通知、按事件执行自定义命令
实现语言	TypeScript，面向 OpenCode 插件机制
分发形式	npm 包 @opencode-notifier，通过 OpenCode 配置文件加载
获取方式	GitHub 仓库页面查看说明与配置方法

opencode-notifier 桌面通知版本选择：先认清 V1 与 V2

结论先行：动手前先确认自己用的是 OpenCode 1 还是 OpenCode 2，配置写法跟着版本走，不要凭感觉抄一份配置就用。这个项目把两个版本的实现放在一起，加载哪一份由客户端版本决定，用户不需要、也不应该手动去挑实现文件。OpenCode 1 走 opencode.json 配置，OpenCode 2 走 plugins 配置并自动加载终端组件。选错配置文件，插件就不会按你想的那样接管提醒。

opencode-notifier 安装步骤

先确认两件事：OpenCode 是 1 还是 2，以及你日常是不是在终端客户端里用它。两者有一个对不上，后面的配置都要返工。
按版本写配置：OpenCode 1 在 opencode.json 里加载该插件，OpenCode 2 在 plugins 配置里加载，V2 的终端组件由客户端自动加载，不用再单独声明一份。
保存配置后重启 OpenCode，让新配置真正生效，改完不重启就测试，等于没改。
主动触发一次提醒事件来验：比如让一次任务走到权限请求或生成完成，看桌面弹窗或声音是否出现，只看“装上了”不算装好。
Linux 用户多验一步：桌面通知后端是否就绪、声音播放工具是否齐全，缺了哪一样，提醒就会悄悄丢一半。

装完先改这四项设置，桌面通知才不扰人

先定子代理完成与用户取消的响动。入口在插件的事件配置里，这两个事件默认保持静默，目的是少打扰。如果你确实想在子代理跑完时也被叫回来，再单独放开；默认全开等于把降噪设计白白扔掉。
Windows 用户把声音文件写成完整路径。入口在声音配置项，Windows 只认 .wav 文件，而且路径必须写全，不能只写 ~/ 这种简写。路径一写错，弹窗可能正常、声音却永远不响，排错时最容易误判成系统静音。
Linux 用户先选定一个可用的声音播放工具。桌面通知依赖系统已有的通知后端，声音则依赖 paplay、aplay、mpv 或 ffplay 之一。装之前先确认本机有哪一个，配置里指向它，别等到任务跑完了才发现本机根本没有播放器。
远程开发把本地提醒和服务器命令分开配。声音和弹窗的配置放在本地计算机，自定义命令及其脚本路径对应服务器文件系统。两边路径混写是最典型的远程翻车：本地配了服务器路径，或服务器配了本地路径，提醒和命令总有一边落空。

opencode-notifier 桌面通知注意事项：五条先说清

opencode run 以及 Desktop、Web 客户端不会加载 OpenCode 2 的终端组件，因此在这些场景下收不到插件的声音、弹窗或终端响铃。这不是配置错误，是适用边界，换客户端才能解决。
OpenCode 2 的 plan_exit 没有对应的计划完成信号，该设置在 V2 里不会生效。不要指望靠它来判断一次计划结束，任务完成的提醒要走生成完成这类已有事件。
Linux 的桌面通知依赖本机已有的通知系统，声音还依赖上面提到的播放工具。任何一环缺失，提醒都会不完整，装完先做一次端到端验证，别等关键任务。
Windows 的声音只支持 .wav，且必须用完整路径。换格式、写相对路径或简写家目录，都会导致声音静默，而弹窗正常会掩盖这个问题。
升级后重新核对 V1、V2 的事件与内置通知行为，不要和 V2 自带通知重复提醒，先跑一次完整事件再日常使用。

opencode-notifier 适用人群与不适用场景

适合三类人：一是在终端里长时间跑 OpenCode、需要离开座位或切到别处干活的开发者；二是经常被权限请求卡住、希望第一时间回来确认的人；三是想按事件触发自定义命令、把提醒接进自己脚本流程的本地或远程用户。他们的共同点是：工作流本身就在终端里，提醒只是把“该回来了”这个信号送出来。

不适合的场景也要讲清：主力是 Desktop、Web 客户端或 opencode run 的用户，装了也收不到提醒；需要跨机器集中推送、统一管理提醒、或依赖非终端客户端收声音和弹窗的用户，仓库说明里没有给出这类能力，选型前要先看源码或另行评估，不要默认它能做到。

opencode-notifier 版本对比表

对比维度	OpenCode 1 实现	OpenCode 2 实现
配置文件	opencode.json	plugins 配置
终端组件加载	按 V1 配置加载插件	客户端自动加载终端组件
多终端与焦点	以 V1 实现与说明为准	支持终端焦点检测、客户端事件认领、多终端提醒分配
事件覆盖	权限、完成、错误、问题工具等常见节点	在上述基础上增加子代理完成、用户取消等事件配置
推荐结论	仍在用 V1 的用户按 V1 配置走	已上 V2 的用户按 plugins 配置走，不要混用