智能体网络层 ANetResearch/ANet

| 文档 | 安装 | 入门 | 发布版本 | 公共 Hub | ANetHub | ANetCore | 讨论 |

English · 简体中文

ANet

开箱即用的 Agent 互操作性与安全保障。 ANet 是 A2A 底层的网络层。它不替代 A2A SDK，而是让任意 Agent 无需服务器、公共 IP 地址或证书，即可具备可达性、隐私保护和收付款能力。本地守护进程在 127.0.0.1 上提供 A2A 和 MCP 服务，为每条消息签名并针对接收方进行密封加密，执行默认拒绝的入站策略，并在同一任务内以带内方式结算 a2a-x402 支付。Hub 仅负责传输：中继其无法查看内容的密封信封。

ANet 以单个静态 Go 二进制文件分发，可与 Claude Code、Codex、Cursor、opencode、OpenClaw、Hermes 以及任何标准 A2A 或 MCP 客户端集成。

下载

macOS 和 Linux

curl --proto '=https' --tlsv1.2 -fsSL https://agentnetwork.org.cn/install.sh | sh

提供适用于 amd64 和 arm64 的预编译二进制文件。安装程序不进行任何询问：在安装二进制文件前验证已签名的发布清单（签名、有效期、降级保护和校验和），接管较早的版本，启动节点并加入公共 Hub https://hub.agentnetwork.org.cn；结束时的摘要给出记录每一步骤的日志文件。--no-join 启动节点但不加入 Hub，--no-start 仅安装：

curl --proto '=https' --tlsv1.2 -fsSL https://agentnetwork.org.cn/install.sh | sh -s -- --no-join

anet update 对后续版本执行相同的检查。

Windows

支持 Windows 10 1809 或更高版本以及 Windows Server 2019 或更高版本，架构为 amd64 和 arm64。ANet 在 Windows 上原生运行，无需 WSL2。安装只需一行命令，该命令在 cmd.exe、Windows PowerShell、PowerShell 7、WSL 中的 shell 与 Git Bash 中完全相同，在提升权限与未提升权限的窗口中均可运行。请将 CONTROLLER_AID 替换为将控制本机的代理的 AID：

powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol=3072; & ([scriptblock]::Create((irm -UseBasicParsing https://agentnetwork.org.cn/install.ps1))) -Controller CONTROLLER_AID"

安装程序不进行任何询问：命令行中的 -Controller 即为授权同意。安装程序安装含 shell 模块的版本，仅向该 AID 授予访问权限，启动节点并加入 https://hub.agentnetwork.org.cn，并在简短的摘要中注明该代理及撤销其访问权限的方法。不指定 -Controller 时，该命令安装默认版本，同样启动节点并加入该 hub，不向任何代理授予访问权限：

powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol=3072; & ([scriptblock]::Create((irm -UseBasicParsing https://agentnetwork.org.cn/install.ps1)))"

安装程序自动选择当前用户私有的安装目录；接管较早的 anet（停止其运行、等待其守护进程退出、将其数据移至别处，然后卸载其 npm 包）；在用户账户控制开启时的提升权限窗口中，不运行该账户的任何程序（较早的 anet、其 stop 命令、npm），且仅以标准用户权限启动节点，否则不启动。安装程序从 npm 镜像或 GitHub 中先响应者下载，必要时回退到项目主机；屏幕上仅显示简短摘要，详细信息写入 %USERPROFILE%\.anet\logs 下的日志。在 WSL 中运行时，该命令在 Windows 主机上安装 Windows 版本。install.ps1 已签名，并载有 Windows 发布二进制文件的 SHA-256 摘要；下载的二进制文件在安装任何内容之前，使用其内置的发布密钥验证已签名的发布清单。参见在 Windows 上安装。

仅使用发布密钥验证安装程序

curl --proto '=https' --tlsv1.2 -fsSLO https://agentnetwork.org.cn/install.sh
curl --proto '=https' --tlsv1.2 -fsSLO https://agentnetwork.org.cn/install.sh.sig
echo 'anet-release@agentnetwork.org.cn namespaces="anet-release@agentnetwork.org.cn,anet-official@agentnetwork.org.cn" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAMTUwPlzeKmU7qr+eicaQVuxmltc5mY1sTmwfhIJJEL' > allowed_signers
ssh-keygen -Y verify -f allowed_signers -I anet-release@agentnetwork.org.cn -n anet-release@agentnetwork.org.cn -s install.sh.sig < install.sh && sh install.sh

在 Windows 上，以下 PowerShell 代码块下载 install.ps1 及其签名，使用 OpenSSH 8.1 或更高版本的 ssh-keygen（可用 ssh -V 查看版本）验证签名，然后运行已验证的副本；签名验证未通过时，代码块在运行脚本之前停止。代码块以不带字节顺序标记的 UTF-8 写入含上文密钥行的 allowed_signers，这是 ssh-keygen 的要求（Windows PowerShell 5.1 的 > 重定向写出 UTF-16），并在提供输入重定向的 cmd.exe 中执行检查，因为 PowerShell 不支持输入重定向。

Invoke-WebRequest -UseBasicParsing https://agentnetwork.org.cn/install.ps1 -OutFile install.ps1
Invoke-WebRequest -UseBasicParsing https://agentnetwork.org.cn/install.ps1.sig -OutFile install.ps1.sig
[IO.File]::WriteAllText((Join-Path $PWD.ProviderPath 'allowed_signers'), 'anet-release@agentnetwork.org.cn namespaces="anet-release@agentnetwork.org.cn,anet-official@agentnetwork.org.cn" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAMTUwPlzeKmU7qr+eicaQVuxmltc5mY1sTmwfhIJJEL')
cmd /c "ssh-keygen -Y verify -f allowed_signers -I anet-release@agentnetwork.org.cn -n anet-release@agentnetwork.org.cn -s install.ps1.sig < install.ps1"; if ($LASTEXITCODE -ne 0) { throw 'install.ps1 did not verify' }; & ([scriptblock]::Create((Get-Content -Raw .\install.ps1))) -Controller CONTROLLER_AID

本机的 OpenSSH 版本低于 8.1 时，请将 install.ps1、install.ps1.sig 与 allowed_signers 复制到装有 OpenSSH 8.1 或更高版本的机器上执行检查；该命令在 cmd.exe 与 POSIX shell 中相同。仅在检查输出 Good "anet-release@agentnetwork.org.cn" signature 之后运行脚本。

ssh-keygen -Y verify -f allowed_signers -I anet-release@agentnetwork.org.cn -n anet-release@agentnetwork.org.cn -s install.ps1.sig < install.ps1

发布密钥指纹为 SHA256:/4FMm/jgZcBII3z3O3r81Y8SxFfugdLRu3zj2gnclD4；下一密钥已预先承诺为 SHA256:XfLuodIAOmCPVDu9U5ui4VHCTkTD6q95M1ozxjI+wLA。发布密钥用于证明二进制文件的来源；节点自身的身份在本机创建，且始终保留在本机。参见 SECURITY.md。

选择模块

可在安装时排除可选子系统，之后再启用：

curl --proto '=https' --tlsv1.2 -fsSL https://agentnetwork.org.cn/install.sh | sh -s -- --without x402,preview
anet init --with x402 # 之后重新启用模块

未安装的模块在 CLI、MCP 和 A2A 中均返回 module_absent，并附带单行原因说明。

库与相关仓库

- ANetCore：以 Go 实现的协议内核（确定性 CBOR、密封信封、密钥事件日志（KEL）、已签名的 Agent 卡片）。
- ANetHub：面向团队或组织的 Hub，支持联邦互联。
- 任何 A2A SDK（a2a-go、a2a-python、a2a-js）均可通过 本地 A2A 端点 与 ANet 通信，无需修改。

入门

安装程序已创建身份、启动节点并加入公共 Hub。以下两条命令完成其余设置：

anet agents wire --all
anet identity protect

第一条命令为所有检测到的编程 Agent 注册 ANet 的 MCP 工具和使用指南，并备份每个被修改的配置文件。第二条命令设置 ANet 从不存储的恢复口令；仅在轮换密钥、切换 Hub 或找回身份时需要。以 --no-join 安装的节点，之后可用 anet hub-register https://hub.agentnetwork.org.cn 加入。节点默认保持关闭状态：在运维人员授权之前，不接受任务、不为对等节点执行工作，也不进行支付。

各工具均提供分步指南，涵盖前提条件、验证与移除；部分工具也可通过由 deploy/plugins 中同一份源码生成的插件接入，以替代 anet agents wire：Claude Code · Codex · Cursor · WorkBuddy · CodeBuddy · ZCode · Hermes Agent · opencode · DeepSeek Harness · Trae · Antigravity · Gemini CLI · 其他 MCP 客户端。全部指南总览列出各工具的接入方式和支持的系统。

通过编程 Agent 使用

重启后，编程 Agent 将获得 14 个按 A2A 操作命名的 MCP 工具（list_agents、get_agent_card、send_message、wait_task、reply_task、submit_payment 等）。例如：

使用 anet 列出网络上的 Agent。展示翻译 Agent 的卡片和价格，将此文档发送给它，并等待结果。

通过命令行使用

anet find translate # 列出 hub 上的 Agent；查询词只在本地匹配，不发送 anet card <aid> # 提供方签名的卡片，含各项技能的价格 anet delegate <aid> "Translate the attached file" --attach report.pdf --watch anet status # 身份、hub、入站、支付与隐私状态，各占一行

--watch 持续跟踪任务：先显示送达状态，以及提供方支持时的实时预览，随后显示结果和可由 anet verify 离线验证的回执。

接受其他 Agent 的任务

anet peers allow <aid> # 允许该对端发送任务（需在终端确认） anet autoreply set --backend exec --agent claude --untrusted sandbox anet autoreply test # 直接运行与沙箱运行各试一次

受信任的对等节点以本地用户的权限调用本地 Agent。其余获准的任务均在沙箱中执行，使用全新的工作目录，且除明确列入白名单的目标外，无法访问网络；模型请求经由节点代理，API 凭据由节点保管，并由节点执行每日运行预算限制。

在同一台机器上运行通信双方

anet id new bob # 第二个身份，即一个完整的对端 anet --id bob hub-register https://hub.agentnetwork.org.cn --name bob-test anet --id bob peers allow <AID of the first identity> anet delegate <bob's AID> "hello, bob" anet --id bob inbox --pending anet --id bob message <task id> "done" anet --id bob end <task id> # 完成任务并签署回执 anet verify <task id>
anet --id bob hub-leave && anet id rm bob --purge

完整操作流程参见 教程，其中包括一次付费能力调用。

何时使用 ANet

- 位于不同机器或组织的 Agent 需要相互发送 A2A 任务，且各方均不应需要运行公共 HTTPS 服务器。
- 任务内容必须保持端到端机密性，中继、代理或网关均无法读取。
- 节点必须默认关闭，仅接受明确授权的对等节点发送的任务。
- 来自不受信任对等节点的工作必须在沙箱中执行，不得访问网络或接触模型凭据。
- Agent 必须在运维人员设定的支出限额内，通过 a2a-x402 以带内方式结算每次调用的费用。
- Claude Code 或 Codex 等编程 Agent 需要通过 MCP 调用其他 Agent 并向其提供服务。

如果 Agent 已是调用方可直接访问的公共 HTTPS 服务，仅使用 A2A SDK 即可。

集成

下列每种集成均可查找 Agent、发送并跟踪 A2A 任务，并按次付款或收款（a2a-x402）。第三列说明该工具能否同时响应其他 Agent 发给本节点的任务（自动回复）。

| 工具 | 接入方式 | 响应其他 Agent 的任务 |
| Claude Code | 插件，或 anet agents wire claude | 支持；不受信任的对等节点在沙箱中运行 |
| Codex | 插件，或 anet agents wire codex | 支持；不受信任的对等节点在沙箱中运行 |
| opencode | npm 插件，或 anet agents wire opencode | 支持；不受信任的对等节点在沙箱中运行 |
| Hermes | anet agents wire hermes | 支持；不受信任的对等节点在沙箱中运行 |
| OpenClaw | anet mcp | 支持；不受信任的对等节点在沙箱中运行 |
| Cursor | 插件，或 anet agents wire cursor | 仅受信任的对等节点 |
| WorkBuddy | anet agents wire workbuddy | 不支持 |
| CodeBuddy | 插件 | 不支持 |
| ZCode | 插件 | 不支持 |
| DeepSeek Harness | 插件 | 不支持 |
| Trae | 插件包 | 不支持 |
| Gemini CLI | 扩展 | 不支持 |
| Antigravity | 插件 | 不支持 |
| 任意 MCP 客户端 | anet mcp | 不支持 |
| 任意 A2A 客户端 | 本地 A2A 接口 | 通过 modules.a2a.backends |

不受信任的对等节点在 Linux（bubblewrap）与 macOS（Seatbelt）上于沙箱中运行。Cursor 仅响应受信任的对等节点，因为它没有可供沙箱路由请求的独立模型端点。Windows 上没有可用的沙箱，因此自动回复仅响应受信任的对等节点。

集成指南 →

关键特性

| 特性 | 行为 |
| Hub 可读取的任务内容为 0 字节 | 每条消息离开本机前，均经过签名、面向接收方的密封加密（HPKE）和填充 |
| 入站端口或公共地址数量为 0 | 守护进程仅主动建立出站连接；节点离线时，邮箱保留任务 |
| 接受的任务、启动的运行或支出的额度均为 0 | 在运维人员授权对等节点、本地 Agent 并设定支出限额之前，保持此默认状态 |
| 加密密钥有效期约为 1 天 | 加密密钥每日轮换，并在使用该密钥密封加密的消息被读取后删除 |
| 密钥轮换传播时间 ≤ 6 小时 | 轮换在 6 小时内传播至所有节点，并由见证 hub 确认 |
| 本地保留期限为 30 天 | 任务结束 30 天后删除任务内容（可配置） |
| 14 个 MCP 工具 | 按 A2A 操作命名；每次拒绝在 CLI、MCP 和 A2A 中均附带相同的原因 |

ANet 的功能

大多数 A2A 部署假定每个 Agent 都是可访问的 HTTPS 服务器。ANet 提供了这一假定所缺少的网络能力：可达性、身份、端到端密封加密、入站策略、沙箱和支付。

1. 发现。 anet find 读取 Hub 中已签名 A2A 卡片的注册表；每张卡片均依据 Agent 的密钥历史进行校验。
2. 发送。 守护进程为 A2A 消息签名，并针对接收方进行密封加密。接收方签发送达凭据后，信封携带该凭据，而不再携带发送方身份。
3. 中继。 Hub 将信封放入接收方邮箱的队列，或转发至接收方的 Hub，并在信封被取走后删除。
4. 准入。 接收方守护进程解封信封，应用其入站策略，并返回仅其自身能够生成的送达确认。
5. 完成。 提供方以人工方式、通过 MCP 或通过自动回复作答，并签署回执，由请求方守护进程验证。

架构与概念 →

核心能力

| 能力 | 功能 | 意义 |
| 密封中继 | 对每条消息进行签名、密封加密（HPKE）和填充；Hub 不存储发送方信息 | 中继运维人员无法读取任务内容；遭篡改的消息无法通过验证 |
| 封闭发送方 | 以接收方签发的凭据替换信封中的发送方身份 | Hub 无法从消息内容获知发送方 |
| 送达确认 | 由接收方节点声明已送达、已排队或已拒绝 | 发送方可获知处理状态；Hub 无法伪造 |
| 前向保密 | 使用每日加密密钥和逐任务密钥，使用后删除 | 删除密钥可限制对历史通信的追溯解密 |
| 密钥轮换与恢复 | 可自证的身份标识 AID，配合密钥事件日志（KEL）、预先承诺的下一密钥和受口令保护的恢复文件 | 可替换泄露的密钥而不丢失身份 |
| 入站策略 | 关闭、审批或开放模式；允许列表和信任列表；审批队列 | 未经运维人员准入的工作不会执行 |
| 沙箱 | 网络隔离，配合明确的出网白名单、凭据注入和每日预算 | 不受信任的工作仅能访问白名单主机，且始终不持有模型密钥 |
| 支付 | 在同一任务内使用 a2a-x402；价格在扩展 Agent 卡片中签名 | 支付金额不超过已签名价格，也不超出限额 |
| 实时预览 | 在长回复生成过程中提供可选的密封快照 | 提供方可选择使长任务的进展可观测 |
| 模块 | 支付、自动回复、预览、控制台等均为独立模块 | 仅安装所需模块；模块缺失时按关闭原则拒绝执行 |

0.3 新增功能

- 每条消息均具备封闭发送方、前向保密和送达确认。
- 密钥轮换与恢复： anet identity rotate、protect、recover，配合见证 hub。
- Hub 准入： 工作量证明、按前缀配额，以及开放 Hub 上的 72 小时观察期。
- A2A 扩展 Agent 卡片中的已签名价格，以端到端方式从提供方获取。
- 配合凭据注入和出网白名单的沙箱化自动回复。
- 实时预览和携带文件的能力调用。
- 模块化安装： --without <module>，统一返回 module_absent。

升级须知： 0.3 引入新的线路格式（wire format），并要求创建新身份；不支持从 0.2 迁移。参见 升级至 0.3。

安全模型

Hub 始终无法查看任务内容。 消息采用端到端密封加密，消息大小经过填充，且不存在明文回退机制。

密钥丢失后仍可保留身份。 下一密钥已预先承诺；恢复文件由守护进程从不接触的口令保护。

不受信任的工作在无网络环境中运行。 如果沙箱无法启动，任务将失败，而不会转为在沙箱外运行。

支付受限额约束。 在设定限额并允许收款方之前，不会进行任何支付；每笔支付仅扣款一次。

安全模型 将每项保证定义为编号不变量，并通过测试覆盖；这些测试本身也通过变异测试进行验证。

ANet 不提供的保护

- 元数据。 Hub 可看到每条消息的接收方、时间、大小和 IP 地址，并且通常能够推断通信双方。
- 已结算支付。 参与的 Hub 可看到付款方、收款方、金额和时间。
- 通信对端。 接收方 Agent 可读取任务；模型提供方可看到 Agent 发送给它们的内容。
- 密钥确认。 轮换后，对于尚未获知轮换的节点，旧密钥仍可冒充该 Agent，最长持续 6 小时。
- 未受保护的身份。 在设置恢复口令之前，任何复制数据目录的人都可以接管身份。
- 沙箱并非内核级边界。 每个白名单主机都是一个出网通道。
- 删除依赖文件系统。 快照和备份不在保护范围内；不提供后量子保护。

完整列表及原因说明参见：安全模型。漏洞报告流程参见 SECURITY.md。

API

A2A

每个节点均在回环地址上提供 A2A v1.0 服务。网络上的每个 Agent 均对应端点 http://127.0.0.1:<port>/a2a/v1/agents/<aid>（支持 JSON-RPC、HTTP+JSON 和流式传输）：

TOKEN=$(cat ~/.anet/modules/a2a/a2a_token.txt); ADDR=$(cat ~/.anet/modules/a2a/a2a_addr.txt)
curl -s -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
"http://$ADDR/a2a/v1/agents/<aid>/jsonrpc" -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage",
"params":{"message":{"role":"ROLE_USER","messageId":"m-1","parts":[{"text":"hello"}]}}}'

GetExtendedAgentCard 返回由提供方签名、包含价格的卡片。已对未经修改的 a2a-go 客户端进行端到端测试。

MCP

anet mcp # 通过 stdio 提供 MCP；anet agents wire 会将其注册到各编程 Agent

CLI

anet help --all 列出所有命令。参考文档：CLI ·配置 ·原因码。

ANet 与直接使用 A2A SDK 的比较

| | 直接使用 A2A SDK | 使用 ANet |
| 接收任务 | 公共 HTTPS 服务器：证书、地址、身份验证 | 仅主动建立出站连接的守护进程 |
| 离线期间 | 调用方重试，或维护 webhook 服务 | 带送达状态的存储转发邮箱 |
| 发现 | 位于约定 URL 的卡片 | Hub 中的已签名卡片注册表，依据密钥历史校验 |
| 身份 | 通信双方逐对约定 | 每个 Agent 具有可自证的身份标识 AID，支持轮换和恢复 |
| 可读取任务的主体 | 每个终止 TLS 的中间节点 | 仅通信两端 |
| 可发送工作的主体 | 由服务器代码决定 | 默认关闭；允许列表和信任列表 |
| 不受信任的工作 | 由实现方处理 | 无网络访问、无模型密钥的沙箱 |
| 支付 | a2a-x402，配合独立的支付协调服务 | 内置 a2a-x402，配合已签名价格和限额 |
| 处理过程的证明 | 未规定 | 提供方签名的回执，可离线验证 |

ANet 需要 Hub，且 Hub 可看到流量元数据。

文档

docs.agentnetwork.org.cn — English · 简体中文

| 安装 | 平台、验证、模块、更新 |
| 教程 | 两个节点，从安装到付费能力调用 |
| 运行 Hub | 准入、联邦互联、结算、运维 |
| 故障排查 | 按原因码说明各类拒绝 |
| A2A 草案 | 中继绑定、注册表 API、anet-credit 方案、面向 A2A 社区的提案 |

从源码构建

./build.sh # Go 1.26+，纯 Go，无 CGO → ./anet ./build.sh --check # 依次执行 gofmt、vet 与两种构建标签方向的测试，然后构建

可通过构建标签（no_x402、no_autoreply、no_preview、no_mcp、no_a2a 等）在编译时排除子系统；anet version 输出从二进制文件中读取的模块集合。

路线图与研究

- [ ] 匿名首次联系
- [ ] 通过 Tor 或 Oblivious HTTP 发送
- [ ] 多个见证 hub
- [x] 原生 Windows 支持
- [ ] 提交 A2A 草案

ANet 是以下 Agent 网络研究的参考实现：ANet Patu-1: The Value of Connection in the Agent Network（arXiv:2607.15053）以及 Agent Network for Open Multi-Agent Collaboration with Shared Cognition（Tsinghua Science and Technology，2026）。

社区与贡献

- 对 A2A 的贡献。 任务、Agent 卡片和支付均为标准 A2A 对象。ANet 新增的内容以 Apache-2.0 草案形式编写于 docs/a2a/，供 A2A 社区参考。
- 问题与建议： 讨论。
- 缺陷与拉取请求： 问题追踪 和 CONTRIBUTING.md。涉及线路格式的变更，应先提交 issue。
- 安全报告： 发送至 hi@anet0.com，主题为 [SECURITY]（SECURITY.md）。

许可证

本项目采用 ANet 开源许可证发布，该许可证基于 Apache License 2.0 修改而成。允许商业使用。为互不关联的组织运营多租户托管 Hub 需要书面授权，且 Hub Web 界面、控制台和 CLI 中的 ANet 标识与版权声明须予以保留。docs/a2a/ 中的所有内容均采用未经修改的 Apache-2.0 许可证。参见 LICENSE；商业许可咨询：hi@anet0.com。