技能使用指南

blucli（蓝牙播放器命令行控制）Skill 是什么？怎么用？

blucli 是一个 BluOS 命令行技能，用 blu 命令即可发现设备、控制播放暂停、精确设定音量、管理多房间分组并搜索播放 TuneIn 电台，还支持 --json 结构化输出，方便接入脚本与 AI 助手自动化流程。本文详解安装步骤、常用命令、竞品对比与典型场景，帮你十分钟上手命令行控制音响。

蓝牙播放器控制命令行技能Skillblucli
8 个章节 约 14 分钟阅读 AI 智能生成

blucli：一条命令掌控 BluOS 播放器，让音响控制变成可脚本化能力

核心结论速览

  • 它是什么：blucli（命令行程序名为 blu）是 BluOS 的命令行界面工具，用于发现、播放、分组和音量控制，可操作 Bluesound / NAD 播放器。
  • 它能解决什么：把原本需要在图形 App 里点来点去的播放控制，变成一条可在终端、脚本、自动化流程里复用的命令。
  • 最常用的四条命令：blu devices 找设备、blu --device <id> status 看状态、blu play|pause|stop 控制播放、blu volume set 15 调音量。
  • 安装方式很轻：官方提供的安装方式是 Go 模块安装，执行一条 go install 即可获得单一二进制文件 blu。
  • 适合谁：喜欢用终端和脚本打理家庭音响的开发者、智能家居玩家，以及希望让 AI 助手直接控制音响的效率工具用户。

该技能叫什么？如何下载安装 AI 技能提升开发效率？

这个技能的中文名是蓝牙播放器控制命令行技能Skill，英文名是 blucli，技能 ID 为 13601。它的命令行可执行文件名为 blu，官方主页为 https://blucli.sh。

它要解决的问题很具体：Bluesound、NAD 这类基于 BluOS 的播放器，日常操作基本依赖官方图形 App。一旦你想做「播放前先查状态」「按脚本批量调音量」「把几个房间的播放器临时合成一组」这类操作，图形界面就会变成瓶颈——没有接口、没有返回值、无法嵌入自动化流程。blucli 把这些能力收敛成一组语义清晰的命令，并在需要时用 --json 输出结构化结果，让播放器成为一个可被程序调用的对象。

安装前提

  • 需要一个可用的 Go 工具链（因为官方给出的安装方式是 Go 模块安装）。
  • 安装完成后，需要确保生成的可执行文件 blu 位于系统的 PATH 中，否则命令无法直接调用。
  • 需要与目标播放器处于可互相访问的网络环境中，并能被设备发现（以官方说明为准）。

安装步骤

  1. 准备 Go 环境（版本要求以官方说明为准）。
  2. 执行官方提供的安装命令：
go install github.com/steipete/blucli/cmd/blu@latest
  1. 确认 Go 的二进制输出目录（通常是 $GOPATH/bin 或 $HOME/go/bin）已加入 PATH。
  2. 验证是否生效：
blu devices

如果能看到设备列表，说明安装成功、且能发现局域网内的播放器。也可以进一步执行 blu --device <id> status 确认目标设备可正常通信。

关于「一键安装 AI 技能」

如果你是通过 AI 技能市场或技能管理器使用该技能，通常的做法是按技能条目中的安装说明完成安装（本技能所需的二进制文件为 blu），安装入口与具体交互以官方说明为准。安装完成后，在对话中让 AI 助手调用该技能时，它会基于同一套 blu 命令完成设备发现与控制——你不需要手写命令，但仍建议先自行执行一次 blu devices 确认设备可见，避免后续因网络或权限问题排查困难。

该技能的主要功能和特点

  • 设备发现：blu devices 列出可控制的播放器，是所有后续操作的第一步，也是判断环境是否就绪的最快方式。
  • 播放控制：支持 play、pause、stop 三类基础动作，覆盖日常最常用的播放状态切换。
  • 精确音量设置：blu volume set 15 采用「设定具体数值」的方式，而不是相对增减，便于在脚本中复现同一音量水平。
  • 多设备分组：通过 blu group status|add|remove 查询分组状态、添加成员、移除成员，用于多房间同步播放场景。
  • TuneIn 电台检索与播放：blu tunein search "query" 搜索、blu tunein play "query" 直接播放，省去在 App 里逐层点选。
  • 灵活的目标选择机制：支持按优先级从三处确定目标设备——命令行参数 --device <id|name|alias>、环境变量 BLU_DEVICE、以及已设置好的默认配置。这意味着你可以为常用设备写一次环境变量，之后命令无需重复指定。
  • 面向脚本的 JSON 输出：官方明确建议在脚本场景使用 --json，方便被 jq 等工具解析，或直接喂给上层程序。
  • 与图形工具相比的差异点：普通播放器 App 是「给人看的」，blucli 是「给流程用的」——它能返回值、能被组合、能进版本管理的脚本文件，这是图形界面天然做不到的。

