eightctl

🛏️ 智能床垫的自动化睡眠管家

由PSPDFKit创始人开发的Eight Sleep智能床垫控制技能,通过CLI工具实现温度调节、闹钟管理等睡眠环境自动化。

收藏
1.5k
安装
479
版本
v1.0.0
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

核心用法

eightctl 是一个面向 Eight Sleep 智能床垫用户的控制型 Skill,通过调用外部 eightctl CLI 工具实现对睡眠设备的全面管理。用户需先安装 Go 编写的 eightctl 二进制文件,并配置 Eight Sleep 账号凭据(支持 ~/.config/eightctl/config.yaml 配置文件或 EIGHTCTL_EMAIL//EIGHTCTL_PASSWORD 环境变量)。核心功能涵盖五大模块:设备状态查询(eightctl status)、电源控制(eightctl on|off)、温度调节(eightctl temp 20)、闹钟管理(list|create|dismiss)以及睡眠计划调度(schedule` 系列命令)。此外还支持音频播放控制和床垫角度调节(Base 功能),满足从基础到进阶的完整睡眠场景自动化需求。

显著优点

该 Skill 的最大优势在于其纯文档零代码的安全架构——SKILL.md 仅提供使用指南,所有实际功能委托给外部可信工具执行,彻底消除了代码注入风险。作者 Peter Steinberger 作为 PSPDFKit 创始人和资深开源贡献者(GitHub 4万+关注者),其技术声誉和工程严谨性为项目背书。功能设计上,它填补了智能家居领域 CLI 自动化的空白,让开发者能通过脚本实现睡眠环境的程序化控制,例如根据日程自动调节睡前温度、联动其他智能家居设备等。文档质量极高,认证方式、配置路径、rate limit 警告等关键信息一目了然,且明确标注 API 的非官方性质,体现了对用户的充分告知义务。

潜在缺点与局限性

首要限制是硬件绑定——仅 Eight Sleep 设备用户可用,受众面较窄。其次依赖外部 CLI 工具增加了使用门槛,用户需自行安装 Go 环境并编译/安装 eightctl,对非技术用户不够友好。API 的非官方性质意味着存在服务变更或中断风险,且已明确存在 rate limit,高频操作可能导致账号受限。功能层面,当前版本未提供状态回调或事件监听机制,难以实现复杂的条件自动化。此外,床垫温度、闹钟等物理设备的远程控制虽便利,但也引入了误操作可能影响睡眠质量的风险。

适合的目标群体

核心用户为拥有 Eight Sleep 智能床垫的技术型用户,尤其是习惯命令行工作流的开发者、运维工程师和自动化爱好者。适合希望将睡眠管理纳入现有自动化工作流的人群(如结合 cron 定时任务、Home Assistant 或自定义脚本),以及需要远程预处理睡眠环境(如下班前预热床垫)的场景。对智能家居集成有 DIY 需求的极客用户,可通过该 CLI 工具作为桥梁,实现 Eight Sleep 与其他系统的联动。

使用风险

性能与稳定性风险:非官方 API 可能随时变更,导致功能失效;rate limit 机制要求避免频繁登录或操作。依赖项风险eightctl 工具版本由用户安装时控制(@latest),若作者发布破坏性更新可能影响兼容性。物理设备风险:温度调节和闹钟控制直接影响睡眠体验,误操作可能导致不适;建议严格遵循文档提示,修改前确认目标设备。凭据安全风险:虽 Skill 本身不处理敏感信息,但用户需妥善保管 Eight Sleep 账号密码,建议使用环境变量而非配置文件存储,并设置文件权限 600。网络与隐私风险:所有 API 调用通过外部工具执行,数据流向取决于 eightctl 实现,用户需信任该开源工具的数据处理方式。

安全解读

核心用法

eightctl 是一个纯文档型 Skill,用于指导用户通过外部 CLI 工具控制 Eight Sleep 智能睡眠舱。主要功能模块包括:

  • 设备状态eightctl status 查看当前状态,eightctl on|off 开关设备
  • 温度控制eightctl temp <度数> 精确调节床垫温度(摄氏度)
  • 闹钟管理list|create|dismiss 管理智能唤醒闹钟
  • 日程设置schedule list|create|update 配置自动化睡眠计划
  • 音频控制audio state|play|pause 控制助眠音频播放
  • 底座调节base info|angle 查询/调整床垫底座角度

身份验证通过 ~/.config/eightctl/config.yaml 配置文件或环境变量 EIGHTCTL_EMAILEIGHTCTL_PASSWORD 完成。

显著优点

1. 功能全面:覆盖 Eight Sleep 核心功能,一站式控制温度、闹钟、日程
2. 命令直观:CLI 设计简洁,参数语义清晰,学习成本低

3. 纯文档安全:Skill 本身无可执行代码,零攻击面

4. 作者可信:维护者 Peter Steinberger 为 PSPDFKit 创始人,176 个公开仓库,开源社区资深贡献者

潜在缺点与局限性

1. 非官方 API:底层接口未经 Eight Sleep 官方认证,可能因服务变更而失效
2. 速率限制:频繁调用可能触发限流,需避免重复登录

3. 外部依赖:实际功能依赖 eightctl CLI 工具,需单独安装 Go 环境

4. T3 来源级别:个人开发者项目,无企业级支持保障

适合人群

  • Eight Sleep 智能床垫用户,偏好命令行/自动化控制
  • 智能家居集成爱好者,希望将睡眠设备纳入自动化工作流
  • 开发者和技术用户,熟悉 CLI 工具和环境变量配置

常规风险

  • 凭据安全:环境变量可能泄露至 shell 历史或进程列表,建议使用配置文件
  • 服务中断风险:非官方 API 稳定性不及官方渠道
  • 操作确认:温度/闹钟变更建议增加人工确认环节,避免误操作

eightctl 内容

手动下载zip · 928 B
SKILL.mdtext/markdown
请选择文件