Alexa CLI

🔊 命令行掌控全屋智能

通过非官方 API 控制亚马逊 Echo 设备与智能家居,支持语音播报、自然语言指令与设备管理,适合开发者和自动化场景

收藏
9.2k
安装
4k
版本
0.2.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

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 内容

手动下载zip · 1.8 kB
skill.mdtext/markdown
请选择文件