如何使用该技能？

下面按从「找到设备」到「完成一次完整操作」的顺序给出步骤。

步骤 1：发现设备

blu devices

输出设备列表后，记下你关心的设备标识（id、名称或别名）。

步骤 2：明确目标设备

三种方式任选其一，优先级从高到低：

blu --device <id> status      # 方式一：命令行显式指定
export BLU_DEVICE=<id>        # 方式二：环境变量

第三种是使用已设置的默认配置（若已配置）。官方特别提示：在更改播放状态之前，先确认目标设备，避免在多设备环境下误操作。

步骤 3：查询当前状态

blu --device <id> status

用于确认播放/暂停状态、当前音量等信息，是「改之前先看」的安全动作。

步骤 4：控制播放

blu play
blu pause
blu stop

步骤 5：设定音量

blu volume set 15

注意这是「设为 15」而非「加 15」，因此适合写进脚本反复执行。

步骤 6：管理多设备分组

blu group status
blu group add
blu group remove

先用 group status 看清现有分组关系，再做增删，可以避免把不该合并的房间合并到一起。

步骤 7：TuneIn 电台搜索与播放

blu tunein search "jazz"
blu tunein play "jazz"

先搜索确认结果，再执行播放，是更稳妥的顺序。

步骤 8：在脚本中获取结构化输出

blu --device <id> --json status

拿到 JSON 后可直接交给 jq 或其他程序解析，用于条件判断、日志记录或上报。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
blucli（blu） 面向 BluOS 播放器的命令行控制工具 设备发现、播放/暂停/停止、音量设定、分组、TuneIn 搜索播放、JSON 输出 需 Go 工具链安装，单二进制；命令语义简单 终端操作、脚本自动化、AI 助手调用 优势：可脚本化、有结构化输出、命令少易记；不足：只覆盖详情中列出的能力范围，复杂功能仍需回到官方 App
BluOS 官方图形 App 厂商提供的通用控制端 播放控制、音源切换、分组等可视化操作 无需安装命令行环境，手机/桌面直接使用 家庭日常手动操作、首次配置 优势：功能全、可视化友好、无需技术背景；不足：难以嵌入脚本与自动化流程，无法批量复用操作
Home Assistant 类智能家居平台 统一管理多品牌设备的家庭自动化中枢 场景联动、定时、跨品牌统一控制 需要部署平台并完成设备接入与配置 全屋自动化、多品牌混合环境 优势：联动能力强、可视化编排；不足：前期配置成本高，单纯控制一台播放器属于「杀鸡用牛刀」
自行编写接口调用脚本 针对播放器网络控制接口的 DIY 方案 取决于自行实现的接口调用范围 需要自行阅读接口文档、处理认证与解析 有特殊定制需求、愿意投入开发成本的团队 优势：完全自由、可按需裁剪；不足：开发与维护成本高，缺少统一命令语义与一致输出格式

从对比可以看出，blucli 的差异化位置很清晰：它不是要取代图形 App，而是填补「可脚本化控制」这一空白。对于只需要偶尔点播的用户，官方 App 更省事；对于要把音响接进自动化流程的用户，命令行才是正确入口。

该技能的典型应用场景与实际体验情况

场景一：多房间临时同步播放

角色：智能家居爱好者。痛点是客厅与书房的播放器想临时同步，但每次在 App 里选设备、勾选分组、再取消，操作链路太长。做法是 blu group status 确认现状，blu group add 合并，结束后 blu group remove 还原。实际体验上，命令直接对应「加/减」动作，比在图形界面里反复勾选更不容易出错；需要注意的是，改动分组前务必确认成员，否则容易误把卧室设备一起拉进来。

场景二：终端里快速切电台

