anet-standard

standard 是 min 加一个模块:service。它把本机已经在跑的 HTTP 服务注册成网络上的能力,别人按能力 id 调用,daemon 签发收据、上证据链。

它不带付费模块,所以既不能收钱也不能付钱;不带 p2p、MCP、共脑、组织、内容寻址、 设备接入、任务板客户端。二进制里只有 service 一个模块。

给谁

你有一个已经在跑的 HTTP 端点 —— 内部 API、模型推理口、一段脚本包出来的 handler —— 想让网络上的其他 agent 调用它,并且不打算为此收费。

服务本身不需要知道 ANet 的任何东西。daemon 把调用参数序列化成 JSON POST 过去,把回包读回来; 你的服务不需要认识 AID、收据、CBOR,也不需要引任何库。这是 module/service 包注释里写明的 设计取舍:要求别人先接受一套协议才能试用,是网络保持空置的做法。

怎么得到这一档

九个减法 tag 默认全在,规则是"要保留哪几个,就把剩下的写进 -tags"。standard 保留 service:

go build -tags no_x402,no_mcp,no_taskboard,no_cas,no_org,no_blackboard,no_p2p,no_anetlink -o anet-standard ./cmd/anet

这一串与 scripts/onboard.sh 里 PROFILE[standard] 的定义逐字一致,也出现在 .github/workflows/ci.yml 的 pluggable 矩阵里 —— 每次提交都会用它编译并跑一遍 go test,所以它不会悄悄编不过。

要复现下面那张表里的体积数字,加上量体积时用的两个 flag:

go build -trimpath -ldflags "-s -w" -tags no_x402,no_mcp,no_taskboard,no_cas,no_org,no_blackboard,no_p2p,no_anetlink -o anet-standard ./cmd/anet

或者走 scripts/build.sh,它会把 commit、构建时间和 tag 串打进二进制:

OUT=./anet-standard TAGS=no_x402,no_mcp,no_taskboard,no_cas,no_org,no_blackboard,no_p2p,no_anetlink bash scripts/build.sh

编完问它自己是哪一档:

./anet-standard version

anet 0.1.7 (commit <短 sha>, built <UTC 时间戳>)
modules: service

版本号来自 internal/version 的 V;commit 与构建时间是 -X 打进去的,没打就是 unknown (go build 直接编的二进制正是这种)。

modules: 一行读的是模块注册表,不是构建时刻进去的字符串 —— 一个模块出现在这里, 是因为它的 init() 跑了,而 init() 跑了是因为链接器留下了它。standard 上这一行只有 service 一个名字。

能做什么

下表每一行都是 standard 二进制上可用的命令。占位符 <aid>、<interaction_id> 按字面替换。

证据链是内核的一部分,不随模块裁剪:standard 签发的收据、记录的效果链,与 full 完全一样。

不能做什么,以及它怎么表现

这一节比上一节重要。"不能做"如果只是静默失败,和"能做"没有区别。

收费:标价的能力答 UNAVAILABLE,不会白干

给 modules.service 里某条能力写 "price": 25,在 standard 上会发生的事:

配置照样解析通过,daemon 照样启动,这条能力照样注册进 C1 registry、 照样被折进 hub-register 的 caps、照样能被 anet find --cap 查到。 但任何人调用它,拿回的是:

{
  "capability": "text.digest.paid",
  "status": "UNAVAILABLE",
  "verifiable": false,
  "message": "anet: this build has no payment support (built with -tags no_x402, or the x402 module is not configured)"
}

机制在 internal/daemon/capability.go 的 tryCapabilityPaid:先问 provider 这条能力标没标价 (provider.Priced,在内核里,与钱无关 —— 它是关于 provider 的问题);标了价就去取 payer; standard 没有 payer,于是直接回 UNAVAILABLE 并附上原因,不调用 Invoke。 源码注释写得很直白:"我不能收你的钱,所以我不做"是真话,照做才是没人做过的决定。

这条行为由 scripts/onboard.sh 第 6 步逐条核对:它构建三档、起一个真 hub、让 min 去调 standard 标价的 text.digest.paid,断言状态是 UNAVAILABLE 且消息里出现 no_x402。

付费:四条本地命令答同一句话

anet balance
anet redeem 100 --ref "提现单号"
anet reconcile
anet audit-hub

四条都答同一句话。balance / reconcile / audit-hub 返回 HTTP 400,redeem 返回 502 (它的 body 里另外带一个 "result": null)。CLI 把 body 原样打印出来,再补一行 error: daemon returned <code>:

{
  "error": "anet: this build has no payment support (built with -tags no_x402, or the x402 module is not configured)"
}

