用途:让智能体通过生成的 BLE 设备命令行工具控制 BLE Session Appliance。
前置条件:必须先确认 CLI 已安装,缺失则先安装。安装命令:npx -y @mvanhorn/printing-press-library install ble-session-appliance --cli-only。安装目录在 macOS/Linux 默认为 $HOME/.local/bin,Windows 为 %LOCALAPPDATA%\Programs\PrintingPress\bin,需确保该目录在运行时 $PATH 中。验证:ble-session-appliance-pp-cli --version;若报 command not found,先解决 PATH 问题再继续。
主要能力:用 capabilities --json 查看可调用与被保留的 BLE 能力(含安全等级与证据引用);status --json 查看回放支撑的状态;doctor 检查实机就绪;scan --live 发现设备;start --dry-run --json 预览启动写入;session start/status --json 查看本地回放会话运行时(含锁、能力令牌、端点元数据);telemetry capture/latest/sessions --json 使用本地遥测存储脚手架与会话摘要。
使用方式:默认 CLI 为回放模式。要控制真实设备,需以 -tags ble_live 编译并传入 --live。在验证模式之外执行启动等写操作,需先检查 dry-run 输出,再传 --confirm-physical-effect。若 npx 安装在该 CLI 进入公共库分类前失败,可安装 Node 或待发布后使用分类专属 Go 回退方案。
限制:资料未提供支持设备型号、平台兼容性、权限要求、收费与价格、实际控制效果及安全边界等细节,暂未提供。