# @absolutejs/agent-exchange-email 中文文档

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

版本：0\.6\.1
npm 元数据更新时间：2026-09-25T22:55:11.556Z
中文译文更新时间：2026-11-09T23:40:47.907Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：48.7 kB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：@absolutejs/agent-exchange \>=0\.5\.0 \<0\.6
- 首次发布：2026-08-26T09:47:04.184Z
- 最新版本发布：2026-09-25T22:55:11.364Z
- 近 30 天下载量：1697（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

用于 @absolutejs/ agent- exchange的定型, 模式盲电子邮件校验码源 .

## 安装

```sh
npm install @absolutejs/agent-exchange-email
```

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

## README

# `@absolutejs/agent-exchange-email`

> 电子邮件一次性代码是无记名证书. 此来源接受 明确 `policy + bearer + purpose-bound` 配置图或 `webauthn-verifier-bound + token-confined-broker + purpose-bound`后者 将供应商证书和检察官办公室的处理限于信任的经纪人,但确实如此 而不是让上游的持证者耐用钓鱼.

这个 `0.5.x` 线条还接受精确、密码输入 `standing-mandate` 具有相同的受约束和有目的要求。 已签署的任务 从未扩展主机拥有的邮箱配置 .

可互换的、决定性的电子邮件源 `@absolutejs/agent-exchange`它使用 `@absolutejs/email/verification` 以找到 一个精确的校验信息, 并将保护值直接返回给代理 交换加密.

Gmail 和 Microsoft Graph 浏览器是安全的 。 IMAP 仅为服务器, 并且是 创建于 `@absolutejs/email/verification/imap` 在经过这里之前.

```bash
bun add @absolutejs/agent-exchange @absolutejs/agent-exchange-email @absolutejs/email
```

```ts
import { createEmailVerificationCodeSource } from "@absolutejs/agent-exchange-email";
import { createGmailVerificationMessageLookup } from "@absolutejs/email/verification";

const source = createEmailVerificationCodeSource({
  lookup: createGmailVerificationMessageLookup({ accountEmail, client: gmail }),
  profiles: [
    {
      bodyMarkers: ["verification code"],
      correlation: { mode: "challenge-text" },
      id: "accounts-example-six-digit-v1",
      operations: ["verification.submit"],
      origins: ["https://accounts.example.com"],
      providers: ["gmail"],
      senderAddresses: ["security@example.com"],
      senderAuthentication: {
        allowedHeaderFromDomains: ["example.com"],
        trustedAuthservIds: ["mx.mailbox.example"],
      },
      subjectIncludesAny: ["sign in"],
    },
  ],
  resolveAccountEmail: (request) =>
    mailboxDirectory.get(request.resource.accountRef),
});
```

过 `source` 改为 `createAgentExchangeSender`不要把它登记为MCP, A2A, 显示或一般代理工具。 来源故意不返回字符串 API; Agent Exchange加密其可变字节结果,并在交付后清除.

## 规则失效

-   仅 `tool-confined`,单用, `email-one-time-code` 接受请求.
-   请求的精确提供者 HTTPS 来源和操作必须精确选择 一个简介.
-   `challenge-text` 相关性是默认安全配置模式:请求 `challengeId` 必须在选定的信件正文中准确出现.
-   `temporal-only` 配置文件既需要明确的配置模式,也需要 `allowTemporalOnlyCorrelation: true`; 仅在一个 上游电子邮件无法响应挑战 .
-   可见的发件人必须有一个完全对齐的 DMARC 密码从配置, 信箱委托的RFC 8601 `authserv-id`。 。 。 .
-   邮箱账户引用通过主机拥有的目录解决 从未被假定为电子邮件地址.
-   默认的搜索窗口在机构请求前30秒开始并结束 (a) 执行时间或请求到期时间较早。 未来的时钟定是 明确启用.
-   多个信件,多个标记绑定代码, 不信任的发送者, stille mail, 找错人了 找错人了 都安全了 `source_failed` 错误.

电子邮件检察官办公室仍然是无记名证书,不耐打网球。 偏爱 授权、密码、服务账户或提供者授权的行动 也许吧.

此发布使用 email 6.6.0 表示 `standalone-after-marker` 代码布局 并保留了 HTML 块边界。 保留现有的直接标记简介 他们的行为。 仅限时间的关联性仍需明确选择加入,而且是否 无法在提供者电子邮件和浏览器会话之间证明加密绑定; 呼叫者必须将尝试序列化,并将目的地分开.

`selection: "newest"` (与 `@absolutejs/email` 0.7)使用最新数据 发件人认证匹配,而不是在多个消息匹配时失败,以及 允许 `maxLookbackMs` 最多24小时 这是用来 `temporal-only` 服务 邮箱所有者选择的邮件中 "使用最新代码". 默认 `unique` 选择保留两分钟的上限.

`createEmailVerificationCodeSource` 接受可选选项 `onFailure` 观察员. 它只得到一个固定类别(`no_match`, (中文(简体) ), `ambiguous_match`, (中文(简体) ), `candidate_limit`, (中文(简体) ), `invalid_profile`, (中文(简体) ), `lookup_failed`,或 `source_rejected`) (中文(简体) ). 它从未收到 被捕获的例外,代码,消息正文,提供者响应,或源证据. 观察失败被忽略,检索继续失败被关闭. 主机可能 记录这些类别进行手术诊断,而不透露秘密.

## 常见问题

### @absolutejs/agent-exchange-email 是什么？

用于 @absolutejs/ agent- exchange的定型, 模式盲电子邮件校验码源 \.

### 如何安装 @absolutejs/agent-exchange-email？

在项目目录运行 npm install @absolutejs/agent-exchange-email，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@absolutejs/agent-exchange（\>=0\.5\.0 \<0\.6）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @absolutejs/agent-exchange-email 支持 TypeScript 吗？

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

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

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

### @absolutejs/agent-exchange-email 可以商用吗？

@absolutejs/agent-exchange-email 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

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

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

### @absolutejs/agent-exchange-email 还在维护吗？

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