用途:dreo-pp-cli 是面向 Dreo 智能家居设备的独立 CLI,供智能体或脚本在不接入 Home Assistant 的情况下读取与控制 Dreo 设备,适合批量一次性命令、全屋传感器读取、自动化调试的实时状态流以及 cron 定时自动化。
主要能力:bulk 可按类型/房间过滤批量控制电源、模式或风速;scene save/apply 可把所选设备当前状态保存为命名场景并回放;sensors 汇总全屋温度、湿度与 PM2.5,sensors record/query 将 WebSocket 状态事件写入本地 sensor_readings 表并按时间窗口查询;alerts 报告滤芯寿命低、水箱空、离线心跳或传感器超阈值;rooms 按房间聚合设备数、开启数、平均温湿度;devices search 对缓存的名称、房间、型号、序列号做全文搜索;watch 以 JSON 行输出每个 WebSocket 状态更新。
使用方式:先安装并验证 CLI。安装命令为 npx -y @mvanhorn/printing-press-library install dreo --cli-only,验证 dreo-pp-cli --version;若 npx 失败可用 go install github.com/mvanhorn/printing-press-library/library/devices/dreo/cmd/dreo-pp-cli@latest(需 Go 1.26.6+)。认证使用 Dreo 账号邮箱与密码,通过环境变量 DREO_USERNAME、DREO_PASSWORD 提供,或使用 --password-stdin;凭据与 bearer token 缓存在 ~/.config/dreo-pp-cli/config.toml(0600)。任意命令可加 --agent(等价 --json --compact --no-input --no-color --yes),支持 --select 字段筛选、--dry-run 预览、--deliver 输出到 stdout/file/webhook、命名 profile 与 --profile。可用 dreo-pp-cli which "<能力描述>" 查找命令。MCP 安装:claude mcp add dreo-pp-mcp -- dreo-pp-mcp。
限制:Dreo 无公开开发者 API,认证走 Dreo iOS 应用所用的 OAuth 端点,密码在传输前做 MD5 哈希,且不提供 refresh token,token 过期后依赖缓存凭据重新获取;--password 明文方式会输出警告。配置文件属敏感信息,不应提交、分享或未加密同步。反馈默认仅本地存储于 ~/.dreo-pp-cli/feedback.jsonl。具体收费、价格与平台支持范围资料未提供。