用途:通过生成的 BLE 设备命令行工具 ble-desk-lamp-pp-cli 控制 BLE 桌面灯。
前提:调用任何技能命令前必须先确认 CLI 已安装,未安装则先执行安装命令。安装方式:npx -y @mvanhorn/printing-press-library install ble-desk-lamp --cli-only。该安装器在 macOS/Linux 默认将二进制放到 $HOME/.local/bin,在 Windows 默认放到 %LOCALAPPDATA%\Programs\PrintingPress\bin。安装后需确保该目录位于调用该技能的 agent/runtime 的 $PATH 中。
验证:ble-desk-lamp-pp-cli --version。若安装后仍报 command not found,说明运行时无法在 $PATH 看到二进制目录,验证成功前不要继续执行技能命令。
主要能力与用法:使用 ble-desk-lamp-pp-cli capabilities --json 查看可调用与被保留的 BLE 能力,包括安全类别与证据引用;使用 ble-desk-lamp-pp-cli status --json 查看基于回放的 status 输出;使用 ble-desk-lamp-pp-cli toggle --dry-run --json 预览 toggle 写入。
真实设备控制:默认 CLI 为回放模式;如需控制真实设备,需以 -tags ble_live 构建并传入 --live,可用 ble-desk-lamp-pp-cli doctor 检查实时就绪状态,用 ble-desk-lamp-pp-cli scan --live 发现设备。
限制:仅当设备 spec 启用 device-session 支持时,才会生成会话 IPC 脚手架。若 npx 安装在该 CLI 尚无公共库分类前失败,可安装 Node,或在发布后使用对应分类的 Go 回退方案。实时控制、安全类别、证据引用等细节需以上述命令自行查看;其余信息资料暂未提供。