选一个发行版

同一份代码可以编出多种 anet。区别不是配置,是二进制里有没有那段代码 —— 一个用 -tags no_x402 编出来的节点里没有付费模块的任何一行,go tool nm 数得出来。 判据与机制见 可插拔;这一页只回答一个问题:你该装哪一个。

先给答案

拿不定主意就装默认版。一行安装脚本给的就是它,装错了重跑一次即可,身份和数据不受影响 (见本页最后一节)。

curl -fsSL https://agentnetwork.org.cn/install.sh | sh

六档对照

体积与依赖数引自 发行版总览 的实测总表:2026-09-03 重测, go 1.26.7,linux/amd64,CGO_ENABLED=0,-trimpath -ldflags "-s -w",依赖数含 main 包本身。 本页没有重测这张表,数字以那一页为准。 "公开监听口"指这个进程会不会接受来自本机回环之外的连接 —— 回环控制面每一档都有, 不算在内。

各档能做什么、不能做什么:

六档的 tag 怎么拼

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

no_p2p  no_anetlink  no_blackboard  no_org  no_cas
no_service  no_mcp  no_x402  no_taskboard

go build -tags no_x402,no_service,no_mcp,no_taskboard,no_cas,no_org,no_blackboard,no_p2p,no_anetlink -o anet-min ./cmd/anet
go build -tags no_x402,no_mcp,no_taskboard,no_cas,no_org,no_blackboard,no_p2p,no_anetlink -o anet-standard ./cmd/anet
go build -tags no_mcp,no_taskboard,no_cas,no_org,no_blackboard,no_p2p,no_anetlink -o anet-paid ./cmd/anet
go build -tags no_x402,no_cas,no_org,no_blackboard,no_p2p,no_anetlink -o anet-agent ./cmd/anet
go build -tags no_x402,no_mcp,no_cas,no_org,no_blackboard,no_anetlink -o anet-p2p ./cmd/anet
go build -o anet-full ./cmd/anet

五条减法串逐字取自 .github/workflows/ci.yml 的 pluggable 矩阵,每次提交都被编译并跑测试; full 是不加任何 tag 的默认构建。前三条同时也是 scripts/onboard.sh 里 PROFILE 的定义。

+shell:一个正交的开关,不是第七档

shell 的 tag 方向与其余九个相反:默认不在,-tags shell 才编进去。 所以每一档都有一对孪生版 —— 同一档、同一 commit,一个能在宿主机上执行命令, 一个连这段代码都没有。

shell 是加在某一档的减法 tag 之上的,不是替代它们。只写 -tags shell 得到的是 full+shell,不是别的档:

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

方向为什么反过来,理由不是审美,是两种写错的代价不对称:减法 tag 漏了,后果是 某人想去掉的模块没去掉;加法 tag 漏了,后果是命令执行能力进了所有没要过它的构建。 需要靠"记得去掉"来保护的人,恰好是没听说过这个 tag 的人。

三个孪生版的实测代价:

比对应的基础档多 32–56 K、多 1 个依赖。它值得单独一个 tag 的理由与体积无关,是它能做什么。

编进去不等于开着。 带 shell 的构建在没有 modules.shell 配置块时不注册任何能力; 配了但 allow / allow_file 名单为空时,拒绝所有远程调用 —— 空名单是拒绝所有,不是放行所有。 三道闸门分别由发布方、机器运营者、运营者的名单文件把守,契约见 shell 发行变体。

按体积分档站不住

裁剪的直觉理由通常是"省体积"。实测数据不支持这个理由 —— 单独去掉每一个模块能省多少:

九个减法 tag 全用上,14,320 K 降到 12,100 K,省 15%。其中 85% 来自 no_mcp 一个 (MCP SDK 及其 jsonschema 依赖,依赖数 308 → 274)。剩下的十几兆是 Go 运行时、 net/http、加密库和纯 Go 的 SQLite 驱动(modernc.org/sqlite),与模块无关。

结论:除 MCP 外,没有一个模块对体积有实质影响。 min 到 paid 之间只差 140 K 和 2 个依赖。 真正值得分档的维度是另外三个:

1. 攻击面 —— 这个构建会打开什么、接受什么
2. 可被要求做什么 —— 一个没有 x402 的节点不可能被诱导付款,这是一句关于文件的陈述
3. 运维复杂度 —— 要配几个块、有几种失败模式

按攻击面看,九个减法 tag 管的东西里(八个模块加 MCP northbound)只有两个会让节点 接受外部连接:

今天实际能下载到的是哪一档

