用途
Native SDK 用于构建原生桌面应用程序。与依赖浏览器或 WebView 运行时的方案不同,其 TypeScript 应用逻辑会被预先检查和编译为原生代码,因此最终发布的二进制文件不包含浏览器、WebView、JS 运行时或解释器。
主要编写方式与语言
- 主要编写路径:TypeScript 应用逻辑写在 src/core.ts 中,界面使用声明式 Native 标记写在 .native 文件中。
- Zig 是工具包自身的实现语言,同时也是一种一等的、需显式选择的应用核心替代方案(使用 --template zig-core)。它不是根据 SDK 实现默认推断出来的选项。
主要能力
- 每个应用都内嵌一个确定性的自动化服务器,使智能体能够对运行中的窗口进行快照、驱动和截图。
- 桌面端是成熟的使用场景,其中 macOS 支持最深入,Linux 与 Windows 在 CI 中验证。
- WebView 界面作为可选路径并存,可用于嵌入 Web 内容或承载已有的 Web 前端。
使用方式
安装与初始化命令:
npm install -g @native-sdk/cli
native init my_app
cd my_app
native dev
native init my_app 会生成主要的三文件应用:app.json、src/app.native(标记视图)以及 src/core.ts(包含 Model、Msg、update)。已有的 app.zon 清单仍然受支持。在编辑已有应用前应先检查目录结构,并保留其已使用的核心语言。若存在 src/main.zig,说明该应用显式使用了 Zig-core 模板;Web 前端外壳还额外包含 frontend/ 目录,通常带有自己的构建与运行时接线。
技能发现命令:
native skills list
native skills get core
native skills get native-ui
native skills get ts-core
- 使用 native skills get core 进行初步定位。
- 默认应用编写路径应同时加载 native-ui(视图、绑定、应用循环)与 ts-core(TypeScript 子集、effects、subscriptions 和模块)。
- 当目录树中存在 src/services/,或需要在 Cmd.request 背后使用文件系统、进程、JSON、正则、Map、Date、class 等常规 TypeScript 能力时,加载 ts-services。
- 当工作涉及更低层的运行时接线、WebView、桥接与安全、原生能力、打包或调试时,使用 native skills get core --full。
- 测试运行中的应用、拍摄快照、请求重载或使用内置自动化服务器时,使用 native skills get automation。
- 仅在处理已有 Zig 核心、扩展工具包、SDK 实现工作或 Zig 0.16 编译错误时,使用 native skills get zig。
适用场景
适用于需要构建无浏览器、无 WebView、无 JS 运行时依赖的原生桌面应用的场景;也适用于希望让智能体驱动和检查运行中窗口的自动化测试场景,以及需要可选嵌入 Web 内容或承载已有 Web 前端的场景。
限制
- 移动端嵌入尚处于实验阶段,未成熟。
- 桌面端虽为成熟场景,但各平台支持程度不同:macOS 最深入,Linux 与 Windows 主要在 CI 中验证。
- 关于收费、价格、许可协议及具体性能效果,资料暂未提供。