# @absolutejs/agent 中文文档

规范地址：https://npmcn.com/package/%40absolutejs/agent/

版本：0\.37\.0
npm 元数据更新时间：2026-10-20T23:44:26.259Z
中文译文更新时间：2026-11-08T02:41:51.985Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：180 kB，75 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：18 个
- peer 依赖：drizzle-orm \>=1\.0\.0-rc\.4 \<2，@absolutejs/auth \>=0\.57\.6 \<1，@absolutejs/execution \>=0\.14\.10 \<0\.15
- 首次发布：2026-07-16T04:27:08.092Z
- 最新版本发布：2026-10-20T23:44:26.061Z
- 近 30 天下载量：1927（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：110（近 12 个月 110 个）

## 中文简介

绝对JS的生产级,提供者中立的代理堆:认证,动作,运行时间,沙箱,信任,内存,收件箱,发现,MCP,A2A,政策,钱包限制,控制,以及符合性.

## 安装

```sh
npm install @absolutejs/agent
```

也可以使用：`pnpm add @absolutejs/agent`、`yarn add @absolutejs/agent`、`bun add @absolutejs/agent`

## README

# @absolutejs/代理服务器

绝对JS的生产级,提供者中立的代理堆栈.

这是一致的切入点,而不是另一个代理运行时间。 每个引擎都留下了 可独立安装和可替换; 此软件包提供了一个文件 黄金路径、打出子路径出口、生产准备状态检查和 绝对JS 显示可以让编码代理发现整个堆栈.

外观是机构运行时间的单机主. A2A,MCP,代理控制,钱包, 并宣布机构为所需同行,将其外部化 测试一个保守的相容性窗口。 表面安装 匹配真实的代理依赖,所以一个应用程序无法默默创建 平行动作类型或分类账.

```ts
import { assertProductionReady, defineAgentStack } from "@absolutejs/agent";
import { createAgentRuntime } from "@absolutejs/agent/runtime";
import { createAgency } from "@absolutejs/agent/actions";

const stack = defineAgentStack([
  { capability: "durability", instance: runtime, name: "runtime" },
  { capability: "authorization", instance: agency, name: "actions" },
] as const);

await assertProductionReady(stack); // fails until every production concern is wired
```

## 稳定的子路径

-   `@absolutejs/agent/auth` - 土著授权登记、ID-JAG、范围广泛的代表团
-   `@absolutejs/agent/actions` 最终批准/拒绝、租赁、收据、, 杀死开关, 交接
-   `@absolutejs/agent/runtime` 持久运行、检查站、预算、影响
-   `@absolutejs/agent/sandbox` 逐一拒绝 HTTP、文件系统和处理赠款
-   `@absolutejs/agent/trust` 出处、刺眼传播、安全背景和汇
-   `@absolutejs/agent/memory` ——有范围,有授权,有可消除的可持久记忆
-   `@absolutejs/agent/inbox` ——已核实的网约车,时刻表,回覆,死信
-   `@absolutejs/agent/discovery` 签字的知名文件、卡片、文本、站点地图、登记册
-   `@absolutejs/agent/execution` ——经认证的租户适配装置,交易发货箱,回盘,签名的供应商证据摄取,调节,补偿
-   `@absolutejs/agent/exchange` ——实验性,型号盲敏感值交换,明确一次性或签定常备授权批准,单用途租赁,认证E2EE,再玩防守,撤销,并重编收据
-   `@absolutejs/agent/mcp`, (中文(简体) ), `/a2a`, (中文(简体) ), `/arazzo`,以及 `/webmcp` ——开放互操作性,工作流程和浏览器传输
-   `@absolutejs/agent/policy` 版本政策和AuthZEN适配器
-   `@absolutejs/agent/wallet` ——保留地,一权解决地,支出政策
-   `@absolutejs/agent/control` ——操作员盘点,撤销,恢复,关闭开关
-   `@absolutejs/agent/conformance` - 对抗协议和诉讼套间

软件包故意不引入绝对唯一的电线协议. 应用暴露了标准MCP、A2A、OAuth、RFC 9728/RFC 8414、auth.md以及 AuthZEN表面,而绝对供应供应商-中性执行接合.

`/auth.md` 是打开的 auth.md 注册配置文件的常规发现 路线。 绝对 Auth 从应用程序的权威 OAuth 生成它 元数据并本地执行流量; 它不是 WorkOS 适配器,而是 不需要WorkOS服务.

## 一个经认证的代表团

`createAuthAgencyDelegationAuthority()` 代表团已经核实的桥梁 由绝对 Auth 直接进入机构。 放一个 `authAgencyAuthorizationDetail()` 以真主所赐予他的恩典盟誓, canonical action, effect, 资源类型, 和可选资源ID. 机构 然后在诉讼请求、租赁和执行之前重新阅读同样的赠款; 没有第二次授权ID或阴影状态可以同步.

## 常见问题

### @absolutejs/agent 是什么？

绝对JS的生产级,提供者中立的代理堆:认证,动作,运行时间,沙箱,信任,内存,收件箱,发现,MCP,A2A,政策,钱包限制,控制,以及符合性\.

### 如何安装 @absolutejs/agent？

在项目目录运行 npm install @absolutejs/agent，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：drizzle-orm（\>=1\.0\.0-rc\.4 \<2）、@absolutejs/auth（\>=0\.57\.6 \<1）、@absolutejs/execution（\>=0\.14\.10 \<0\.15）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @absolutejs/agent 支持 TypeScript 吗？

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

### @absolutejs/agent 支持 ESM 还是 CommonJS？

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

### @absolutejs/agent 可以商用吗？

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

### @absolutejs/agent 的下载量有多少？

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

### @absolutejs/agent 还在维护吗？

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