console.log不能替代系统通知，因为它仅在VSCode终端可见，用户切换标签页时无法感知；而系统通知通过macOS Notification Center、Windows Action Center或Linux D-Bus实现跨应用层级的弹窗、声音和交互，node-notifier可封装各平台原生机制并自动降级。
为什么 console.log 不能替代系统通知？
因为终端输出只在 VSCode 终端里可见，用户最小化窗口或切换标签页时根本看不到。真正需要的是操作系统级别的弹窗（macOS 的 Notification Center、Windows 的 Action Center、Linux 的 D-Bus 通知），这类通知会穿透应用层级，带声音、图标和交互按钮。
node-notifier 是最稳妥的选择
它封装了各平台原生通知机制，不依赖 Electron 或浏览器环境，纯 Node.js 进程就能调用。npm 安装后直接 require 即可，无需额外配置。
常见错误现象：Error: spawn notify-send ENOENT（Linux 下缺少 libnotify-bin）、Notification failed: Command failed: osascript -e ...（macOS 系统策略阻止 AppleScript）。
- macOS：确保已启用“允许辅助设备控制”（系统设置 → 隐私与安全性 → 辅助功能）
- Windows：推荐使用
notifu后端（自动 fallback），避免依赖 Windows 10/11 的 UWP 接口 - Linux：运行
sudo apt install libnotify-bin（Ubuntu/Debian）或sudo pacman -S libnotify（Arch）
基础用法示例：
const notifier = require('node-notifier');
notifier.notify({
title: 'Build Complete',
message: 'dist/ bundle generated',
icon: './icon.png', // 可选，路径需为绝对路径或相对当前工作目录
sound: true, // macOS & Windows，Linux 不支持
});
VSCode 调试时通知不触发？检查工作目录和权限
VSCode 的调试器默认以项目根目录为 cwd，但如果你在子目录下启动脚本（比如 src/main.js），而 icon 路径写成 './icon.png'，实际会去找 src/icon.png —— 文件不存在就静默失败。
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 用
path.resolve(__dirname, '../icon.png')替代相对路径 - 调试配置中显式指定
"cwd": "${workspaceFolder}"，避免继承终端当前路径 - Windows 上若用 PowerShell 启动调试，确认未启用“仅允许签名脚本”策略（
Get-ExecutionPolicy返回RemoteSigned或更低）
不想装第三方包？试试 os 模块 + 原生命令
极简场景下可绕过依赖，直接调用系统命令，但必须手动处理平台差异和错误捕获。
示例（仅限开发机验证，生产环境慎用）：
const { exec } = require('child_process');
const os = require('os');
if (os.platform() === 'darwin') {
exec(`osascript -e 'display notification "Done" with title "Task"'`);
} else if (os.platform() === 'win32') {
exec('powershell -Command "[System.Windows.Forms.MessageBox]::Show(\'Done\', \'Task\')"');
} else {
exec('notify-send "Task" "Done"');
}
问题明显：Windows 的 MessageBox 会阻塞进程；Linux 的 notify-send 在无桌面会话时直接报错；所有路径、空格、特殊字符都要手动转义。
真正要稳定跑在 CI/CD 或远程服务器上，还是得回到 node-notifier —— 它内部做了平台探测、fallback 和错误降级（比如退化为 console.log）。
容易被忽略的点：通知内容长度限制（Windows 最多 256 字符，macOS 标题 100 字以内），以及图标尺寸建议为 1024×1024 PNG —— 小图在高分屏上会模糊。