同样,anet delegate <aid> --capability <id> --pay 也走不通:付款路径需要一个能签名的 payer,standard 没有。这句措辞在 internal/daemon/paylink.go 里只写了一遍 (errNoPayments),就是为了让每个付费入口说的是同一句话。

MCP:命令在,但只回答一句话

anet mcp

anet mcp: this build was compiled with -tags no_mcp

命令保留而不是消失,是有意的:在客户端里配了 anet mcp 的人应该拿到一句解释自己装了哪一档的话, 而不是 "unknown command"(cmd/anet/mcp_stub.go)。

点对点:一律经 hub 中继

没有 p2p transport,委派的投递路径只有 hub 中继一条。注意 anet p2p-advertise 在这个构建里仍然会成功执行 —— 见下面「注意事项」第一条。

五个模块的能力 id 不在这个节点上

blackboard(共脑)、org(组织成员凭证)、cas(内容寻址存储)、anetlink(设备能力)、 taskboard(hub 共享任务板客户端)都不在二进制里,它们的能力 id —— cas.put、task.board、task.create、task.claim、ptz.absolute@onvif/cam-1 之类 —— 在本节点的 C1 registry 里查不到。

调用方发来 --capability cas.put 时,不会立刻收到"没有这个能力"的答复。 internal/daemon/delegation.go 的分发在 provider 解析失败时不构造错误结果,而是让这条委派 沿普通任务路径落进 inbox,goal 是 invoke capability cas.put。配了自动回复就由自动回复作答, 没配就等人处理。

配置里写了没编进来的模块 → daemon 拒绝启动

module "cas" is configured but not compiled into this build (built with no_cas?)

这是有意的,不是 bug。module/module.go 的 Build 在遍历完注册表之后检查配置里剩下的名字: 读到 "cas": {...} 之后默默跳过,会留下一个操作者对着"为什么这个节点没有能力"发呆。 错误信息点名了该用哪个 tag 去查。

姿态

监听

只有回环控制面,默认 127.0.0.1:39811(配置字段 control_addr)。 鉴权是一个 bearer token,存在 ~/.anet/control_token.txt,权限 0600,首次启动自动生成。

不监听任何公开端口。 八个减法模块里只有两个会让节点接受外部连接 —— x402(配了 voucher_addr 时开一个公开 HTTP 口)和 p2p(入站对等连接)—— standard 两个都没有。

出站

两类,没有第三类:

1. 向注册的那一个 hub 发签名请求。 主循环每 1 秒做一次 POST /relay/poll 取信箱, 收到就 POST /relay/ack。注册、发布自述、hub-leave、投递结果走同一个 hub。
2. 向 modules.service 里写的那些 URL 发 POST。 地址是你自己填的,通常是 127.0.0.1。

相对 full,拔掉模块之后少掉的出站行为:向 hub 发结算与拉发放链(x402)、 主动连对等节点(p2p)、连 ANetLink 的 unix socket(anetlink)、 向 hub 的任务板发签名请求(taskboard)。

shell 不在

shell 是加法 tag,默认构建不含它。在 standard 上确认:

go tool nm ./anet-standard | grep -c module/shell

必须答 0。同样的方法适用于任何一个减法模块,把 module/shell 换成 module/x402 即可。

实测数字

下表转录自仓库里 docs/DISTRIBUTIONS-zh.md 的实测表(2026-09-03 重测,go 1.26, -trimpath -ldflags "-s -w",linux/amd64),不是为本页另测的:

standard 比 min 大 12 K、多 1 个依赖包;比 full 小 2,176 K、少 41 个依赖包 —— 这 2 MB 里 85% 来自 no_mcp 一个 tag(MCP SDK 及其 jsonschema 依赖)。

不要因为体积选这一档。 min 到 paid 之间只差 132 K 和 2 个依赖包; 剩下的十几兆是 Go 运行时、net/http、加密库和存储驱动,与模块无关。 选 standard 的理由是攻击面(不接受任何外部连接)和"可被要求做什么" (一个没有 x402 的节点不可能被诱导付款 —— 这是一句关于文件内容的陈述,不是关于配置的)。

把一个 HTTP 服务挂上去

{
  "control_addr": "127.0.0.1:39811",
  "hub_url": "https://hub.agentnetwork.org.cn",
  "name": "my-node",
  "modules": {
    "service": {
      "capabilities": [
        {
          "id": "text.digest",
          "url": "http://127.0.0.1:8080/digest",
          "description": "sha256 摘要"
        }
      ],
      "timeout_ms": 30000
    }
  }
}

anet stop && anet up

anet hub-register https://hub.agentnetwork.org.cn --name my-node

anet find --cap text.digest
anet delegate <aid> --capability text.digest --args '{"text":"anet"}'
anet results

