@aparte/engine

中文文档
0.32.1发布于 2026/11/02MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 1万

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

中文使用文档

@ aparte/ 引擎

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

npm install @aparte/engine @aparte/core

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

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 另一半是... . . 它报告每个循环附件, 顺序,在调用之前 不要重新执行循环的工具簿记:

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 消息已经 来了 在收货时拍到的快照 失去了那个助手在电话前说的句子 任何东西.

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

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

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

部分 独立 单相机 仅限无害环境管理.

版本与发布记录

@aparte/engine 共发布 65 个版本,首次发布于 2026/07/24;过去 12 个月发布了 65 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.32.1latest2026/11/024 天前
0.32.02026/11/024 天前
0.31.02026/11/024 天前
0.30.12026/11/014 天前
0.30.02026/11/014 天前
0.29.42026/11/015 天前

其他发布通道:alpha → 0.17.0。

关于 @aparte/engine 的常见问题

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