返回资讯中心
外部精选
软件工程
#开发者实时流

FrameOS:在ESP32上用JSX和Tailwind渲染界面

来源标题:FrameOS – JSX and Tailwind on an ESP32

开源项目FrameOS让ESP32或树莓派驱动任意显示屏,实现日历、仪表盘或艺术画框功能,所有渲染都在设备端完成。界面用.tsx文件和Tailwind类编写,编译为SVG后在芯片上以React风格只重绘变化部分,无需服务器或浏览器。项目自2023年起以AGPL-3.0协议开源,可离线独立运行,也支持自托管后端或FrameOS Cloud管理。

Hacker News 最新mariusandra2026/11/17 · 今天15 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

用于智能相框的操作系统

把 Raspberry Pi 或 ESP32 与任意显示屏——e-ink、HDMI 或 LCD——变成能自主运行的日历、仪表盘或艺术相框。一切都在设备端渲染。可以独立运行、用自托管后端控制,或通过 FrameOS Cloud 管理——无论哪种方式,相框的运行表现都一样。

2023 年起免费开源(AGPL-3.0)· 支持离线 · 云端可选 · 永久归你所有

装在 3D 打印相框里的 13.3 英寸 Spectra 6 彩色 e-ink 面板

微控制器上的 JSX + Tailwind

像开发 Web 应用一样构建相框的 UI:一个带 Tailwind 类名的 .tsx 文件,支持 onClick、滑块和文本输入框,最终全部构建成一个 SVG。ESP32 在芯片上以 React 风格渲染它,只重绘发生变化的部分——不需要服务器,不需要浏览器。同一个文件也能在 Pi 上、HDMI 上、电子纸上以及你的浏览器里运行。就在下面试一试,它是实时运行的!

场景编辑器里的“大杂烩”:开关、可拖动的滑块、带屏幕键盘的表单、画布,还有 Lights Out——六个触摸页面装在同一个文件里。预览为 SenseCAP Indicator,运行在 ESP32 的 8 MB 内存之内。

在 480x480 的 SenseCAP Indicator 上轻点一个 JSX 智能家居面板。只重绘发生变化的部分。

DVD 标志弹跳效果,用 JSX 编写,运行在同一块 ESP32-S3 LCD 上。

Flexbox 和 grid、渐变、内联 SVG 图标、带屏幕键盘的输入框、下拉选择框以及可滚动的列表。

sm: 到 2xl: 以及 portrait: 会跟随面板变化,而 app.frame.color 会告诉你何时切换到高对比度。

全屏 Playground

为摄影而打造

FrameOS 会映射每张图像的亮度直方图,并把它的范围适配到面板实际能显示的色阶上。随后我们用哈希抖动进行抖动处理,以平滑锯齿线和渐变。拖动滑块进行对比。还想要更多?可以逐张手动调色,或用内置的 Photos 功能管理整个图库。颜色控制指南 →Photos 指南 →

滑块左侧:FrameOS。滑块右侧:Clipped。

HoverflyRiverSunsetToucan

每一对都是编辑器针对 7.3 英寸 Spectra 6 面板、以其真实 800x480 像素所做的预览。

Raspberry Pi 是经典选择。从 Zero W 到 Pi 5 的任何型号都行。支持 120 多种 e-ink 面板以及 HDMI 等其他输出。你可以通过相框自带的管理页面和 HTTP API 管理它。从预构建的 SD 镜像启动,或用 shell 脚本安装到任意 Linux 上。

ESP32-S3 让你可以打造电池供电的相框,在两次刷新之间深度睡眠。它仍然是完整的 FrameOS 体验。一切都在设备端渲染,包括 50MB 的 JPEG。最简单的起步方式是现成的 Seeed Studio reTerminal:选择它的预设,然后从浏览器刷入。Waveshare 的 PhotoPainter、Seeed 的 XIAO ePaper 开发板、TRMNL 套件以及自定义配置也同样适用。没有 PSRAM 的开发板(例如 ESP32-C3)作为瘦客户端运行。

这三种方式都在设备端渲染,而且相框可以在它们之间切换而无需重新刷写。

独立相框:刷入一个 Pi,并通过 WiFi 热点完成设置,或安装到任意 Linux 上。无需后端,无需账号。自托管后端:在你的笔记本、服务器或 NAS 上运行 frameos Docker 镜像。然后通过网络中的 SSH 管理相框。FrameOS Cloud:无需安装任何东西。下载定制的 SD 卡,或通过 USB 刷写 ESP32。在配额允许的前提下,个人使用永久免费。

选择一条路径,查看下一步。

一套 OS,适用于两种相框。在 e-ink 上,场景在到期时渲染,两次渲染之间相框休眠。在触摸屏上,它实时运行、响应点击,并且只重绘发生变化的部分。无论哪种方式,场景都能一键安装,并且可以编辑到源码级别。

面向 e-ink 的照片、日历、天气和艺术画。场景按计划渲染,或按一下按钮就渲染,而 ESP32 在两次渲染之间靠电池深度睡眠。

面向触摸屏的仪表盘、列表和控件。针对 ESP32 调优,点击响应时间不到十分之一秒,DVD 标志的帧率约为 29 fps。在 Raspberry Pi 上一切更加流畅。

接入你自己的 agent,在 FrameOS Cloud 中与助手对话,或直接和相框对话。AI 生成的场景在到达相框之前会被渲染并检查,设置中的一个开关可以关闭 AI。

$ claude mcp add \

--transport http frameos \

https://cloud.frameos.net/api/mcp \

--header "Authorization: Bearer …"

连接你自己的 agent

在 Claude Code、Cursor 或任何其他 MCP 客户端中,把 FrameOS 添加为 MCP 服务器,可来自 FrameOS Cloud,也可来自你自己的后端。大约 80 个工具——相框、截图、场景、渲染、相册——而 agent 只会在你要求时才改动相框。

把时钟调大,显示 Tallinn 的天气

在 FrameOS Cloud 中提问

每个场景都有 AI 面板。描述场景或要做的更改:助手会编辑代码、渲染结果、查看效果并修正偏差,然后由你保存。在相框页面上提问,它就会把场景放到你的相框上。自托管后端也有这个功能,用你自己的 OpenAI key。

按住按钮说出指令

在带麦克风的相框上,比如 Seeed reTerminal E1002、Sticky 或 Waveshare PhotoPainter,按住语音键说话。它会切换场景、更改设置、播放相册,或让 AI 构建一个新场景——在你安装之前以预览形式显示。

FrameOS Case Maker 为受支持的面板和 Raspberry Pi 布局生成参数化、可 3D 打印的外壳。选择一个模板,调整深度和边框,添加壁挂、支架、USB-C 开口和螺柱,然后下载 STL。

它和文档使用同一个硬件数据库,因此常见的 Waveshare 和 Pimoroni 配置会从合理的尺寸开始,而不是一个空白的 CAD 文件。

阅读外壳指南

观看完整搭建(Raspberry Pi)

录制于一年多以前,当时 FrameOS Cloud 和 ESP32 支持尚不存在。

独立的 Pi、自托管后端,或一个 FrameOS Cloud 账号——指南涵盖了全部三种方式,而最终得到的相框是一样的。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →