Node.js 集成

包边界#

受支持的 npm 名字是 @wa120/ait-native。它带的是可移植的 JavaScript 和 TypeScript 门面层，并挑出确切的 1.0.0 平台 Node-API addon。

npm install @wa120/ait-native@1.0.0

这个包不打包也不启动 ait-server。它的 API 直接加载包自带的 addon，不拿子进程当绑定的传输通道。

直接调用 API#

import { NativeRuntime } from "@wa120/ait-native";

const ait = new NativeRuntime();
console.log(ait.bindingInfo());
const status = ait.runCli(["status", "--json"]);
console.log(status);

包里带的 ait 命令，在进程内调的是同一个原生绑定。所以 JavaScript API 和这个命令共享同一套已接纳的 Rust 行为。

仓库工作流#

Node.js 仓库的初始化方式和生成出来的仓库说明，跟其他受支持的仓库 完全一样。

npx --no-install ait init
npx --no-install ait status --json

AIT 不会去翻 package.json 来挑测试命令或者判断框架行为。要验证 什么，仍然由仓库自己明确说清楚。

平台包#

按目标平台拆出来的 addon 包，是锁定版本的实现依赖，不是单独的产品。 应用应该依赖顶层那个受支持的包，让 npm 的常规解析去选出匹配的 addon。