FUN SFX
将此文件夹作为技能根目录。在运行命令前先解析其位置；用户的工作目录可能在其他地方。Python 3.10+支持发现功能；音频导出还需要FFmpeg在PATH中。
查找音效
运行 python3 <skill-root>/scripts/sfx.py search "whoosh" --json 获取带有绝对音频路径的候选列表。搜索也接受场景描述，例如 "failed attempt" 或 "photo capture"。它会匹配标题、ID、类别、标签、推荐用途和示例；多个词必须全部匹配。它故意排除负面指导。运行 list --json 查看完整集合，或运行 show <id> 查看完整记录。阅读目录获取人类可读的概览。
每条提供的录音都有单独的使用案例指南：推荐场景、时机、应避免的情况以及示例剪辑。使用记录中的 usage 字段为场景选择音效，而不仅仅是匹配类别。这些是创意推荐，并非强制使用。
标签仍然来源于文件名。检查 audio_review.status：七条录音有自动音频分析注释；另外六十四条只有基于文件名的推荐，未确认实际音频内容。自动注释也可能误听语音；注意 audio_review.uncertainty。没有声称任何录音经过人工试听。在选择之前先试听候选音效，尤其是像Walmart、Whoop或Spotlight这样模糊的名称。文件可能包含语音、音乐、静音、多种音效或突然的音量变化。电影嗖嗖声合集和长恐怖片段需要选取片段。时机指导是相对于视觉动作的，而非已验证的源入/出点。
准备音效片段
python3 <skill-root>/scripts/sfx.py export <id> /absolute/output/cue.wav --start 0.2 --duration 0.8 --gain-db -8 --fade-ms 10
输出为48kHz立体声PCM WAV。--start 是源偏移量；时间线放置是单独的编辑。命令会拒绝已存在的输出文件。保持原始录音完整。使用适度的增益，保持对话清晰度，并对最终混音进行试听；一个音量设置不会适用于所有录音。
使用用户现有的视频编辑器或编辑工具来放置准备好的音效片段。阅读editing.md获取提示字段、时机指导和FFmpeg混音示例。记录选择的ID、源片段、时间线位置和增益，以确保编辑可复现。默认情况下不要在每个剪辑处都添加音效。
版权与完整性
FUN SFX维护者不拥有任何捆绑音效的所有权。所有权利归其各自所有者所有。在展示或打包音效集合时保留此所有权声明。
代码和文档采用MIT许可证。捆绑的录音和提取的音频具有未验证的版权，不包括在该许可证中；请参见ASSET_LICENSE.md。不要将录音描述为MIT、免版税或已清除再分发权限。文件名中包含“no copyright”并非许可证证据。在交付剪辑或打包此技能时保持此区别。
在检查下载或修改后的包时，运行 python3 <skill-root>/scripts/sfx.py verify。catalog.json包含每个原始和可用音频文件的便携路径、技术元数据和SHA-256校验和。