用途
该技能用于让用户实际听到一首曲目的候选版本:在浏览器打开其 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 面板打开,不能在终端播放。所有选择均须用户明确作出。