# @aragon-agent/core 中文文档

规范地址：https://npmcn.com/package/%40aragon-agent/core/

版本：0\.2\.67
npm 元数据更新时间：2026-11-06T06:30:37.368Z
中文译文更新时间：2026-11-06T13:28:16.194Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aragon-agent/core
原文对照：https://npmcn.com/package/%40aragon-agent/core/?lang=original
项目主页：https://github.com/xdrshjr/AragonAgent#readme
源码仓库：https://github.com/xdrshjr/AragonAgent

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

- 包体积（解压后）：557 kB，98 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-07-27T02:06:36.126Z
- 最新版本发布：2026-11-06T06:30:37.146Z
- 近 30 天下载量：6643（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：66（近 12 个月 66 个）

## 中文简介

AragonAgent核心引擎 — LLM 提供者适配器,流线,工具注册/执行,方向盘,闲置的监视器,以及可选的孤立-vm sandbox.

## 安装

```sh
npm install @aragon-agent/core
```

也可以使用：`pnpm add @aragon-agent/core`、`yarn add @aragon-agent/core`、`bun add @aragon-agent/core`

## README

# @ aragon- agent/ core (韩语)

可出版的 **阿拉贡代理公司** 引擎: 零对接, 依赖性注入 TypeScript代理运行时间 .

## 所需资源

-   **节点.js 18** 引擎依赖于全球 `fetch` 编号 : `AbortController` 被建入18+节点.
-   **仅限无害环境管理** ——本包船为原生ES模块(`"type": "module"`) (中文(简体) ). 假设它与 `import`这不可能 `require()`\- 从普通JS.
-   **可选本地道具** —— 说 `ajv` 财务报告和审定财务报表 `isolated-vm` 为: `optionalDependencies`数字 : 软件包没有它们(使用了内置验证器倒置,并且 沙盒模块是懒载的). 安装 `isolated-vm` 只有使用 `@aragon-agent/core/sandbox/*` 代码代理沙盒.

## 安装

```bash
npm install @aragon-agent/core
# optional — only if you use the isolated-vm CodeAct sandbox:
npm install isolated-vm
```

`ajv` 财务报告和审定财务报表 `isolated-vm` 为: **可选依赖关系**数字 :

-   `ajv` ——工具参数校验器在出现时使用;内置倒计时 验证符以其他方式使用.
-   `isolated-vm` ——仅供 `@aragon-agent/core/sandbox/*` 模块,其中 懒惰并从未从包根导入(`isolated-vm` 实值 与Electron's等一些嵌入式V8运行时不相容.

## 使用量

```ts
import { AragonAgent, getProviderRegistry, initProviders } from '@aragon-agent/core';

initProviders();

const agent = new AragonAgent({
  systemPrompt: 'You are a coding agent.',
  model: { providerId: 'anthropic', modelId: 'claude-...', baseUrl: '...' },
  tools: [],
  providerRegistry: getProviderRegistry(),
  getApiKey: () => process.env.ANTHROPIC_API_KEY,
});

await agent.prompt('Hello');
```

`AragonAgent` 是引擎的别名 `Agent` 课.

此片段的完整, 类型检查过的版本( 假工具 + 提供者设置)

-   代理人建造) [`examples/minimal.ts`](https://npmcn.com/package/%40aragon-agent/core/examples/minimal.ts)。 。 。 . 它只是编译( 从未点击过网络) , 也不属于已发布的 柏油弹.

## 入境点

| 导入路径 | 目录 |
| --- | --- |
| `@aragon-agent/core` | 全管(引擎,LLM,工具,类型). |
| `@aragon-agent/core/llm/types` | LLM 消息 / 流出/ 模型类型 . |
| `@aragon-agent/core/llm/providers` | 供应商登记册+ `streamLLM`编号 :`completeLLM`。 。 。 . |
| `@aragon-agent/core/tools/types` | 工具系统类型. |
| `@aragon-agent/core/tools/helpers` | `textResult` 编号 : `errorResult` 编号 : `defineTool`。 。 。 . |
| `@aragon-agent/core/sandbox/*` | 可选的隔离-vm 代码 Act sandbox. |

## 构建

```bash
npm run build   # tsc → dist/*.js + *.d.ts
npm test        # vitest (smoke + public-api contract + no-host-coupling guard)
```

## 核查再利用

`npm test` 财务报告和审定财务报表 `examples/minimal.ts` 只证明软件包 **编译**改为: 证明已建 `dist/` 其实是 **运行** 外部消费者:

```bash
npm run verify:dist   # build dist/, then run examples/consumer-smoke/run.mjs
```

`run.mjs` 导入此软件包 **名称** (单位:千美元)`@aragon-agent/core`)通过 节点的 _软件包自引用_,所以节点解决它通过 `package.json#exports` → `./dist/index.js` 一样 `(exports map + NodeNext + .js extension)` 外部工程路径 `npm install @aragon-agent/core` 点击量, **无** 将软件包放入 `node_modules`输入离线 stub LLM 供应商, 运行一个 `AragonAgent.prompt()` 转向端到端(零网络), 并声称 `exports` 子路径在运行时全部解析 。 成功打印 `[consumer-smoke] OK`。 。 。 .

