SuperAPI AI 工具集

audio-loop

前端与建站

查看项目

更新于 10-15 20:28

技能介绍

用途:把已经能连续衔接的音频源处理成适合 Web Audio 循环播放的 FLAC,并给出可直接粘贴的播放代码。它不修复源文件在循环边界处的采样级不连续,使用前应先检查接缝。

主要能力:校验 ffmpeg/ffprobe 是否可用;探测时长、采样率、声道数与各声道 RMS;对立体声源按 1 dB RMS 阈值自动做声像平衡(可用 -B 关闭);用 loudnorm=I=<目标>:TP=-2:LRA=7 归一化响度,再按源采样率重采样、限定帧大小并编码 FLAC(-c:a flac -compression_level 8)。脚本输出 RESULT: key=value 行,技能据此生成报告与 JS 片段。

参数:-t <LUFS> 默认 -28;-v <0..1> 默认 0.6,仅由技能写入 JS 的 TARGET;-o <dir> 输出目录;-s 保存到 ~/.agents/output/{project}/audio-loop/{slug}/;-S 强制不保存;-B 关闭立体声平衡。

用法:bash "$SKILL_DIR"/scripts/audio-loop.sh <input> [flags]。缺少 ffmpeg 时停止并请用户自行安装(macOS: brew install ffmpeg,Debian/Ubuntu: sudo apt install ffmpeg),不自动安装。

限制:不提供交叉淡化;不重新编码已编码输出,应从原始 WAV 或无损源开始;FLAC 是唯一编码输出;单声道源跳过平衡步骤;输出路径会覆盖输入时报错,需用 -o 指定别处。浏览器自动播放受用户手势限制,代码片段通过一次性 pointerdown 与过滤后的 keydown 解锁,mousemove、scroll、wheel、pointermove 不算手势,刷新后需重新解锁。是否无缝需在目标浏览器中实际试听验证。