# @agenticprimitives/edge-cloudflare 中文文档

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

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

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

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

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

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

## 中文简介

Cloudflare 适配器,用于 @ agenticprimitives/redge-runtime: request-Admission request 提取(精确字节保存),作为软调压器捆绑的工人速率限制器,以及 Service-Binding 调度. 导入平台运行时间; 边缘核心从不 doe

## 安装

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

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

## README

# @ agenticprimitives/ edge- cloudflare (英语)

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

Cloudflare 适应器 [`@agenticprimitives/edge-runtime`](https://npmcn.com/package/%40agenticprimitives/edge-runtime) (第288节)。 它地图 平台运行时间进入供应商中立准入核心——没有权限 (单位:千美元)[ADR-0043 (英语)](https://npmcn.com/package/docs/architecture/decisions/0043-edge-owns-admission-never-authority.md)) (中文(简体) ).

## API 密码

-   **`extractAdmissionRequest(request): Promise<ExtractedRequest>`** —— 说 `{ admission, rawBody }`。读取 一次尸体; `admission` 种子 `runAdmission`, (中文(简体) ), `rawBody` 是前进到下游的精确矩阵 (字形相同——原生管重接为 第287道.
-   **`createCloudflareRateLimiter(binding): SoftRateLimiter`** - 包装 `env.<NAME>.limit({ key })` 页:1 阶段一虐待限制(倒软,不透明桶).
-   **`dispatchToBinding(fetcher, init): Promise<Response>`** 向约束方转交已受理的请求 来源( 来源)`env.MCP` 编号 : `env.A2A`以坚固的、坚固的、 `x-correlation-id`。 。 。 .

## 用法(在工人中)

```ts
import { extractAdmissionRequest, createCloudflareRateLimiter, dispatchToBinding } from '@agenticprimitives/edge-cloudflare';
import { runAdmission } from '@agenticprimitives/edge-runtime';

const { admission, rawBody } = await extractAdmissionRequest(request);
const result = await runAdmission(admission, {
  resolveRoute,                                   // app catalog → SurfaceDescriptor
  softLimiter: createCloudflareRateLimiter(env.EDGE_LIMITER),
});
if (!result.ok) return new Response('admission denied', { status: result.status });
return dispatchToBinding(env.MCP, {
  url: request.url, method: admission.method, headers: result.headers,
  correlationId: result.correlationId, rawBody,
});
```

具体主机名+服务线名在部署的工人(`apps/demo-edge`从来没有在这里 (ADR-0021) (英语). 下游发源地仍然运行着完整的Web3权威管线——边缘只承认+穿梭.

## 常见问题

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

Cloudflare 适配器,用于 @ agenticprimitives/redge-runtime: request-Admission request 提取\(精确字节保存\),作为软调压器捆绑的工人速率限制器,以及 Service-Binding 调度\. 导入平台运行时间; 边缘核心从不 doe

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

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

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

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

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

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

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

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

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

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

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

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