blucli 是一款专为 Bluesound 和 NAD 网络播放器设计的命令行控制技能，通过封装开源 blucli 工具，为用户提供本地网络环境下的音响设备管理能力。
核心用法
该技能通过 blu 命令行工具实现对播放器的全方位控制。基础工作流始于 blu devices 发现局域网内的可用设备，随后可通过 --device 参数、环境变量 BLU_DEVICE 或配置文件指定目标设备。核心功能涵盖播放控制（play/pause/stop）、音量调节（volume set）、设备分组管理（group status/add/remove）以及 TuneIn 电台搜索与播放。对于自动化脚本，推荐使用 --json 参数获取结构化数据输出。
显著优点
作为纯文档型技能，blucli 具有极高的安全性，本身不包含任何可执行代码，仅提供标准化的 CLI 使用文档。其设计充分考虑了多场景适配性：支持命令行参数、环境变量和配置文件三级设备选择机制，既适合交互式使用也便于脚本集成。JSON 输出格式使得与 Home Assistant 等智能家居平台联动成为可能。功能层面覆盖完整，从基础的播放控制到复杂的群组管理，再到 TuneIn 流媒体服务，满足高端音响用户的日常需求。
潜在缺点或局限性
该技能存在明显的生态限制：仅兼容 BluOS 生态（Bluesound 和 NAD 品牌）的网络播放器，无法应用于 Sonos、AirPlay 等其他音响系统。功能依赖外部二进制文件 blu，需要通过 Go 语言环境安装，对非技术用户存在一定门槛。控制范围局限于本地局域网，不支持远程访问或云端控制。此外，作为轻量级封装，其功能受限于底层 blucli 工具的实现，缺乏图形化界面和可视化反馈。
适合的目标群体
主要面向 Bluesound 或 NAD 音响设备的拥有者，特别是具备命令行使用经验的技术爱好者。智能家居集成开发者可利用其 JSON 输出接口，将高端音响接入自动化工作流。多房间音响系统的管理者可通过分组功能便捷地控制全屋音频。对于追求极简控制方式、希望摆脱官方 App 的用户，该技能提供了高效的替代方案。
使用风险
虽然技能本身安全，但使用时需注意设备误操作风险：在拥有多个播放器的网络环境中，错误指定设备可能导致非预期的音量调整或播放中断，建议始终先执行 blu devices 确认目标。外部依赖方面，blucli 工具的安装需要 Go 环境，且版本更新依赖于上游维护。网络稳定性直接影响控制可靠性，局域网中断将导致完全失效。性能方面，由于是命令行封装，频繁调用可能产生轻微延迟，不适合超低延迟需求的场景。