@desert-ant-labs/core

中文文档
4.3.0发布于 2026/11/06SEE LICENSE IN LICENSE.mdTypeScriptES Module零依赖近 30 天下载 3.1万

共享 JavaScript 运行时间用于沙漠蚂蚁实验室在设备模型SDKs上运行:LiteRT.js主机会话,koffi本土加载器,以及每个模型节点包所基于的FFFI缓冲读取器.

中文使用文档
文档目录3 节
  1. 它提供的东西
  2. 测试
  3. 许可证

@ 沙漠- ant- labs/ 分数

共享 JavaScript 运行时间 沙漠蚂蚁实验室 设备 型号为SDK. 每个模型节点包(@desert-ant-labs/shapes, (中文(简体) ), @desert-ant-labs/emo, (中文(简体) ), @desert-ant-labs/redact,.)构建他们的浏览器并 节点输入这些模型不可知的部件, 所以每个模型船只载荷 编解码器及其公用等级——两个出入口都是一对接线.

无意直接使用;这是模型包所依赖的共同核心 继续.

它提供的东西

浏览器安全条目( Q)@desert-ant-labs/core,没有 node:*:

  • createWasmSdk({ platform, packageName }) - 那个 整个浏览器/WebAssembly 半个模型软件包:通过切换核心 软件包 #platform 缝合,设置LiteRT.js会话,然后 open(options) 从 Hugging Face 下载模型或采用文件 a modelBaseUrl 服务,并返回准备 LoadedModel。 。 。 .
  • LoadedModel - 在不透明的核心手柄后装入的模型: run(text, options, { deviceId }) 返回一个 FfiReader附加时 isDownloaded, (中文(简体) ), flushTelemetry,以及 dispose。两个运行时间上相同的对象,所以是一个软件包 写过一次公共课. flushTelemetry 等待许可证申请 在飞行中. withCallGroup 编辑 group 呼叫选项仍然被接受 没有效果.
  • makeModelHostSeam() 编号 : makeLiteRtHost(...) - 模型主机一个主题核心是 与(dalModelHost 在生成中 Imports从 Sources/JSHost/Host.swift以及《公约》的执行情况: 命名密度 createSessionFrom* 编号 : run 与正确的 dtype 集合和 LiteRT.js 人工内存管理. 接合时间很晚,所以一个核心可以 在其会话存在前即时启动, 没有安装在 globalThis。 。 。 .
  • loadLiteRt(...) 编号 : assertBrowserRuntime(...) - 负载 @litertjs/core 一次 每个进程( 带有安装提示) , 并防范运行 enm 运行时间 在平地节点.
  • fetchSelfHostedModel(baseUrl, files) - 拿文件来 modelBaseUrl 服务:由目录名称键入的侧车,由主机编译的文物字节.
  • browserSetup 编号 : browserWasmDir 编号 : browserReadModelSource 编号 : browserCacheRoot - 一个模型的一半浏览器 #platform 缝合.
  • 原为ABI本身(create, (中文(简体) ), createSelfHosted, (中文(简体) ), isDownloaded, (中文(简体) ), download, (中文(简体) ), run, (中文(简体) ), endCallGroup, (中文(简体) ), destroy, (中文(简体) ), flushTelemetry——当地人的双胞胎 dal_* 符号,是 BridgeJS 从 @JS 条目 型号 Web/main.swift;其类型存在于软件包自己生成的 dist/bridge-js.d.ts。两个设置都返回它,所以一个模型软件包写着没有原声 胶水: 选项和结果在FFIBuffer有效载荷中交叉, 并用 编码器已经需要本地条目 .
  • FfiReader 编号 : FfiWriter - 长度前置的大端光标 FFIBuffer 有效载荷两个核心都说(Kotlin的联署材料) FfiReader) (中文(简体) ).

节点条目( E)@desert-ant-labs/core/node, 用途 node:* +koffi 键 :

  • createNativeSdk({ here, packageName, modelId, coreName }) - 土生土长 一个模型包, 镜像 createWasmSdk: 绑定预建的核心并返回 一个SDK open(options) 输出数相同 LoadedModel。 。 。 .

  • loadNative({ here, packageName, coreName, modelId }) - 下方装货机: 解决预建的 Swift 核心 native/<platform>-<arch>,加载 LitERT 运行时间先将 C ABI 绑定为 koffi( 基因) dal_* 电话加 模特儿自己来的 <modelId>_create返回时 callAsync + 键 decodeResult + 键 缓存路径助手 . SSR-安全节点接合器@desert-ant-labs/core/platform-node, 用途 node:*,没有 库菲:

  • nodeSetup 编号 : nodeWasmDir 编号 : nodeReadModelSource 编号 : nodeCacheRoot - 那个 节点的一半 #platform 当一个框架使 universal wasm 条目在节点(Next.js的客户端-组件 SSR通行证).

两个节点条目故意分开. 土生土长的船只 .node 加起来, 而捆绑者静态追踪 require("koffi") 连装入器内 虽然它只运行懒惰, 所以一个包裹的 #platform 接头导入 /node 用涡轮包的"非标记可置换"使 SSR 构建失败 资产”(或Webpack的等同)。 模版包导入 /node 从其 /native 仅输入,以及 /platform-node 从 platform-node.js。 。 。 .

音频模型使用单独的 @desert-ant-labs/core/audio 浏览器条目或 @desert-ant-labs/core/audio/node 在节点上。 文本模型的导入从未经过 音频主机或WAV编码器.

@litertjs/core 财务报告和审定财务报表 koffi 是可选的同伴依赖关系:浏览器路径 需求 @litertjs/core,本地节点路径需要 koffi,也没有 用于导入软件包.

测试

mise run test:js        # unit tests + the SSR module-graph guard (no network)
mise run test:bundles   # the bundle matrix: real bundlers, real tarballs

包裹是异形的,所以大部分可以 打破生活在一个捆绑器 而不是在一个函数。 盖有两层:

  • test/ssr-graph.test.mjs 按捆绑者的方式走静态导入图 如果浏览器或 SSR 连接到 koffi 或 a 则失败 node: 内建。 快点, 离线,运行在每一个变化.
  • test/bundle/ 包好核心和每个模型包,并用 esbuild, vite, webpack, and Next (Turbopack + webpack),外加平地节点进口 两个条目。 它重现了消费者的建设失败 js/测试/捆绑/README.md。 。 。 .

许可证

沙漠蚂蚁实验室 源头可破坏许可证。为大多数免费提供 应用软件和商务许可证必须规模化。 完整的术语在链接. 许可证发放: 许可@ desertant.com。 。 。 .

SDK的第三方通知: THIRD_PARTY_NOTICES.md。 。 。 .

版本与发布记录

@desert-ant-labs/core 共发布 24 个版本,首次发布于 2026/07/25;过去 12 个月发布了 24 个版本。

版本发布日期距今
4.3.0latest2026/11/066 天前
4.2.32026/10/3112 天前
4.2.22026/10/3112 天前
4.2.12026/10/2815 天前
4.2.02026/10/2716 天前
4.1.02026/10/2023 天前

关于 @desert-ant-labs/core 的常见问题

@desert-ant-labs/core 是什么?

共享 JavaScript 运行时间用于沙漠蚂蚁实验室在设备模型SDKs上运行:LiteRT.js主机会话,koffi本土加载器,以及每个模型节点包所基于的FFFI缓冲读取器.

如何安装 @desert-ant-labs/core?

在项目目录运行 npm install @desert-ant-labs/core,或使用 pnpm add / yarn add / bun add。

@desert-ant-labs/core 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@desert-ant-labs/core 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@desert-ant-labs/core 可以商用吗?

@desert-ant-labs/core 使用 SEE LICENSE IN LICENSE.md 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@desert-ant-labs/core 的下载量有多少?

根据 npm 官方下载统计,@desert-ant-labs/core 在 2026/10/12 – 2026/11/10 这 30 天内被下载 31,007 次,日均约 1,034 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@desert-ant-labs/core 还在维护吗?

最新版本 4.3.0 发布于 2026/11/06(6 天前);至今共发布 24 个版本,其中过去 12 个月发布了 24 个;首次发布于 2026/07/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。