name: winamp
description: 在 Windows（原生或 WSL2）或 Linux（通过 Wine）上控制 Winamp 媒体播放器。
metadata:
moltbot:
requires:
bins: ["winamp.exe"]

Winamp 命令行控制

使用此技能来控制 Winamp 媒体播放器。

可执行文件路径

根据您的运行环境，Winamp 可执行文件的路径有所不同：
- Windows（原生环境）： C:\Program Files (x86)\Winamp\winamp.exe
- WSL2（Windows 主机）： /mnt/c/Program Files (x86)/Winamp/winamp.exe
- Linux（通过 Wine）： wine "C:\Program Files (x86)\Winamp\winamp.exe"

常用命令

播放控制

• 播放： winamp.exe /PLAY
• 暂停/继续： winamp.exe /PAUSE
• 停止： winamp.exe /STOP
• 下一曲： winamp.exe /NEXT
• 上一曲： winamp.exe /PREV

管理播放列表

• 播放文件（清空队列）： winamp.exe "C:\path\to\file.mp3"
• 将文件/文件夹加入队列： winamp.exe /ADD "C:\path\to\file.mp3"
• 播放播放列表： winamp.exe "C:\path\to\playlist.m3u"

高级选项

• 新建实例： winamp.exe /NEW （强制打开新窗口）
• 指定实例： winamp.exe /CLASS="MyClassName" （定位到特定窗口）
• 配置目录： winamp.exe /INIDIR="C:\path\to\dir" （使用特定设置）

执行说明（后台运行）

由于 Winamp 是图形界面应用程序，请始终在后台运行它，以避免会话挂起。命令将在发送后立即执行。

Moltbot exec 工具用法：

在工具调用中设置 background: true。

{
  "tool": "exec",
  "command": "\"/mnt/c/Program Files (x86)/Winamp/winamp.exe\" \"C:\\path\\to\\file.mp3\"",
  "background": true
}

命令行用法：

在命令后追加 & 符号。

"/mnt/c/Program Files (x86)/Winamp/winamp.exe" /PLAY &