Rubato Vibe 项目

项目简介

Rubato 是一款巴掌大小的复古 Macintosh 风格桌面设备，搭载 ESP8266 微控制器和 240×240 彩色显示屏，专门为长时间使用 AI 编程工具的开发者设计。其核心思路独特而务实：当 AI 处理耗时较长的任务时，Rubato 会自动触发全屏微休息提醒，引导用户喝水、放松眼睛、活动颈椎或站立。设备其余时间安静显示时钟和天气，不打扰工作流程。

项目采用 Arduino 框架开发，固件完全开源（GPL-3.0 协议），硬件设计参考了 SmallDesktopDisplay 项目，所有源码和设计文档均在 GitHub 公开。用户也可直接前往 Tindie 购买成品。

核心功能

1. AI 会话状态监视：通过 MQTT over TLS 协议，Rubato 可订阅主流 AI 编程工具的状态发布（Thinking → Generating → Done），用不同灯光颜色实时镜像 AI 工作状态。

2. 智能微休息提醒：当检测到 AI 任务预计耗时 ≥30 秒时，自动弹出全屏休息提醒，覆盖六种健康活动：喝水、眼部休息、颈椎伸展、站立、凯格尔运动和如厕提醒。

3. 每日配额管理：每项健康活动设有每日配额，每日两次全屏提醒间隔至少 30 分钟，避免频繁打断工作节奏。

4. 复古桌面时钟：NTP 网络校时，显示日期和自动定位天气（基于 Open-Meteo 免费 API），安静融入办公桌面。

5. MQTT 状态呼吸灯：每个设备独立 MQTT 凭证，设备仅镜像 AI 会话状态，不传输消息文本，保护用户隐私。

6. OTA 远程自更新：通过分段 HTTPS 下载固件更新，内置防变砖机制——更新失败自动进入安全模式并远程自愈，无需 USB 重新烧录。

7. 浏览器配置界面：通过 Web 界面调节亮度、屏幕方向和温度单位（℃/℉），所有设置断电不丢失。

8. 多 Agent 插件支持：支持 DeepSeek Harness、OpenClaw、Cursor、OpenCode 等主流 AI 编程工具的插件，共享同一 MQTT 协议规范，Codex 和 Claude Code 插件正在开发中。

技术实现

硬件层：ESP8266（NodeMCU）+ 240×240 TFT 显示屏，通过 USB Type-C 供电，采用 Arduino 框架（ESP8266 core 3.1.2 + TFT_eSPI 库）。硬件设计借鉴了开源项目 SmallDesktopDisplay，开发者也可自行购买元器件焊接。

固件层：主程序 rubato.ino 处理 MQTT 连接、状态解析和 UI 渲染；健康图标资源由 tools/ 目录下的工具链生成。插件系统通过 MQTT 主题订阅获取各 AI 工具的状态事件。

连接流程：上电后设备创建热点，浏览器访问配置页面输入 WiFi 凭证和 MQTT Broker 地址，通过一条串口命令完成配对，全程无需复杂操作。

快速上手

第一步：刷入固件

从 GitHub Release 下载最新 .ino 固件，通过 Arduino IDE 或 esptool 烧录到 ESP8266 开发板。

第二步：配置网络和 MQTT

设备启动后生成热点，用浏览器打开 192.168.4.1 配置 WiFi 和 MQTT Broker 地址。

第三步：配对 AI 编程工具

在 DeepSeek Harness、OpenClaw 或 Cursor 中安装对应插件，配置 MQTT Broker 地址，插件状态发布后 Rubato 自动同步。

第四步：放置桌面，开始工作

设备自动进入时钟模式，AI 任务运行时自动切换到对应状态颜色，休息提醒自动触发。

适用人群

1. 长时间使用 AI 编程工具的开发者：久坐导致颈椎、腰背和眼部疲劳的高风险人群，Rubato 的微休息提醒从源头干预不良工作习惯。

2. 关注工作健康的独立开发者/远程工作者：不需要公司健康管理支持，自己动手改善工作环境，Rubato 是低成本的自我关怀工具。

3. 开源硬件爱好者：喜欢自己焊接、刷固件、定制功能的极客用户，项目完全开源，可自行修改或扩展功能。