console.log不行是因为它只输出到终端，而系统通知需第三方模块如node-notifier来桥接操作系统API；其封装各平台机制，统一API，但需注意权限、环境路径及图标绝对路径等配置。
为什么 console.log 不行，而系统通知需要额外模块
VSCode 的集成终端或 Node.js 脚本本身不提供访问 macOS 通知中心、Windows Toast 或 Linux D-Bus 通知的原生 API。直接调用 alert() 或 console.log() 只会输出到终端或调试面板，不会触发系统级弹窗。必须借助能桥接 Node 进程与操作系统通知服务的第三方模块。
推荐方案：用 node-notifier 发送跨平台通知
它封装了各平台底层机制（osascript on macOS, PowerShell on Windows, notify-send on Linux），API 统一，无需手动判断系统类型。
- 安装：
npm install node-notifier（项目本地安装即可，无需全局） - 基础用法：
const notifier = require('node-notifier'); notifier.notify({ title: '构建完成', message: 'dist/ 目录已更新', sound: true, // macOS / Windows 10+ 支持，Linux 通常忽略 wait: false // 设为 true 可等待用户点击后才继续执行（适合 CLI 工具） }); - 注意
wait: true在非交互式环境（如 CI 或后台任务）中会导致进程挂起，慎用 - 图标路径必须是绝对路径；相对路径易失效，建议用
require('path').join(__dirname, 'icon.png')
常见失败原因和绕过方式
报错 Error: Command failed: osascript -e ... 或静默无响应，多数不是代码问题，而是权限或环境限制：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- macOS 上首次运行可能被“安全性与隐私”拦截——需手动在「系统设置 → 隐私与安全性 → 完全磁盘访问」中添加
Terminal或Visual Studio Code - VSCode 的集成终端若以非登录 Shell 启动（比如通过
code --new-window打开），可能缺失PATH，导致找不到osascript或notify-send；可尝试在 VSCode 设置中启用terminal.integrated.inheritEnv - Windows 下 PowerShell 执行策略可能阻止脚本运行，临时放宽策略：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（仅当前用户，重启终端生效） - Linux 用户需确认已安装
libnotify-bin（Ubuntu/Debian）或notification-daemon（某些精简桌面）
替代轻量方案：只用系统命令行工具（不依赖 Node 模块）
如果项目不允许引入新依赖，且只需简单提示，可直接 child_process.exec 调用原生命令：
- macOS：
osascript -e 'display notification "消息" with title "标题"' - Windows：
powershell -Command "& {[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('消息', '标题')}"（注意：这是 MessageBox，非 Toast；真 Toast 需更复杂 PowerShell 脚本） - Linux：
notify-send "标题" "消息"（需提前sudo apt install libnotify-bin） - 关键点：所有命令都应加错误回调，否则失败时完全无感知；
exec默认超时 60 秒，长时间阻塞需设{ timeout: 5000 }
系统通知看似简单，但跨平台一致性和首次权限授权最容易卡住——别急着改代码，先看系统设置里有没有拦住它。