角色：长期 SSH 在树莓派或服务器上工作的开发者。痛点是想换个背景电台要切设备、开 App、找栏目。做法是 blu tunein search "jazz" 确认结果，再 blu tunein play "jazz" 直接播放。实际体验是「一次搜索 + 一次播放」两步完成，节奏比图形界面快很多；建议先 search 再 play，避免直接播放时选错电台。

场景三：脚本化的状态巡检与音量固定

角色：需要把音响状态纳入自身工具链的运维/自动化开发者。痛点是想在下班回家前把音量固定到一个安全值，或定时记录播放状态。做法是组合 blu --device <id> --json status 与 blu volume set 15，由外层定时任务或脚本调度。实际体验上，--json 是这里的关键——没有它，输出只能靠文本匹配，非常脆弱。

场景四：AI 助手代操作音响

角色：使用 AI 技能控制设备的效率工具用户。痛点是不想记命令，只想说「把这个房间的声音调小一点」。做法是由 AI 助手按技能定义调用 blu 命令完成操作。实际体验是自然语言到命令的转换很顺滑，但由于涉及真实播放状态变更，建议先让助手执行 status、并在口语化指令较模糊时要求它回读目标设备，避免误改其他房间。

整体上手难度：低。核心命令不超过十条，devices → status → play/volume 的顺序十分钟内就能跑通。真正需要花时间的是环境准备（Go 工具链、PATH、网络可达性）和目标设备确认这两件事。

该技能能为用户带来的价值

  • 把「点」变成「写」：过去一次音量调整是若干次点击，现在是一行可保存、可复用、可版本管理的命令，重复操作的成本接近于零。
  • 为自动化打开入口：--json 让播放器状态成为可解析的数据，意味着它可以被日志系统采集、被条件判断引用、被上层程序编排，这是图形 App 无法提供的。
  • 降低多设备管理复杂度：通过 --device 参数、BLU_DEVICE 环境变量与默认配置的三级优先级，常用设备配置一次即可长期复用，多房间场景不再反复指定。
  • 缩短操作路径：TuneIn 的「搜索 + 播放」两条命令，替代了 App 里逐层进入菜单的过程，日常换台的摩擦显著下降。
  • 降低误操作风险：官方建议的「改播放前先确认目标设备」配合 status 查询，形成了一套「先看后改」的稳定操作习惯，多设备环境下尤为重要。
  • 长期价值：命令行是一份可沉淀的资产。今天写下的一条脚本，明天可以给别人用、可以接进新的自动化流程，而一次性的图形点击不会留下任何可复用的东西。

常见问题 FAQ

Q1：blucli 怎么安装？必须先装 Go 吗？

官方提供的安装方式是 Go 模块安装，命令为 go install github.com/steipete/blucli/cmd/blu@latest，因此需要一个可用的 Go 工具链。安装完成后请确认 blu 已加入 PATH，并执行 blu devices 验证是否生效。如果你通过 AI 技能市场安装，具体入口与流程以官方说明为准。

Q2：这个技能收费吗？

技能详情中没有提供任何定价信息。CLI 工具本身通常以开源方式分发，但任何商业条款、授权范围与支持政策请以官方主页 https://blucli.sh 的说明为准，不要以本文为准。

Q3：它支持哪些设备？普通蓝牙音箱能控制吗？

根据技能详情，blu 用于控制 Bluesound / NAD 播放器（即基于 BluOS 的设备），并明确说明其定位为 BluOS 命令行界面。它并不是一个通用的蓝牙音频控制工具，普通蓝牙音箱不在其描述范围内。

Q4：和 BluOS 官方 App 相比应该怎么选？

如果你只是偶尔手动切歌、调音量，官方 App 更直观；如果你希望把播放控制写进脚本、接入自动化流程、或者让 AI 助手代为操作，blucli 更合适。两者不冲突，完全可以日常用 App、自动化用命令行。

Q5：脚本里怎么稳定地拿到播放状态？

使用 --json 参数输出结构化结果，例如 blu --device <id> --json status，再用 jq 之类的工具解析具体字段，而不是去文本匹配人类可读输出。同时建议在脚本中显式带 --device，避免依赖默认配置导致指向错误设备。

Q6：为什么命令执行没反应 / 找不到设备？

优先检查三件事：blu devices 是否能看到设备（网络可达性）、目标设备是否通过 --device / BLU_DEVICE / 默认配置正确指定、以及 blu 是否真的在 PATH 中。官方也特别提醒，在更改播放状态前应先确认目标设备。