sound — 从 Freesound 为画面挑选真实音效的 Claude Code Skill

sound 是一个用于视频音效选材的 Claude Code Skill，仓库托管在 GitHub，本身不生成声音，而是让 Agent 到 Freesound 这个真实音效素材站点检索、筛选并下载音效。它把转场、卡片入场、按钮点击、纸张滑动、碰撞等画面动作变成检索线索，结合上传者描述、时长、下载量、评分人数与许可证给出候选，再由 Agent 取回文件。在 AI工具分类下，它属于把素材查找流程交给编码 Agent 的 AI应用；脚本只使用 Python 标准库，没有额外第三方依赖。

场景痛点

做产品演示、短视频或界面动效的人，都遇到过配音效这一步：画面剪好了，按钮配什么点击声、卡片飞入要多长的 whoosh，得自己去素材站逐个试听，回来再核对许可证和署名。关键词翻不对、时长卡不准，声音要么偏长要么偏吵，临到合成才发现素材不能直接用。这个内容创作环节的缺口，也是数字生活常用素材工具要解决的事，属于软件工具类技能补上的位置。

主要功能特点

画面动作先转成英文关键词搜候选

第一步由 Agent 把中文画面描述转成英文检索词，再到 Freesound 搜候选音效：卡片飞入对应短 whoosh，开关切换对应柔和点击，纸张滑动对应 paper slide，碰撞对应 impact。检索词按动作气质拟定，先带回一批候选条目，不直接定某一条。这一步把选材意图翻译成素材站能识别的音频处理入口，后续筛选都在此基础上进行。

先看来源描述与时长，下载量评分只作线索

第二步先判断声音来源、上传者描述和时长是否贴合画面，再参考下载量与评分人数，并说明推荐依据。下载量和评分只是选材线索，不代表声音一定适合这段画面，Agent 不能把这些信号当作试听结论；需要人工确认时条目带试听链接。规则写在 SKILL.md 里，避免单凭热门程度决定，也让工具推荐方向上的选材更稳妥。

按许可证筛选，非 CC0 输出署名提示

第三步按需求筛许可证：cc0 只选 CC0，by 检索 CC0 与署名的 Attribution，any 不过滤、为默认值。默认 any 也可能返回 BY-NC 等其他条目，用前逐条核对要求。非 CC0 下载时脚本输出作者署名提示；交付时仍要保留来源与许可证，按条目补全署名。音效版权归上传者，Skill 不托管素材。

脚本可独立运行，搜索参数直接可调

除了在 Claude Code 会话里描述需求，sfx.py 也能终端单独运行：可指定许可证与是否显示试听链接，控制返回条数（默认 8），按相关度、下载量、评分或时长排序，并设置起始页数与页码。命令行方式便于在脚本或工作流里复用检索结果，属于效率工具式的轻量取用。

先搜出缓存结果，再按 fs:ID 批量下载

下载依赖本地缓存：搜索结果存到 ~/.cache/sfx-sources/index.json，须先搜出条目，再用返回的 fs:ID 下载，get 命令一次传多个 ID、脚本并发处理。当前下载的是 MP3 预览文件，不是上传者原始音频，原始音质需另按站点规则处理。缓存让这份来自 GitHub 的轻量脚本不必反复拉列表，同一批候选可多次取回。

时长能量分析配合 FFmpeg，Skill 不做剪辑

Skill 的工作范围停在音效搜索、筛选与下载，本身不做剪辑，也不内置能量分析；时长与能量分布检查要配合 FFmpeg 完成。选中音效后，必要时用 FFmpeg 量时长、看能量分布，再决定是否裁剪或换一条。它是选材与取件环节的 Skill工具，不是剪辑工作站；后续对齐、裁剪与混音仍在剪辑工程里完成。

环境前提、文件结构与授权边界

安装前需有 Claude Code、Python 3 和能访问 Freesound 的网络。SKILL.md 定入口规则，sfx.py 管下载，另两份为作者网络环境辅助脚本；仓库未附开源许可证文件，复用前先向作者确认授权。它是自备环境的实用软件脚本集合，也是技术探索的 Agent 工作流样本，属酷软趣站场景小工具。

项目地址

GitHub 访问

下载地址

https://pan.quark.cn/s/10d1d398e638

https://www.guangyapan.com/s/1967615144139472931_aeWhI5wocgzRgCO6 （光鸭新用户注册福利：永久免费空间：所有新用户注册即可解锁 2TB 永久免费存储空间，无需额外任务或付费）

sound — 从 Freesound 为画面挑选真实音效的 Claude Code Skill

场景痛点