
Cursor 扩展 Sound Toggle 上线:任务完成可自定义提示音并一键静音
来源标题:Yabba Dabba Doo, Cursor extension for custom sounds and voice notifications
一款名为 Sound Toggle 的 Cursor 扩展允许用户在任务完成后播放自定义提示音,并可通过状态栏按钮一键静音。该扩展会同步修改 Cursor 自带的完成提示音设置,也支持选择系统音效或任意音频文件。扩展还提供测试播放和供快捷键调用的播放命令。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
任务完成时播放声音,一键即可静音。
状态栏开关(右下角):点击 Sound: ON/OFF 即可切换。它控制的是 Cursor 自带的 agent 完成提示音(cursor.composer.shouldChimeAfterChatFinishes),因此关闭后确实能让 agent 静音。
Choose Done Sound…:浏览系统音效,用方向键逐条试听,按 Enter 保留所选音效。也可以选择任意音频文件。
Test Done Sound:预览当前音效,即使处于静音状态也可以试听。
Play Done Sound (if enabled):即 cursor-sound-toggle.play,可供快捷键、任务或自动化在工作完成时调用。
为 Cursor 自带提示音设置音效
更换音效(通过 Choose Done Sound… 或编辑 cursorSoundToggle.soundFile)时,也会把该音效写入 Cursor 的 cursor.composer.customChimeSoundPath,这样 Cursor 内置的 agent 完成提示音就会播放同一个声音,无需 hook。重置为默认值会清除该设置。不存在的路径会被忽略。内置提示音接受哪些音频格式由 Cursor 决定。下面的 hook 仅在需要语音、按事件区分音效以及过滤器时才需要,而且按事件区分音效和过滤器只有在 replaceNativeChime 开启时才生效。如果你手动设置了 customChimeSoundPath,它会一直保留,直到你再次更改 soundFile。
音效只有在被调用时才会触发。可从以下方式中选择一种:
Cursor agent hooks(推荐):运行 Cursor Sound: Install Cursor Hooks。它会向 ~/.cursor/hooks.json 添加 stop(agent 完成)、subagentStop 和 postToolUseFailure,并添加一个小型辅助脚本 ~/.cursor/cursor-sound-toggle-hook.sh,该脚本读取 Cursor 的 JSON,以区分 completed、error 和 aborted。它会保留你其他的 hook,再次运行时原地升级自己的条目(绝不重复),并且不会改动无法解析的文件。子 agent 和工具失败音效在你于 cursorSoundToggle.events 中列出它们之前保持静音(见下文)。AskQuestion(“需要输入”)完全不会触发任何 Cursor hook,因此无法为它设置音效。或者手动添加基本的 stop hook:
"version": 1, "hooks": { "stop": [ { "command": "open -g 'cursor://idmtr.cursor-sound-toggle/done?event=agent'" }
open -g 是 macOS 的用法,可让 Cursor 保持在后台(安装器在 Linux 上使用 xdg-open,在 Windows 上使用 start,这两者未经测试;Windows 上没有状态检测)。可选查询参数:status 和 duration(秒)。
终端命令:启用 cursorSoundToggle.triggers.terminalCommands。
任务:启用 cursorSoundToggle.triggers.tasks。
快捷键 / 命令:cursor-sound-toggle.play。
二者只能选其一,由 cursorSoundToggle.replaceNativeChime 决定:
开关、暂停和免打扰时段控制当前生效的播放器,状态栏提示会显示当前是哪个音效。关闭该设置会把 ON/OFF 状态交还给 Cursor 的提示音。在 true 模式下,除非安装了 hook,否则不会播放任何声音。终端命令和任务触发器是独立的,始终通过扩展播放。
将 cursorSoundToggle.announceMode 设为 speech 或 both,并填写 cursorSoundToggle.announceText,例如 {workspace} on {branch} is {status} {duration}。它使用操作系统语音(say、Windows 语音、spd-say/espeak)。可用变量:{workspace}、{branch}、{duration}、{event}、{status}。可使用 Test Done Sound 预览。
cursorSoundToggle.events 可按事件覆盖音效、文本或模式。键为 event.status(优先检查)或 event。内置事件:agent(状态为 succeeded、failed、aborted)、subagent(相同状态,配置前保持静音)、tool(工具调用失败,状态为 failed,配置前保持静音,用户取消时不触发)、command 和 task(succeeded、failed 或 finished)。agent 的按事件音效需要开启 replaceNativeChime。你的 hook 可以发送任意 event= 名称,例如用 event=input 表示“需要输入”。
"cursorSoundToggle.events": { "command.failed": { "sound": "/System/Library/Sounds/Basso.aiff
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。