# @aparte/engine 中文文档

规范地址：https://npmcn.com/package/%40aparte/engine/

版本：0\.32\.1
npm 元数据更新时间：2026-11-02T11:25:17.307Z
中文译文更新时间：2026-11-06T08:55:51.792Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aparte/engine
原文对照：https://npmcn.com/package/%40aparte/engine/?lang=original
项目主页：https://apartejs.dev/reference/engine/
源码仓库：https://github.com/apartejs/aparte

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

- 包体积（解压后）：125 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-07-23T17:54:03.858Z
- 最新版本发布：2026-11-02T11:25:16.977Z
- 近 30 天下载量：10190（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：65（近 12 个月 65 个）

## 中文简介

代理环路本身:运行Stream Agent流出一个模型的转动并运行其工具,在浏览器或节点中——零运行时间依赖.

## 安装

```sh
npm install @aparte/engine
```

也可以使用：`pnpm add @aparte/engine`、`yarn add @aparte/engine`、`bun add @aparte/engine`

## README

# @ aparte/ 引擎

这个 **无头代理循环** 后面 `@aparte/*` ——框架不可知,零运行时间 依赖,在浏览器或节点中运行.

```bash
npm install @aparte/engine @aparte/core
```

`@aparte/core` 实值 **非依赖性** 核心取决于引擎。 为下面推荐的路径安装核心 .

```ts
import { AparteClient } from '@aparte/core';

// Nothing to inject: the client runs this package's loop and renders its events.
new AparteClient().start();
```

它的核心出口是 **`runStreamAgent`**: 无 DOM 结构化流回路, 转动为 运算符流进入高级运行事件(文本、思维、工具呼叫), 驱动工具调用循环(带有可选的"人入"审批),以及报告使用.

`@aparte/core` 默认运行此回路 — 它曾经嵌入其复制件 两份是平等套房的; 复制本不见了, 套房现在生活在核心 循环的调用序列被固定为快照. `AparteClientOptions.streamRunner` 实值 把它接上`(opts) => runStreamAgent({ ...opts, onHistoryAppend })` 为东道主服务 或用你自己发出同样事件的循环来代替.

`@aparte/core` 这里不需要.. `runStreamAgent` 而分析者们却从中不从中导入任何东西. 对话收缩(上下文预算、选择者、总结者)是 `@aparte/plugin-compaction`,而不是引擎:循环报告使用量,让呼叫者决定.

## 拥有历史( 前缀- 缓存主机)

默认情况下, 循环会保留信件列表, 并每转一转就重新发送, 用助手来丰富 转身,带着电话和 `tool` 把答案都转过来 这是正确的 无国籍消息 API, 错误的 **前缀缓存** – lama.cpp slots, vLLM- 其中转会N+1 必须 _扩展_ 将 N 字节转换为字节, 否则缓存会被丢弃 .

这样的宿主拥有自己的笔录. 它已经控制了请求`transportCall` 接收 已建请求并可能忽略 `request.messages`(三); `onHistoryAppend` 另一半是... . . 它报告每个循环附件, 顺序,在调用之前 不要重新执行循环的工具簿记:

```ts
const log = new PromptLog();                       // your append-only transcript

await runStreamAgent({
  ...loopOptions,                                     // messageId, emitter, signal, toolLookup
  baseRequest: { messages: [], modelId: 'my-model' }, // your transport may ignore both
  onHistoryAppend: (turn) => log.append(turn),     // the calls · each result · each reply
  transportCall: () => myCompletion(log.render()), // your own bytes, extended not rebuilt
});
```

提醒一下,这个例子被掩盖了: 助手转弯的瞬间被报告 **第一个** 调用 完成, 并两者 `content` 联 合 国 `toolCalls` 稍后在同一回合中完成。 一个日志 在收件时写字节 `PromptLog` 因此,必须持有对象并重新阅读 在序列化之前, 或附加助手只转一次 `tool` 消息已经 来了 在收货时拍到的快照 失去了那个助手在电话前说的句子 任何东西.

通过核心接合将其接上不需要核心变化——在注入时增加选项:

```ts
new AparteClient({ streamRunner: (opts) => runStreamAgent({ ...opts, onHistoryAppend }) });
```

将工具目录/调用/结果序列化为原始的提示仍然由您撰写: 以基于消息的 API 为对象的提供者 .

> 部分 [独立](https://github.com/apartejs/aparte) 单相机 仅限无害环境管理.

## 常见问题

### @aparte/engine 是什么？

代理环路本身:运行Stream Agent流出一个模型的转动并运行其工具,在浏览器或节点中——零运行时间依赖\.

### 如何安装 @aparte/engine？

在项目目录运行 npm install @aparte/engine，或使用 pnpm add / yarn add / bun add。

### @aparte/engine 支持 TypeScript 吗？

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

### @aparte/engine 支持 ESM 还是 CommonJS？

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

### @aparte/engine 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aparte/engine 可以商用吗？

@aparte/engine 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aparte/engine 的下载量有多少？

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

### @aparte/engine 还在维护吗？

最新版本 0\.32\.1 发布于 2026/11/02（4 天前）；至今共发布 65 个版本，其中过去 12 个月发布了 65 个；首次发布于 2026/07/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。