SuperAPI AI 工具集

sound-hooks

智能体与模型

查看项目

更新于 10-16 04:57

技能介绍

用途:为 Claude Code 的钩子事件添加 macOS 系统声音,让任务完成、Claude 停止提问等时刻产生音频反馈。

主要能力:macOS 自带声音位于 /System/Library/Sounds/,技能通过内置命令 afplay 在 ~/.claude/settings.json 中添加钩子来播放这些声音。命令末尾的 & 使播放非阻塞,不会拖慢 Claude。可用系统声音包括 Glass、Blow、Ping、Pop、Hero、Funk、Basso、Purr、Tink、Bottle、Frog、Morse、Sosumi、Submarine 等。默认映射:TaskCompleted 使用 Glass,Stop 使用 Blow。可加声音的其他事件包括 Notification、SubagentStop、SessionStart。

使用方式:先读取现有 ~/.claude/settings.json,绝不覆盖已有设置;若 hooks 已存在则合并,若某事件已配置声音需先询问用户再替换。每个声音钩子结构为:"EventName": [{"hooks": [{"type": "command", "command": "afplay /System/Library/Sounds/SoundName.aiff &", "timeout": 5}]}]。写入后用 jq -e '.hooks' ~/.claude/settings.json 校验。之后告知用户事件与声音的对应关系,并说明可能需要打开 /hooks 或重启会话才能生效。自定义时替换文件名即可,例如改用 Hero:"command": "afplay /System/Library/Sounds/Hero.aiff &";也可提供 .aiff、.mp3、.wav 文件的绝对路径使用自定义声音。

限制:仅支持 macOS,afplay 与 /System/Library/Sounds/ 均为 macOS 专有;Linux 需改用 paplay 或 aplay,且声音文件路径完全不同。关于收费、价格、平台支持范围等更多信息暂未提供。