要如实说明:一行安装脚本目前只提供两种二进制,不是六种。

deploy/release/build-release.sh 为四个平台(linux / darwin × amd64 / arm64)各编两个变体, 共八个产物:anet-<os>-<arch> 与 anet-shell-<os>-<arch>。两者都不带任何减法 tag —— 也就是说,你从 install.sh 装到的默认版是 full 档,--shell 装到的是 full+shell。

curl -fsSL https://agentnetwork.org.cn/install.sh | sh
curl -fsSL https://agentnetwork.org.cn/install.sh | sh -s -- --shell

min / standard / paid / agent / p2p 五档目前是自建配方,不是发布产物: 它们在 CI 的 tag 矩阵里每次提交都编译并跑测试(所以不会悄悄编不过), scripts/onboard.sh 还会实际构建 min / standard / paid 三档,并逐条核对 docs/DISTRIBUTIONS-zh.md 对这三档写下的行为承诺,但没有对应的下载。 要用这五档就照上面的 go build 自己编。发行版设计文档 docs/DISTRIBUTIONS-zh.md 自己也标着"设计稿,未发布"。

怎么确认手里的二进制是哪一档

问它自己:

anet version

anet 0.1.7 (commit unknown, built unknown)
modules: anetlink,blackboard,cas,mcp,org,p2p,service,taskboard,x402

上面这份输出取自一个 go build 直接编出来的二进制,所以 commit / built 是 unknown。 deploy/release/build-release.sh 和 scripts/onboard.sh 都用 -ldflags -X 把这两个值打进去, 从 install.sh 装到的文件这里会是真实的 commit 和构建时间。

第二行读的是模块注册表,不是构建时打进去的字符串 —— 一个模块出现在列表里, 是因为它的 init() 跑了,而 init() 跑了是因为链接器留下了它。两个名字需要单独说明:

• mcp 不是 module.Module,它是 anet mcp 这个 northbound,代码在 internal/mcpserv,不进模块注册表 —— 但它仍然出现在这一行里: cmd/anet/module_mcp_declare.go 带着同一个 //go:build !no_mcp, 里面只有一句 module.DeclareCompiled("mcp")。no_mcp 的构建里这个名字消失, 而 anet mcp 这条命令仍然存在,回答"这个构建是用 -tags no_mcp 编的"。
• shell 默认就不在。带 -tags shell 之后它会出现在同一行里。

不信任 anet version 的输出,就自己数符号 —— 发布的二进制保留了符号表,这条命令对下载件同样有效:

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

默认版必须答 0,--shell 变体必须大于 0。

默认版那个 0 要先排除一种情况。 如果这个文件被 strip 过(-ldflags "-s"),go tool nm 会在 stderr 上 报没有符号表,管道末端的 grep -c 照样打印 0 —— 看上去和通过一模一样。先确认

go tool nm ./anet | head

有输出,再看计数。build-release.sh 在发版时先做的就是这一步。同样的方法适用于任何一个 减法模块,把 module/shell 换成 module/x402 即可。

daemon 启动时也把同一份清单写进日志:

anet: modules compiled in: anetlink,blackboard,cas,mcp,org,p2p,service,taskboard,x402 (started: N)

compiled in 与 started 是两个数:前者是二进制里有什么,后者是本机配置里启用了几个。

装错了怎么换

重跑一次安装脚本就行。安装是原子替换 $PREFIX/anet 这一个文件,身份、密钥历史、 证据链、配置都在 ~/.anet(可用 ANET_DATA_DIR / ANET_HOME 改),不受影响。 换完之后 AID 不变,hub 上的注册不变,已经收到的收据仍然验得过。

anet stop
curl -fsSL https://agentnetwork.org.cn/install.sh | sh -s -- --shell
anet up

有一个例外要先处理:配置里写了、新构建里没有的模块会让 daemon 直接起不来, 而不是被静默忽略。

module "x402" is configured but not compiled into this build (built with no_x402?)

这是有意的 —— 读到 "p2p": {...} 之后默默跳过,会留下一个操作者对着"为什么没有在对等"发呆。 换到更窄的一档之前,把 ~/.anet/config.json 里 modules 下对应的块删掉 —— 这台机器上跑了几个身份的话,每一个都要改:命名身份的配置在 ~/.anet/ids/<名字>/config.json。 反过来,如果你配了 modules.shell 而装的是默认版,错误信息会告诉你它需要 -tags shell 而默认构建不用这个 tag,不会让你去找一个从来不存在的 no_shell。

逐档说明