console.beep() 在 VSCode 终端不响，因其是浏览器 API，Node.js 中不存在；真正触发系统提示音需用 ASCII 响铃字符 \x07 或 echo -e "\a"，但现代终端常默认禁用该功能，且需系统级音效设置配合。
为什么 console.beep() 在 VSCode 终端里不响
VSCode 内置终端（无论是 PowerShell、CMD 还是 bash）默认不支持 console.beep()，它在 Node.js 环境中根本不存在——这是浏览器 API，不是 Node 标准模块。直接写 console.beep() 会报 TypeError: console.beep is not a function。
真正能触发系统提示音的，是操作系统级的“bell”信号（ASCII \x07），但现代终端常默认禁用或静音该行为。即使你写 process.stdout.write('\x07')，也大概率没声音。
- Windows Terminal / VSCode 默认关闭了「终端响铃」设置（需手动开启）
- macOS 终端需在系统偏好 → 声音 → 「播放用户界面音效」开启，且终端要启用「视觉警报」或「声音警报」
- Linux 多数桌面环境已弃用传统 bell，
echo -e "\a"可能只闪屏不发声
用 play-sound 直接调用本地音频硬件
最可靠的方式是绕过终端，让 Node.js 进程直接调用系统音频播放命令或二进制工具。推荐轻量库 play-sound，它不依赖 Electron 或 GUI，纯 CLI 驱动：
npm install play-sound
它会根据平台自动选择播放器：afplay（macOS）、aplay 或 cvlc（Linux）、powerShell 的 Play-Beep 或 Start-Process（Windows）。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 必须提供真实音频文件路径（如
./alert.wav），不能只传 URL 或 base64 - WAV 最兼容；MP3 在某些 Linux 环境需额外安装
mpg123，否则报错Error: spawn mpg123 ENOENT - 若想合成简单蜂鸣音（非文件），可用
speaker-test -l 1 -s 1 -t wav -f 800（Linux）或say "beep"（macOS），但跨平台性差
示例代码：
const play = require('play-sound')({});<br>play.play('./alert.wav', (err) => {<br> if (err) console.error('播放失败:', err);<br>});Windows 下用 node-speaker 播放合成波形（无文件依赖）
如果不想管理音频文件，且只面向 Windows 开发者，node-speaker 是更底层的选择：它把 PCM 数据直接喂给 Windows Core Audio API。但它要求 Node 版本 ≤18（Node 20+ 因 ABI 变更暂不兼容），且需 Python 和 Visual Studio Build Tools 编译原生模块。
- 安装前先确认：
node -v输出是否 ≤18.x；运行npm config set msvs_version 2022（或对应 VS 版本） - 合成 800Hz、200ms 方波示例（注意采样率必须为 44100，
speaker不接受其他值）：
const Speaker = require('speaker');<br>const fs = require('fs');<br><br>// 生成 200ms 800Hz 方波（16-bit signed PCM）<br>const sampleRate = 44100;<br>const durationMs = 200;<br>const samples = Math.floor((durationMs / 1000) * sampleRate);<br>const buffer = Buffer.alloc(samples * 2); // 16-bit = 2 bytes per sample<br><br>for (let i = 0; i < samples; i++) {<br> const t = i / sampleRate;<br> const value = Math.sin(2 * Math.PI * 800 * t) > 0 ? 32767 : -32768;<br> buffer.writeInt16LE(value, i * 2);<br>}<br><br>const speaker = new Speaker({<br> channels: 1,<br> bitDepth: 16,<br> sampleRate: sampleRate<br>});<br>speaker.write(buffer);VSCode 调试时音频被静音的常见原因
即使代码能跑通，在 VSCode 的调试控制台（Debug Console）中仍可能无声——因为 Debug Console 本质是调试协议通道，不继承终端的音频权限，也不执行 shell 环境变量（比如 ALSA_PCM_CARD 或 DISPLAY）。
- 务必在「集成终端」（Terminal → New Terminal）中运行脚本，而非 Debug Console
- 检查 VSCode 设置里有没有启用
terminal.integrated.enableBell（仅影响 \x07，不影响play-sound） - WSL 用户注意：默认没有音频设备映射，需手动配置 PulseAudio 或使用 Windows 原生 Node（非 WSL）
真正需要“警告音”的场景，往往意味着你在监听某个异步事件（如文件变化、HTTP 响应超时）。这时候别把播放逻辑塞进回调深处——先确保音频路径可读、权限正常、播放器存在，再谈触发时机。
