mcpField
N
native-sdk

native-sdk

github.com/vercel-labs开发7.8k1.5k 次安装1 周前更新
代码仓库

关于 native-sdk

Native SDK 是用于构建原生桌面应用的工具包，主要通过 TypeScript 应用逻辑和声明式 Native 标记编写应用，并将代码预先编译为原生代码。它还为每个应用内置确定性自动化服务，支持 Agent 检查和操控运行中的窗口；移动端嵌入仍属实验阶段。

主要功能

  1. 01以 TypeScript 和 Native 标记构建应用
  2. 02将 TypeScript 核心预编译为原生代码
  3. 03提供 Zig 核心作为可选方案
  4. 04内置窗口快照、操控与截图自动化
  5. 05支持可选 WebView 表面

适用场景

  1. 01构建原生桌面应用
  2. 02让 Agent 对运行中的窗口进行自动化操作
  3. 03为应用嵌入网页内容或现有前端

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/vercel-labs/native --skill native-sdk

安装后在 Claude Code 中输入/native-sdk确认已加载。

详细介绍

Native SDK

Native SDK 是用于构建原生桌面应用的完整工具包。主要的编写方式是在 src/core.ts 中编写 TypeScript 应用逻辑，并在 .native 文件中使用声明式 Native 标记。 TypeScript 核心会提前检查并编译为原生代码，因此发布的二进制文件不包含浏览器、WebView、JS 运行时或解释器。Zig 是工具包本身的实现语言，也是一种一等的、需显式选择的应用核心替代方案（--template zig-core）；不能因为 SDK 使用 Zig 实现，就默认应用核心也是 Zig。每个应用都会嵌入一个确定性的自动化服务，因此 Agent 可以对运行中的窗口创建快照、进行操作并截屏。桌面是成熟的平台（macOS 支持最深入，Linux 和 Windows 已纳入 CI 测试）；移动端嵌入功能仍处于实验阶段。WebView 界面可作为可选方案，与其他界面并存，用于嵌入 Web 内容或承载现有的 Web 前端。

从这里开始

此文件是一个发现入口，供通过 npx skills add native-sdk 等技能安装器安装过一次 Native SDK 的 Agent 使用。在实现或讲解 Native SDK 应用开发之前，请使用已安装的 CLI 发现并加载当前技能内容：

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 子集、效果、订阅和模块）。如果项目中有 src/services/，或普通 TypeScript 需要通过 Cmd.request 处理文件系统、进程、JSON、正则表达式、Map、Date 或类，也请加载 ts-services。当工作涉及较低层的运行时接线、WebView、桥接与安全、原生功能、打包或调试时，请使用 native skills get core --full。测试正在运行的应用、创建快照、请求重新加载或使用内置自动化服务时，请使用 native skills get automation。仅在处理现有 Zig 核心、工具包扩展、SDK 实现工作或 Zig 0.16 编译错误时，才使用 native skills get zig。

快速了解

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 核心模板；Web 前端外壳还会包含 frontend/，通常也包含自有的构建和运行时接线。

评论

支持 Markdown