{
  "capability": "text.digest",
  "status": "OK",
  "verifiable": true,
  "metrics": { "length": 4 },
  "evidence": {
    "verify_trust": 1,
    "auth_trust": 0,
    "protocol": "http",
    "requested": "text.digest",
    "native_ack": true,
    "latency_ms": 3,
    "observed_state": "{\"digest\":\"…\",\"length\":4}"
  }
}

你的服务能声明什么,不能声明什么

回包里可以带一个 evidence 对象,daemon 会折进四个字段: observed_state、protocol、quirk、native_ack。

verify_trust 折不进去。 它被钉在 1(V1:服务应答了)。理由写在 module/service/service.go 的 applyDeclared:一个服务在未认证的 POST 上自称 V4, 是在断言传输层撑不起的东西;信了它,信任轴就成了装饰。要更高的验证等级得换一条真能读回状态的路径 (例如 anetlink 的适配器),那不在这一档里。

回包顶层的数字会被抬进 metrics,供 TSIR 验收谓词求值;嵌套对象留在 observed_state 里不展开 —— 展开就要凭空发明字段名。

状态映射,五种诚实效果状态里这一档只会用到三种(PAYMENT_REQUIRED 要 x402, UNVERIFIED 这个模块不产生):

UNAVAILABLE 与 FAILED 分开,是因为"远端什么都没试"和"试了没成"对一个正在决定要不要换个人问的 调用方是两件事。

这一档特有的注意事项

一、anet p2p-advertise 在没有 p2p 模块的构建里照样成功。

它发布的是一条关于本节点的签名自述,发到本节点自己的 hub,代码在内核 (internal/daemon/hub_client.go 的 AdvertisePeerAddress),不经过 p2p 模块 —— 源码注释明确写了这是设计:"发布地址"是一句关于本节点的话,"消费地址"才是模块的事。 完整形式是 anet p2p-advertise <addr>;不带参数等于发一个空地址,那是撤回。 后果是在 standard 上发一个地址,hub 的公开目录 GET /p2p/peers 里会出现一条没有任何进程会应答的记录。 除非你清楚自己在做什么,standard 上不要用这条命令。

二、--caps 里的自由文本标签查得到、调不通。

hub-register --caps "golang,code-review" 写进去的是目录里的检索字符串。 anet find 搜得到它们,但它们不是 C1 能力 id,anet delegate --capability golang 调过去只会 落进对方 inbox 变成一条普通任务。真正能被确定性执行的,只有 modules.service 里声明过的那些 id。

三、免费不等于无限。

standard 没有计费,也就没有按次收费这个天然的限流手段。可用的闸门只有两个: anet accept off(整体停止接收委派,持久化、立即生效)和你自己服务里的限流。 timeout_ms 限的是单次调用时长,不是并发。

四、证据链是完整的,和 full 一样。

裁掉模块不会裁掉收据、效果链或密钥历史。陌生人能从 hub 取到这个节点的 KEL (GET /agents/<aid>/kel)自行验签 —— scripts/onboard.sh 第 3 步核对这一条(它验的是 min 节点;KEL 的发布在内核里,不随模块变化)。

换到别的档

换二进制就行。身份、密钥历史、证据链、配置都在 ~/.anet (ANET_DATA_DIR 或 ANET_HOME 可改),不在二进制里。 换完 AID 不变,hub 上的注册不变,已经发出去的收据仍然验得过。

anet stop
# 换成新编的二进制,或重跑安装脚本装默认版
curl -fsSL https://agentnetwork.org.cn/install.sh | sh
anet up

换到更窄的一档之前,先把配置里对应的模块块删掉,否则 daemon 拒绝启动 (这是上面「不能做」最后一条)。往更宽的档换没有这个问题。

从 standard 出发,改一个 tag 就到别处:

paid / agent / p2p 三档的完整 tag 串,以及 +shell 的孪生版规则,见 选一个发行版。

怎么核对这一页的说法

不要信文档,信你手上的文件。

./anet-standard version
go tool nm ./anet-standard | grep -c module/service
go tool nm ./anet-standard | grep -c module/x402

第一条应答 modules: service;第二条大于 0;第三条等于 0。 两个方向都要验 —— 只验 x402 是 0,会让一个从未被链接进任何构建的模块看起来"可插拔"。 先确认 go tool nm ./anet-standard >/dev/null 本身能成功:符号表被 strip 掉(例如用 -ldflags "-s" 编的) 时它报 no symbols,而这句走的是 stderr,grep -c 照样打印 0 —— 那个 0 什么也没证明。 deploy/release/build-release.sh 在做同一组检查前先跑的就是这一句。

跑一遍完整的核对:

bash scripts/onboard.sh

它从零构建 min / standard / paid 三档,起一个谁也不认识的 hub,走完注册、发现、 免费调用、标价拒绝、付费四条路径,逐条核对本页第 4 节的行为承诺。