对于毫不含糊的"另一个工程安装并再利用它"检查(它也) 覆盖运行 **无** 选项 `ajv` 编号 : `isolated-vm` 道士,请看 包入新项目黄金核查 [`examples/consumer-smoke/README.md`](https://npmcn.com/package/%40aragon-agent/core/examples/consumer-smoke/README.md)。 。 。 .

运行时间 公共- API 表面被冻结 `src/__tests__/public-api.test.ts` 并记录了人类在 [`API.md`](https://npmcn.com/package/%40aragon-agent/core/API.md)页:1 `no-host-coupling` 测试 使套件免去主机-repo进口和遗留品牌泄漏.

## 出版

此软件包会发布到 npm 的公众登记册中. 运行发行 **软件包目录** 因此软件包级别 `prepublishOnly` 钩火和一 新鲜 `dist/` 构建 :

```bash
cd packages/core
npm run build                 # produce dist/
npm pack --dry-run --json     # inspect the tarball file list (no upload)
npm publish                   # publishConfig.access:"public" is baked in
```

(从 repo 根可以等量运行) `npm publish -w packages/core`. ) (中文(简体) )

注释:

-   **`publishConfig.access` 设置为 `"public"`**,所以没有 `--access public` 旗帜 要不然,范围化包将默认为有限/私人包.
    
-   **出版账户必须拥有 `@aragon-agent` npm 范围/org** 在此之前 第一次发表。 纵然如此 `access:"public"`,在您范围内发布 403/404没有失败。 创建 `@aragon-agent` 在npmjs(或 切换到您的账户所拥有的范围,并相应重命名软件包.
    
-   **`files` 是负载的白名单.** 归宿 `.gitignore` 忽略 `dist/`不过npm的 `files: ["dist", "CHANGELOG.md"]` 优先和 运出已建的输出。 不要"简化" `files` 字段,或 已公布的柏油球将空出 . `npm pack --dry-run --json` 应该永远 列表 `dist/index.js`。 。 。 .
    
-   仓库元数据指向 `https://github.com/xdrshjr/AragonAgent`。 。 。 .
    
    如果寄存器移动, 使用帮助脚本或更新 `repository` 编号 : `homepage` 编号 : `bugs` 发布前:
    
    ```bash
    node scripts/stamp-org.mjs <org>     # or: ARAGON_REPO_ORG=<org> node scripts/stamp-org.mjs
    node scripts/check-publishable.mjs   # exits non-zero if the placeholder remains in package.json
    ```
    
    `prepublishOnly` 运行 `check-publishable.mjs` 在建筑之前,任何出版 使用未标记的占位符的尝试是自动被硬锁的.
    

## 许可证

麻省理工学院.

## 常见问题

### @aragon-agent/core 是什么？

AragonAgent核心引擎 — LLM 提供者适配器,流线,工具注册/执行,方向盘,闲置的监视器,以及可选的孤立-vm sandbox\.

### 如何安装 @aragon-agent/core？

在项目目录运行 npm install @aragon-agent/core，或使用 pnpm add / yarn add / bun add。

### @aragon-agent/core 支持 TypeScript 吗？

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

### @aragon-agent/core 支持 ESM 还是 CommonJS？

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

### @aragon-agent/core 需要什么版本的 Node\.js？

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

### @aragon-agent/core 可以商用吗？

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

### @aragon-agent/core 的下载量有多少？

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

### @aragon-agent/core 还在维护吗？

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