# @agenticprimitives/edge-runtime 中文文档

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

版本：0\.0\.0-alpha\.22
npm 元数据更新时间：2026-10-26T11:07:55.950Z
中文译文更新时间：2026-11-06T11:49:58.701Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：63.1 kB，32 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@agenticprimitives/types ^1\.0\.0-alpha\.45，@agenticprimitives/rate-control ^0\.0\.0-alpha\.5，@agenticprimitives/surface-catalog ^0\.0\.0-alpha\.5
- 首次发布：2026-07-01T10:44:32.446Z
- 最新版本发布：2026-10-26T11:07:55.622Z
- 近 30 天下载量：3356（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

供应商中立边缘接收层:EdgeAdapter接口、可信任的负责人个人卫生、GatewayAsservation 核查端口和接收管道(路线分辨率+大小/深度/信封+阶段-1滥用限制)。 只收监,不收监

## 安装

```sh
npm install @agenticprimitives/edge-runtime
```

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

## README

# @ agenticprimitives/ edge- runtime (英语)

> 部分 **[代理先导](https://agenticprimitives.dev/)** ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. [开发者工具包](https://github.com/agentictrustlabs/agentic-primitives) • 妇女 [所有软件包](https://agenticprimitives.dev/developers)

供应商中立 **边框录入** 层。 边缘是唯一的公表; 它承认或拒绝 低价请求,然后转发到服务捆绑后面的 A2A/MCP 源头。 它只拥有录取权—— 这个 **永远** 拥有权威(授权、撤销、应享权利、KAS、签名、解密) 绑定, 绝不在此导入.. [ADR-0043 (英语)](https://npmcn.com/package/docs/architecture/decisions/0043-edge-owns-admission-never-authority.md)) (中文(简体) ).

见 [第288区](https://npmcn.com/package/specs/288-agentic-edge-admission-and-surface-catalog.md) 第4节.

## 盒子里有什么(W1)

-   **`EdgeAdapter`** – 接口 Cloudflare / Zuplo / API 盾牌执行. 招生协议 当网关出现时,不会改变.
-   **受托负责人的卫生** —— 说 `TRUSTED_HEADERS` + 键 `sanitizeTrustedHeaders(headers, { authenticated })` 条形内页眉`x-agent-subdomain`, (中文(简体) ), `x-agentic-principal`,... 从一个未经认证的来电 所以 他们不能被骗.
-   **`GatewayAssertion` 验证端口** —— 说 `verifyGatewayAssertion(...)` 证明,发行人-不可知论, 一个网关为这条路由接受了这些精确的字节。 它证明只承认 从来没有SA (当地管道仍然这样做)。 签名检查被注入, 所以默认 发行商和未来的祖普洛车道是同一个代码路径.
-   **录取管道** —— 说 `runAdmission(req, opts)`: 解析路径(从 a `surface-catalog`页:1 · 防止滥用 `rate-control` `SoftRateLimiter`, (中文(简体) ), **失败软**) 关联d.

```ts
import { runAdmission } from '@agenticprimitives/edge-runtime';

const result = await runAdmission(extractedRequest, {
  resolveRoute: (r) => registry.get(routeToId(r.path)),
  softLimiter,                       // from @agenticprimitives/rate-control (fail-soft)
  authenticated: false,              // direct public caller → strip trusted headers
});
if (!result.ok) return reject(result.status);   // single generic error; reason is internal-only
forwardToOrigin(result.descriptor, result.headers, result.correlationId);  // origin still validates authoritatively
```

## 没有在核心

-   Cloudflare适配器(工人费率限制器装订,服务-宾丁调度, `cf-connecting-ip`和 部署人员 `agentic-edge` 工人——单独出船(第288段);生产边缘是外部的 (单位:千美元)[ADR-0037 (英语)](https://npmcn.com/package/docs/architecture/decisions/0037-primitives-pure-repo-external-integration-and-ux-layers.md)) (中文(简体) ).
-   任何权威逻辑——禁止进口;通过服务约束达成.

## 许可证

麻省理工学院

## 常见问题

### @agenticprimitives/edge-runtime 是什么？

供应商中立边缘接收层:EdgeAdapter接口、可信任的负责人个人卫生、GatewayAsservation 核查端口和接收管道\(路线分辨率\+大小/深度/信封\+阶段-1滥用限制\)。 只收监,不收监

### 如何安装 @agenticprimitives/edge-runtime？

在项目目录运行 npm install @agenticprimitives/edge-runtime，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@agenticprimitives/types（^1\.0\.0-alpha\.45）、@agenticprimitives/rate-control（^0\.0\.0-alpha\.5）、@agenticprimitives/surface-catalog（^0\.0\.0-alpha\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agenticprimitives/edge-runtime 支持 TypeScript 吗？

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

### @agenticprimitives/edge-runtime 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/edge-runtime 可以商用吗？

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

### @agenticprimitives/edge-runtime 的下载量有多少？

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

### @agenticprimitives/edge-runtime 还在维护吗？

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