SuperAPI AI 工具集

listen

通用与其它

查看项目

更新于 11-16 12:21

技能介绍

用途

该技能用于让用户实际听到一首曲目的候选版本:在浏览器打开其 Suno take 页面,或在当前会话旁用 iTerm2 分屏面板播放,或直接在终端扬声器中播放 take 及本地音频。播放结束后,由用户决定保留哪个 take,技能只负责提问和记录结果,不替用户选择。

主要能力

  • 解析调用参数,格式为 <album-name> <track> [take N | all] [--browser [<app>] | --iterm2 | --terminal] [--from m:ss] [--stage original|polished|mastered],通过 get_listen_plan 确定要播放的目标及默认方式。
  • 浏览器模式:调用 open_song_page(urls) 打开最多四个 take 链接;可指定浏览器应用名或路径。
  • iTerm2 模式:在会话右侧以紧凑播放器打开各 take,并在下方打开歌词面板;歌词为纯文本,不随音乐滚动。需 macOS、iTerm2 3.6 及以上及 Browser Plugin。
  • 终端模式:用本机播放器播放本地文件或已缓存的 take;未缓存的 take 需先下载并可能消耗额度。
  • 支持从指定时间点开始播放、在已保存文件间按同一片段对比(需 mpv)、播放下一 take、停止、续播及关闭面板。
  • 用户确定保留版本后,更新曲目文件中的评分、Suno 链接与状态,并按需在 Suno 上标记喜欢;清理不再需要的试听缓存。

使用方式

按参数格式调用技能,技能会先确定播放目标与方式(命令参数优先于配置中的默认模式,默认为浏览器)。本地文件始终在终端播放。取不到目标时会提示先用生成命令产出音轨。终端模式若无播放器会提示安装(如 macOS 的 brew install mpv)并回退到浏览器。iTerm2 面板不可用时会自动回退到浏览器并说明原因。

费用说明

  • 浏览器打开歌曲页、iTerm2 紧凑播放器:免费、不限次。
  • 终端播放某 take 的首次:消耗 1 个 Suno 下载额度;同一 take 再次播放因已缓存而免费。
  • 磁盘上已有文件(导入、精修、母带)及片段对比:免费。
  • 最终保留的 take 本身也需要该下载额度,但其后的 WAV 导入免费。

适用场景

需要在生成多个 take 后试听并作出取舍时;希望不离开终端窗口试听时;需要对比本地各阶段文件同一片段时。

限制

iTerm2 模式仅限 macOS 及满足版本与插件要求;终端播放依赖本机播放器;终端模式播放未缓存 take 需要 Suno 服务器与下载额度,下载链接仅一小时内有效,下载调用需间隔约两秒;clip_id 为空的旧分享链接只能在浏览器或 iTerm2 面板打开,不能在终端播放。所有选择均须用户明确作出。