@aphrody/runtime-sdk

中文文档
1.4.7发布于 2026/10/23MIT AND Apache-2.0TypeScriptES Module近 30 天下载 4953

YOLO 本地运行时间的 Light TypeScript SDK: 通过版本 C ABI 加载已预编入库

中文使用文档

@ aphrody/ runtime- sdk

YOLO 本地运行时间的 Light TypeScript SDK : 加载已预编的 yolo_runtime 库通过 其版本为 C ABI 的 bun:ffi核心模块 runtime:system 财务报告和审定财务报表 runtime:process· ; 可选客户端是 runtime:desktop 财务报告和审定财务报表 runtime:browser。 。 。 . 这里没有编译一个引擎 。 见仓库的 运行时间 ABI 财务报告和审定财务报表 运行时间决定。 。 。 .

import { Runtime } from "@aphrody/runtime-sdk";

using runtime = Runtime.load(); // verified artifact, ABI negotiated first
using child = runtime.spawn({
  program: "server",
  args: ["--port", "8080"],
  stdio: "capture",
});
await child.waitForHttp({ port: 8080, path: "/health" });
await child.stopAsync(2000);

图书馆分辨率 : $YOLO_RUNTIME_LIB,然后安装的文物 (单位:千美元)$YOLO_RUNTIME_HOME/<target>/current默认值 ~/.yolo/runtime,则 target/runtime/ 会 议 日 程 和 议 程 这个Bun OS的检查。 安装方式 just yolo::runtime-install后滚 just yolo::runtime-rollback。 。 。 .

对于一发二进制输出,ABI 1.4 提供有明确表示的无损失捕获 预算。 过量流拒绝 RuntimeError 编号 : Status.OutputLimit; 无成功 反应被截断。 现有 capture 模式仍然是64 KiB诊断尾.

using runtime = Runtime.load();
using child = runtime.spawn({
  program: "converter",
  args: ["input"],
  stdio: "capture-lossless",
  maxOutputBytes: 8 * 1024 * 1024, // per stream, total across all drains
});
const { stdout, stderr, status } = await child.collectOutput({
  timeoutMs: 30_000,
});
// stdout/stderr are owned Uint8Arrays; arbitrary bytes survive without UTF-8 decoding.

collectOutput 在超时时阻止孩子,中止或捕捉出错和排水 合并阅读器关闭后终端输出 。 召师放出手柄. 土著捕捉工人在进程释放/运行时间破坏返回之前加入. 运行时间关闭后, SDK 手柄会拒绝更多本地呼叫, 可以处理 没有输入已卸下代码。 Unix 关闭覆盖自有进程组; Windows 进程- 树上关闭和运行时对其他目标的行为仍然需要 执行资格.

可选客户端不激活任一引擎就加载. 桌面单独打开一个 已安装 yolo-desktop CEF主机通过共享进程主管. 导入 @aphrody/runtime-sdk/desktop 打电话 desktop.open 明确 grants 准确 allowedOrigins; 处理会话以关闭窗口和 加入它的东道主。 已验证的桌面安装帮助从导出 @aphrody/runtime-sdk/desktop-artifact。 。 。 .

导入 @aphrody/runtime-sdk/browser 打电话 BrowserRuntime.load 用于使用 可选本地浏览器提供者。 核心ABI和 browser.* 能力是: 在任何扩展符号被绑定之前谈判。 每个上下文都需要精确 HTTP( S) 函数 allowedOrigins; 私人网络访问需要一个明确的上下文选择. 上下文拥有与世隔绝的入室饼干和JavaScript域. 导航, 提取、评价和PNG 捕获接受取消;处置其所有者 在图书馆卸货前加入本地工人.

这些SDK API没有建立本地渲染或分销资格. ABI 1.4 核心文物缺乏浏览器能力,桌面需要自己的 经核实的本地可执行性(其载荷为CEF)加上Linux上的GTK 4平台的先决条件。 本地提供者 并且目标支持仍然受制于其实际建造和执行大门.

版本与发布记录

@aphrody/runtime-sdk 共发布 7 个版本,首次发布于 2026/10/05;过去 12 个月发布了 7 个版本。

版本发布日期距今
1.4.7latest2026/10/2315 天前
1.4.42026/10/1820 天前
0.1.42026/10/1028 天前
0.1.32026/10/1028 天前
0.1.22026/10/0929 天前
0.1.12026/10/071 个月前

关于 @aphrody/runtime-sdk 的常见问题

@aphrody/runtime-sdk 是什么?

YOLO 本地运行时间的 Light TypeScript SDK: 通过版本 C ABI 加载已预编入库

如何安装 @aphrody/runtime-sdk?

在项目目录运行 npm install @aphrody/runtime-sdk,或使用 pnpm add / yarn add / bun add。

@aphrody/runtime-sdk 支持 TypeScript 吗?

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

@aphrody/runtime-sdk 支持 ESM 还是 CommonJS?

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

@aphrody/runtime-sdk 可以商用吗?

@aphrody/runtime-sdk 使用 MIT AND Apache-2.0 许可。声明的许可为 MIT AND Apache-2.0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

@aphrody/runtime-sdk 的下载量有多少?

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

@aphrody/runtime-sdk 还在维护吗?

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