核心用法
WiiM CLI 是一款面向 WiiM 和 LinkPlay 音频设备的命令行控制工具，使用 Python 3.11+ 开发，可通过 uv 快速安装或免安装运行（uvx）。工具提供三大功能模块：
1. 设备发现：基于 SSDP/UPnP 协议扫描局域网内设备，支持自动单设备识别或指定 IP 地址
2. 播放控制：完整的媒体控制指令，包括播放/暂停/停止、切歌、进度跳转（seek）、随机播放开关
3. 音量与媒体：音量查询与设置、静音切换、直接播放网络音频 URL（MP3/FLAC/M3U 等）、调用设备预设
显著优点
- 零配置体验：单设备环境下自动发现，无需手动输入 IP
- 轻量高效：基于
uv生态，安装迅速，依赖精简 - 协议兼容：支持多种音频格式和流媒体协议
- 开源透明：Python 实现，便于审计和二次开发
潜在局限
- 网络限制：依赖 SSDP/UPnP，跨子网/VLAN 环境下发现功能失效
- 服务边界：无法控制 Spotify、AirPlay 等服务的内容选择，仅能操作已投射到设备的音频流
- 无加密传输：基于本地明文 HTTP/UPnP 通信，无内置 TLS
- Python 版本门槛：强制要求 Python 3.11+
适合人群
智能家居爱好者、本地音乐服务器用户、需要将音频播放集成到脚本或自动化工作流的技术用户。
常规风险
- 局域网内明文通信可能被嗅探
- 无身份验证机制，同一网络内任何主机均可控制设备
- URL 播放功能需确保来源可信，避免 SSRF 类风险