SuperAPI AI 工具集

listening-to-music

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:Claude 本身听不到声音,该技能通过“渲染→观察→测量→只改一处→重新渲染”的循环,让模型用真实音频引擎生成声音并量化评估,从而判断音乐版本是否真的变好。

主要能力:渲染 Strudel 代码或任意 Web Audio 页面为 WAV,输出峰值电平并标记削波;生成 CQT 频谱图(含 pYIN 主旋律线与 chroma);测量不协和音程重叠、Sethares 粗糙度、与参考图的音高/旋律/泛音/chroma 一致性;乐谱方向支持事件 JSON 雕刻成谱、和声分析(和弦名、罗马数字、摩擦标记)、单声部转写与音符比对,以及乐谱转 Strudel 代码。

使用方式:脚本位于 scripts/,用 --help 或 docstring 查看选项。渲染示例:node $S/render_strudel.mjs loop.js --out v1.wav --seconds 40 --warmup 4;录制页面:node $S/record_page.mjs page.html --click "#power" --out v1.wav --seconds 40 --warmup 8。频谱图:python3 $S/spectrogram.py v1.wav --out v1.png --from-onset --pyin-floor G3 --label v1。依赖 Node+playwright+Chromium,Python 的 librosa soundfile scipy matplotlib pillow,乐谱需 music21 verovio mir_eval cairosvg(pip install --break-system-packages librosa music21 verovio mir_eval cairosvg)。

适用场景:迭代式音乐生成调优、和声摩擦排查、参考图比对、乐谱与代码互转。

限制:转写仅支持单声部,和弦与内声部需读生成代码事件或乐谱;粗糙度是粗粒度指标,可能被低音持续音掩盖变化;OMR 结果不可直接信任;需固定随机种子并每版本录两次以区分真实变化与噪声。