본문으로 건너뛰기

Songsee

通过 CLI 生成音频频谱图/特征(mel、chroma、MFCC)。

技能元数据

来源内置(默认安装)
路径skills/media/songsee
版本1.0.0
作者社区
许可证MIT
平台linux、macos、windows
标签AudioVisualizationSpectrogramMusicAnalysis

参考:完整 SKILL.md

정보

以下是该技能被触发时 Hermes 加载的完整技能定义。这是 Agent 在技能激活时看到的指令。

songsee

从音频文件生成频谱图和多面板音频特征可视化图。

前置条件

需要安装 Go

go install github.com/steipete/songsee/cmd/songsee@latest

可选:ffmpeg,用于处理 WAV/MP3 以外的格式。

快速开始

# 基础频谱图
songsee track.mp3

# 保存到指定文件
songsee track.mp3 -o spectrogram.png

# 多面板可视化网格
songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux

# 时间切片(从 12.5 秒开始,持续 8 秒)
songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg

# 从标准输入读取
cat track.mp3 | songsee - --format png -o out.png

可视化类型

使用 --viz 参数,以逗号分隔:

类型描述
spectrogram标准频率频谱图
melMel 刻度频谱图
chroma音级分布
hpss谐波/打击乐分离
selfsim自相似矩阵
loudness随时间变化的响度
tempogram速度估计
mfcc梅尔频率倒谱系数
flux频谱通量(起音检测)

多个 --viz 类型会在单张图片中渲染为网格。

常用标志

标志描述
--viz可视化类型(逗号分隔)
--style调色板:classicmagmainfernoviridisgray
--width / --height输出图像尺寸
--window / --hopFFT 窗口和跳跃大小
--min-freq / --max-freq频率范围过滤
--start / --duration音频的时间切片
--format输出格式:jpgpng
-o输出文件路径

备注

  • WAV 和 MP3 原生解码;其他格式需要 ffmpeg
  • 输出图片可通过 vision_analyze 检查,用于自动化音频分析
  • 适用于比较音频输出、调试合成或记录音频处理管道