NSH 全称 Native Shell,由 Longbridge 开发,是一个用 Rust 实现的跨平台原生 UI 运行时。开发者或 AI 模型用 TSX 和 Tailwind 写界面模块,NSH 在每个平台上用该平台自己的 UI 渲染。iOS、Android、macOS、Windows、Linux 上是原生视图,GPUI 应用里是 GPUI 元素,Web 上是 HTML。应用可以在运行时把这些模块当作插件加载。同一个模块也可以打包成独立应用。
主要功能
- 真正的原生 UI:每个元素都对应平台视图,包括 UIKit、Android views、AppKit、用 Direct2D 绘制的 Win32 和 GTK 4。布局使用 flexbox 和 grid(基于 Taffy)。系统自带的文本、输入、滚动和无障碍能力可以直接使用。地图、WebView 等原生组件也能与 NSH 的视图叠加。
- 既能当插件,也能当独立应用:在现有应用的任意页面嵌入
NshAppView(iOS)、NshView(Android)或AppView(桌面和 GPUI),Web 页面则使用createPlayer。模块可以从内置 bundle、开发服务器或下载的签名包中加载,所以功能更新可以脱离宿主应用的发版节奏。 - 对 AI 友好:一个模块就是一个 TSX 文件,由组件、signal 和 Tailwind 类名组成,这是大模型最擅长生成的格式。所有元素、属性和模块都有由 Rust 源码生成的 TypeScript 类型声明。文档以 llms.txt 形式提供给模型。
nsh trace可以在没有设备的情况下无头运行模块来做检查。 - 沙箱与签名:每个视图的模块都在独立的 QuickJS 虚拟机中运行,有内存、调用时间和节点数量限制,只能使用宿主授予的能力。发布包使用 Ed25519 签名,发布密钥由离线根密钥认证,设备端会检查吊销列表。
- 性能:只有应用本身的代码是 JavaScript。signal、渲染器、布局、动画和所有内置模块都由 Rust 实现,每一帧以一个批次传给 UI 线程。
- 一个命令行工具覆盖整个工具链:单个
nsh二进制负责打包、类型检查、热重载开发服务和发布。
支持平台
| 平台 | 绘制方式 | 系统要求 |
|---|---|---|
| iOS | UIKit、CoreText | iOS 15+ |
| Android | Android views | Android 9(API 28)+ |
| macOS | AppKit、Core Animation | macOS 14+ |
| Windows | Win32、Direct2D、DirectWrite | Windows 10 1809+ |
| Linux | GTK 4、Pango | GTK 4.14+ |
| GPUI(macOS/Windows/Linux) | GPUI | macOS、Windows;Linux 需要 Vulkan |
| Web | HTML、CSS | 现代浏览器 |
目标用户与使用场景
- 想用 Web 技术栈写界面,又要原生外观和性能的跨平台应用开发者。
- 想在已有原生应用里嵌入动态模块,并通过签名包独立于应用商店发版的团队。
- 想让大模型生成界面,并在沙箱里安全运行的 AI 应用开发者。
- 使用 GPUI 构建桌面应用的 Rust 开发者。
安装与使用
curl -fsSL https://nsh.dev/install.sh | sh # macOS、Linux
irm https://nsh.dev/install.ps1 | iex # Windows(PowerShell)
brew install longbridge/tap/nsh # Homebrew
创建并以热重载方式运行应用:
nsh init my-app
nsh run my-app
nsh run my-app --target ios # 也支持 android、macos、gpui、web
发布签名更新:先用 nsh keygen 生成根密钥和发布密钥,再用 nsh certify 认证,最后用 nsh publish 生成签名的 .nshpkg。独立应用可以用 nsh package --target <平台> 打包。
技术要求与注意事项
- 在 iOS 模拟器上运行需要 Xcode,在 Android 上运行需要 Android SDK。
- 从源码构建需要 Rust 工具链,仓库内的
rust-toolchain.toml会指定版本。 - 项目采用 Apache-2.0 许可证。
- 项目较新,GitHub 上约 121 个 star。文档、指南和在线演示见 nsh.dev。
- 仓库提供 gallery、counter、hopper 等示例应用,以及嵌入 iOS 和 Android 原生应用的示例。
发现更多
Bencher
一套持续基准测试工具,旨在在 CI 中发现性能回归问题。
MIT
Apache-2.0
+1Aastro
使用 Go 语言编写的可扩展 API 网关。可加载自定义插件以扩展功能。
Apache-2.0
Go
+1Dify.ai
构建、测试和部署大语言模型(LLM)应用。
Apache-2.0
Commons-Clause
+1DreamFactory
可将任何 SQL、NoSQL 或结构化数据转换为 RESTful API。
Apache-2.0
PHP
+2Gerrit
面向基于 Git 的项目的代码评审与项目管理工具。
Apache-2.0
Java
+1Gitblit
用于管理、查看和托管 Git 仓库的纯 Java 技术栈。
Apache-2.0
Java
