Alexa CLI

核心功能

Alexa CLI (alexacli) 是一款基于非官方 Amazon Alexa API 的命令行工具，允许用户通过终端控制 Echo 设备与智能家居生态。核心能力包括：

• 语音播报 (TTS)：向指定或全部 Echo 设备发送语音消息，支持灵活的设备名称模糊匹配
• 自然语言控制：通过 alexacli command 发送任意语音指令，如控制灯光、调节恒温器、操作门锁、播放音乐、设置计时器等
• 设备管理：列出所有 Alexa 设备，获取结构化 JSON 输出便于自动化集成
• 即将支持：直接智能家居 API（无需自然语言）和预设场景（Routines）执行

显著优点

1. Agent/AI 友好：--json 输出格式统一，命令式设计便于脚本编排和自动化工作流
2. 自然语言优先：command 子命令接受口语化指令，降低智能家居控制的认知门槛，无需记忆具体设备 ID 或 API 参数
3. 部署灵活：支持 Homebrew 和 Go 两种安装方式，依赖单一二进制文件
4. 设备匹配智能：支持大小写不敏感、部分匹配的设备名称识别

潜在局限

• 非官方 API 风险：依赖 Amazon 未公开的内部接口，存在随时失效或被限制的可能性
• Token 生命周期短：刷新令牌约 14 天过期，需定期重新认证或维护自动化刷新流程
• 功能边界：音乐播放、部分智能家居设备可能因区域账户权限而存在差异
• 安全依赖：需妥善保管 ALEXA_REFRESH_TOKEN，泄露即等同于账户权限泄露

适合人群

• 开发者构建智能家居自动化脚本
• DevOps/SRE 团队集成 CI/CD 通知到 Echo 设备
• 技术用户偏好终端工作流而非 Alexa App
• AI Agent 需要程序化控制物理环境

常规风险

• 令牌泄露导致未授权访问 Amazon 账户
• API 变更导致工具突然失效
• 语音指令误识别引发意外设备操作（建议搭配 --json 验证）

核心用法

alexa-cli 是一款纯 Markdown 文档型 Skill，本身无可执行代码，核心功能是调用外部 alexacli 二进制工具控制 Amazon Alexa 生态设备。使用前需通过 alexa-cookie-cli 获取 Amazon 账户刷新令牌并配置环境变量 ALEXA_REFRESH_TOKEN。

主要能力分为三类：

• 设备管理：alexacli devices 列出所有 Echo 设备，支持 --json 机器可读输出
• 语音播报：alexacli speak "文本" -d "设备名" 实现指定设备 TTS；--announce 标志可向全屋所有设备广播
• 智能控制：alexacli command "自然语言指令" -d "处理设备" 模拟语音交互，支持灯光、温控、门锁、音乐播放、定时器等全品类智能家居控制

设备名称支持部分匹配、不区分大小写，降低脚本编写难度。输出统一遵循 {success, data, error} JSON 信封格式，便于 AI Agent 解析处理。

显著优点

1. 零代码侵入：纯文档型 Skill（T-MD 模式），无代码执行风险，安全边界清晰
2. 自然语言优先：command 子命令接受自然语言指令，无需记忆复杂 API，对 Agent 友好
3. 全屋广播能力：--announce 实现多设备同步播报，适合构建完成通知、告警等场景
4. 安装便捷：支持 Homebrew 和 Go 双渠道安装，依赖管理简单
5. 输出标准化：强制 JSON 输出模式，与自动化工作流无缝集成

潜在局限

• 外部依赖风险：核心功能完全依赖第三方 alexacli 二进制，该工具使用 Amazon 非官方 API，存在 API 变更或封禁可能
• 令牌生命周期：刷新令牌有效期仅约 14 天，需定期重新认证，中断自动化流程
• 网络稳定性：指令需经 Amazon 云端处理，本地网络中断或 Amazon 服务异常会导致控制失败
• 隐私顾虑：语音交互数据经 Amazon 服务器，对完全离线场景不适用
• 设备覆盖限制：仅支持 Alexa 生态，无法跨平台控制 Google Home、HomeKit 等设备

适合人群

• 已部署 Amazon Echo 设备的智能家居用户
• 需要将构建状态、CI/CD 结果语音播报的开发者
• 希望通过脚本自动化日常场景（起床、离家、睡眠模式）的极客用户
• 使用 Clawdis/AI Agent 构建语音交互工作流的技术爱好者

常规风险

• 令牌泄露：ALEXA_REFRESH_TOKEN 需妥善保管，多用户环境或日志中暴露可能导致账户风险
• 供应链安全：alexacli 需通过官方渠道（brew/go install）安装，避免下载篡改版本
• API 合规性：使用非官方 API 可能违反 Amazon 服务条款，存在账户限制风险
• 权限过度：alexacli 获得与 Alexa App 同等控制能力，包括门锁解锁等敏感操作，需警惕脚本误触发