SuperAPI AI 工具集

sound-effects

设计与创作

查看项目

更新于 10-15 21:53

技能介绍

用途:为界面交互时刻生成小型、统一的音效调色板,声音作为反馈而非背景装饰,仅在确认界面需要被感知的变化时使用,例如面板拖拽吸附、操作确认、模式切换或到达边界。

主要能力:先定义三到五个音效角色,每个音效保持简短且比通知更轻。资料给出的角色包括按压/选择(0.50 秒,干涩触感点击,无人声无旋律)、面板拖拽(0.50–0.60 秒,克制的低摩擦机械滑行)、吸附/落定(0.50 秒,柔和磁吸)、边界(0.50 秒,低沉非警报脉冲)、完成(0.50–0.80 秒,小幅上行确认音)。Humane 风格倾向精确、编辑感、复古未来、触感、安静,排除人声、旋律、号角、刺耳警报和明亮游戏 UI 音。

使用方式:生成前需命名时刻及其确认的变化,读取项目 token 集或 DESIGN.md,确认声音是否为可选,并识别减少动态效果与系统声音设置。通过提供方适配器生成,首个适配器为 ElevenLabs,调用 POST /v1/sound-generation,使用 ELEVENLABS_API_KEY。示例命令:python3 scripts/generate_sound.py --provider elevenlabs --name panel-snap --text "A soft magnetic mechanical catch; tactile analogue electronics, warm low mid tone, precise and quiet, no voice, no melody, no alarm" --duration 0.5 --out <resolved-sound-directory>/panel-snap.mp3。输出目录用 artifact_path(palette, "sound-effects") 解析,生成 .design/sound-<palette>/。脚本写出音频及含提示词和参数的 JSON 回执,不含密钥。

适用场景:界面交互音效设计,需在视觉状态变化开始后触发,每个完成手势用一个声音,对快速悬停、拖拽、点击做限流,声音反复出现时提供可见静音控件。

限制:不得生成语音;不得声称音效改善无障碍而未与不同声音使用习惯的人测试;未经用户批准所选提示词和变体数量前,不得消耗额度或调用 API;密钥不得写入 humane.json、提示词、源码或提交的 .env;--loop 仅用于环境音,不用于点击、拖拽或完成提示;效果不得自动播放、不得作为唯一含义、不得阻止静默完成任务。