PocketJS：让JS组件在掌机上绘制原生像素

PocketJS 是面向掌机与嵌入式设备的 UI 运行时，开发者可用 TypeScript 与 Solid、Vue Vapor 组件写界面，由 QuickJS 运行应用、Rust 内核完成 flexbox 布局并逐像素绘制。没有 DOM、CSS 引擎与 WebView，单线程单进程即可把熟悉的组件模型跑在 PSP、PS Vita、3DS 乃至桌面上。

适用人群：1. 掌机与复古硬件爱好者、homebrew 开发者，尤其是 PSP、PS Vita、3DS 自制软件作者；2. 嵌入式设备与 IoT 界面开发者，需要在受限内存和算力上跑轻量 UI；3. 想用前端技术栈但追求原生性能、不愿背 WebView 包袱的全栈与前端工程师。

适用场景：1. 为 PSP、PS Vita、Nintendo 3DS 等掌机开发自制应用、工具与游戏界面；2. 智能家居面板、工业设备屏等嵌入式屏幕的轻量图形界面；3. 桌面端小工具或跨设备统一 UI 原型，用同一套组件代码适配多种屏幕。

推荐理由：PocketJS 把现代前端组件模型与原生渲染结合，摆脱 DOM 与 WebView 的性能和体积包袱，单进程单线程即可在掌机和嵌入式屏幕上跑出流畅界面。对想用熟悉工具链征战受限硬件的开发者而言，这是一片难得的新大陆，值得提前关注与试用。

项目定位与背景

PocketJS 试图回答一个有趣的问题：能不能把现代前端的组件化开发体验，搬到算力和内存都极其受限的掌机与嵌入式屏幕上？传统做法要么依赖 WebView，要么用平台原生 UI 框架重写一遍。PocketJS 选择了第三条路，自己实现一套轻量运行时，让 TypeScript 组件直接映射为原生像素。它由 Pocket Nexus 维护，采用 MIT 协议，目前已有近 1800 颗星标。

核心功能与技术架构

应用使用 TypeScript 编写，支持 Solid、Vue Vapor 或 Octane 组件，三者最终渲染到同一棵原生树。运行时由两部分组成：QuickJS 作为 JavaScript guest 执行应用逻辑，Rust 内核负责 flexbox 布局并逐像素绘制。整个流程在单进程单线程内完成，没有 DOM，没有 CSS 引擎，也没有 WebView。这意味着布局与绘制的开销可预测，不必与浏览器渲染管线搏斗，非常适合低性能硬件。

创新点与亮点

首先是统一渲染树，多框架并存却共享一套原生输出，开发者可以沿用自己熟悉的响应式写法，降低迁移成本。其次是渲染主循环可回放，README 明确提到 Replay every frame，这对调试卡顿与性能分析有实际价值。第三是硬件原生 3D 栈 Pocket3D，覆盖 GXM、GE、PICA200 等设备内核，把掌机 GPU 的能力直接暴露给 JS 层。MicroTS 则是从 TypeScript 视图与模型到 Rust 的提前编译方案，进一步压低运行时开销。

与同类项目对比

相比 React Native 或 Flutter，PocketJS 更极端地砍掉了中间层，既不依赖平台 UI 组件，也不需要 Skia 这类大型绘图引擎。相比 LVGL 等嵌入式 GUI 库，它保留了 JSX 与响应式组件的心智模型，前端开发者几乎零学习成本。其代价也很明显：生态尚小，第三方库支持有限，遇到复杂控件往往需要自己造轮子，文档与社区仍在成长期。

上手指南与快速开始

项目提供 CLI 包 @pocketjs/cli 与框架包 @pocketjs/framework，均可通过 npm 安装。官网提供 Playground，可以直接在线试写组件、即时看到效果；文档覆盖概览与入门路径，博客与 Changelog 持续更新。社区侧有 Discord 与 X 账号，遇到问题可较快得到反馈。建议先从 Playground 或桌面目标跑一个 Hello World，再尝试交叉编译到掌机。

总结与展望

PocketJS 用一套紧凑的 Rust 加 QuickJS 运行时，把现代组件开发带进了掌机世界，兼顾开发体验与原生性能。它未必适合大型商业应用，但对 homebrew、嵌入式 UI 与跨设备实验项目而言，是一个非常值得关注的方案。随着 MicroTS 成熟与 3D 能力补齐，它有可能成为嵌入式前端的一股新势力。