clipboard

你的任务

输入：$ARGUMENTS

将曲目文件中的内容复制到系统剪贴板，以便粘贴到 Suno 或其他工具中。

---

剪贴板技能

将曲目文件中的指定部分直接复制到剪贴板。

步骤 1：检测平台并检查剪贴板工具

运行检测：

if command -v pbcopy >/dev/null 2>&1; then
  echo "macOS"
elif command -v clip.exe >/dev/null 2>&1; then
  # clip.exe is a built-in Windows utility (System32). Reachable both from WSL
  # via interop and from a native-Windows shell such as Git Bash, so this one
  # branch covers both. Verified on a windows-latest runner: Git Bash present,
  # clip.exe resolved at /c/Windows/system32/clip.exe, copy round-tripped.
  echo "Windows/WSL"
elif command -v xclip >/dev/null 2>&1; then
  echo "Linux-xclip"
elif command -v xsel >/dev/null 2>&1; then
  echo "Linux-xsel"
else
  echo "NONE"
fi

如果为 NONE：

Error: No clipboard utility found.

Install instructions:
- macOS: pbcopy (built-in)
- Linux: sudo apt install xclip
- Windows (native) and WSL: clip.exe (built-in)

步骤 2：解析参数

预期格式：<content-type> <album-name> <track-number>

内容类型：

• lyrics - Suno 歌词框
• style - 仅 Suno 风格框
• exclude - Suno 排除风格字段（裸元素，以逗号分隔 — drums, autotune，不要写成 "no drums"）
• streaming-lyrics - 流媒体歌词（供发行商使用）
• all - 所有 Suno 输入（风格 + 排除项 + 歌词）
• suno - 用于通过 Tampermonkey 自动填入 Suno 的 JSON 对象（title、style、exclude_styles、lyrics）

示例：

• /clipboard lyrics sample-album 03
• /clipboard style sample-album 05
• /clipboard streaming-lyrics sample-album 02
• /clipboard all sample-album 01

如果缺少参数：

Usage: /clipboard <content-type> <album-name> <track-number>

Content types: lyrics, style, exclude, streaming-lyrics, all, suno

Example: /clipboard lyrics sample-album 03

步骤 3：通过 MCP 提取内容

调用 format_for_clipboard(album_slug, track_slug, content_type) — 一次调用即可提取并格式化所需内容。

• content_type："lyrics"、"style"、"exclude"、"streaming"、"all" 或 "suno"
• 返回已格式化、可直接复制到剪贴板的内容
• 自动处理曲目解析、章节提取和格式化

如果未找到曲目： MCP 会返回错误，并列出可用曲目。

步骤 6：复制到剪贴板

使用检测到的平台对应的剪贴板命令：

平台	命令
macOS	pbcopy
Windows（原生）/ WSL	clip.exe
Linux（xclip）	xclip -selection clipboard
Linux（xsel）	xsel --clipboard --input

示例（使用 printf '%s' 安全处理歌词中的特殊字符）：

printf '%s' "$content" | pbcopy  # macOS
printf '%s' "$content" | xclip -selection clipboard  # Linux

步骤 7：确认

报告：

✓ Copied to clipboard: {content-type} from track {track-number}
  Album: {album}
  Track: {track-filename}

错误处理

未找到曲目文件：

Error: Track {track-number} not found in album {album}

Available tracks:
- 01-track-name.md
- 02-track-name.md

未找到内容章节：

Error: {content-type} section not found in track {track-number}

The track file may not have this section yet.

缺少配置：

Error: Config not found at ~/.bitwize-music/config.yaml
Run /configure to set up.

---

示例

复制 Suno 歌词

/clipboard lyrics sample-album 03

输出：

✓ Copied to clipboard: lyrics from track 03
  Album: sample-album
  Track: 03-t-day-beach.md

复制风格提示词

/clipboard style sample-album 05

复制流媒体歌词

/clipboard streaming-lyrics sample-album 02

复制所有 Suno 输入

/clipboard all sample-album 01

输出：

✓ Copied to clipboard: all suno inputs from track 01
  Album: sample-album
  Track: 01-intro.md

Contents:
- Style Box
- `Exclude: …` (if the track has Exclude Styles)
- Lyrics Box

复制 Suno 自动填入 JSON

/clipboard suno sample-album 01

输出：

✓ Copied to clipboard: suno auto-fill JSON from track 01
  Album: sample-album
  Track: 01-intro.md

Clipboard contains JSON with: title, style, exclude_styles, lyrics
Paste into Suno with the Tampermonkey auto-fill script (Ctrl+Shift+V).
See tools/userscripts/README.md for setup.

---

实现说明

剪贴板检测：

• 按优先级顺序检查多个工具
• clip.exe 是 Windows 内置工具，因此可用于原生 Windows（通过 Git Bash）和 WSL（通过互操作）
• 如果完全没有 bash，可使用 PowerShell 的 Set-Clipboard 作为等效的原生备用方案（已验证可用）
• Linux 用户可能安装了 xclip 或 xsel

内容提取：

• MCP format_for_clipboard 负责提取和格式化所有章节
• 无需手动解析文件

多个匹配项：

• 如果曲目编号匹配到多个文件（理论上不应发生），使用第一个匹配项
• 如果目录结构看起来有误，则提醒用户