# @aphrody/runtime-sdk 中文文档

规范地址：https://npmcn.com/package/%40aphrody/runtime-sdk/

版本：1\.4\.7
npm 元数据更新时间：2026-10-23T03:51:32.506Z
中文译文更新时间：2026-11-06T09:35:44.368Z
软件包许可：MIT AND Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aphrody/runtime-sdk
原文对照：https://npmcn.com/package/%40aphrody/runtime-sdk/?lang=original
源码仓库：https://github.com/aphrody-labs/aphrody

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：127 kB，21 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-10-05T07:54:20.847Z
- 最新版本发布：2026-10-23T03:51:32.310Z
- 近 30 天下载量：4953（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

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

## 安装

```sh
npm install @aphrody/runtime-sdk
```

也可以使用：`pnpm add @aphrody/runtime-sdk`、`yarn add @aphrody/runtime-sdk`、`bun add @aphrody/runtime-sdk`

## README

# @ aphrody/ runtime- sdk

YOLO 本地运行时间的 Light TypeScript SDK : 加载已预编的 `yolo_runtime` 库通过 其版本为 C ABI 的 `bun:ffi`核心模块 `runtime:system` 财务报告和审定财务报表 `runtime:process`· ; 可选客户端是 `runtime:desktop` 财务报告和审定财务报表 `runtime:browser`。 。 。 . 这里没有编译一个引擎 。 见仓库的 [运行时间 ABI](https://npmcn.com/package/docs/aphrody/architecture/runtime-native/RUNTIME-ABI.md) 财务报告和审定财务报表 [运行时间决定](https://npmcn.com/package/docs/aphrody/decisions/runtime/DECISIONS.md)。 。 。 .

```ts
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诊断尾.

```ts
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 是什么？

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 和提交记录判断。