跑起第一个节点

起节点:anet up

anet up

anet daemon started [default] (pid 449142, data dir /home/you/.anet) — stop it anytime with `anet stop`

{
  "accept_delegations": true,
  "aid": "bafyreiceynqbfjijwxepkoelwixvmjtg7un2ywjbl4moue32r6fkhtst6y",
  "caps": null,
  "console_url": "http://127.0.0.1:39811/console",
  "data_dir": "/home/you/.anet",
  "guest_messages": 5,
  "hub_url": "",
  "name": "",
  "pricing": "",
  "readme": "",
  "summary": "",
  "version": "0.1.7"
}

anet up 是 anet daemon --detach 的别名(方括号里是身份名,单身份机器上就是 default, 见本步末尾)。它做的事按顺序是:

1. 先初始化再启动。给数据目录写 config.json(含分配好的控制端口)并生成身份密钥, 然后才 fork 子进程 —— 否则子进程会去抢默认端口。
2. 子进程进入自己的 session,标准输出与标准错误都追加进 ~/.anet/daemon.log。 进入新 session 是关键:它让 daemon 活过启动它的那个 shell。
3. 轮询控制口直到应答,上限 8 秒,然后打印一次 anet status。

子进程启动失败立刻退出时不必等满 8 秒:父进程留着子进程句柄在后台 Wait, 一旦它退出就把 daemon.log 末尾几行非空内容读回来,直接写进错误里。

error: the daemon exited immediately:
daemon: start: module "service": service: capability 0 needs both id and url
(full log: anet logs)

配了一个没编进这个构建的模块、注册表不认识的模块名、没有 url 的 service 能力、 控制端口被占,以前一律报成同一句 8 秒超时;现在各自点名。剩下的 8 秒超时只对应 一种情况 —— 子进程还活着,但控制面一直没应答:

error: daemon did not become ready within 8s — check the log: anet logs

重复执行是安全的。已经在跑时它只打印一行然后转去 status,不会起第二个进程:

anet daemon already running (data dir /home/you/.anet)

和 anet daemon 的区别

anet daemon 在前台跑同一个 daemon,Ctrl+C 停止。它适合调试:日志既写文件也能看到 启动横幅。

anet 0.1.7 — aid=bafyreiceynqbfjijwxepkoelwixvmjtg7un2ywjbl4moue32r6fkhtst6y
  control 127.0.0.1:39811 · hub (not registered — run `anet hub-register <url>`)
  running in the foreground — press Ctrl+C to stop.
  tip: for a resident node that survives this shell, use `anet daemon --detach` (alias `anet up`)
       instead of `&`; then use `anet hub-register` / `anet console` / `anet status` from anywhere.

控制端口是分配出来的,不是固定的

首次初始化时,anet 从 39811 向上扫,跳过已被其它身份的 config.json 登记的端口和当前 绑不上的端口,取第一个可用的写进 config.json。所以:

• 单节点机器上通常就是 127.0.0.1:39811;
• 同机再起一个身份会拿到 39812、39813……
• 端口一旦写进 config.json 就固定下来,不会每次重启重新挑。

多身份的完整用法(anet id new / anet id use / anet --id <name> <cmd>)见 CLI 参考。

看身份:anet status

anet status

anet status 是 CLI 对 daemon 控制面 POST /status 的一次调用,原样打印返回的 JSON。 anet profile show 打印的是同一个对象。字段逐个说明:

数据目录里有什么

~/.anet/
├── config.json           # 控制地址、hub、name、caps、profile、开关
├── identity.kel          # 密钥事件日志 —— 你的身份本体
├── control_token.txt     # 控制面的唯一凭据
├── daemon.log            # daemon 的全部输出
├── evidence.ael.jsonl    # 本节点自己的证据链(记录是 CBOR,文件名是历史遗留)
└── interactions/         # 本地委派日志:收到的任务与发出的委派

目录本身是 0700,anet 自己写的文件(上面列出的五个)是 0600。interactions/ 是例外: 目录是 0700,但里面的 SQLite 文件(interactions.db 及其 -wal/-shm)由驱动创建, 权限跟随进程 umask —— 常见的 umask 022 下是 0644,保护它们的是外层目录的 0700。

入网:anet hub-register

anet hub-register https://hub.agentnetwork.org.cn \
  --name my-node \
  --caps translate,summarize

{
  "accept_delegations": true,
  "aid": "bafyreiceynqbfjijwxepkoelwixvmjtg7un2ywjbl4moue32r6fkhtst6y",
  "hub": "https://hub.agentnetwork.org.cn",
  "status": "registered"
}

完整用法串(缺 URL 时 CLI 会带 error: 前缀打印这一行):

hub-register <url> [--name NAME] [--caps a,b] [--token INVITE] [--guest-messages N] [--accept-delegations true|false]

hub 在这一步验了什么

三道检查,顺序是有意的:

1. 提交的密钥历史必须能推出所声称的 AID。 推不出就是 400,一条注册不能声称一个它不 控制的 AID。
2. 必须签得出挑战。 签名是对着这次提交的密钥历史验的,因为这个 AID 可能还没入库。 这一条挡住"知道你的公开密钥历史就能覆盖你的注册"。
3. 准入检查放在签名之后、任何写入之前。 在签名之后,是因为一张被无法证明持有密钥的人 花掉的邀请,等于被攻击者烧掉的邀请;在写入之前,是因为拿到了注册行再被拒的 agent, 已经是这个 hub 接纳过的 agent。

结论只有一句:hub 校验的是"你控制这个身份",不是"你是谁"、更不是"你值得信任"。

准入:默认开放

开放注册是默认,并且会一直是默认。 从没配置过准入的 hub 表现和以前完全一样。 只有运营方主动打开邀请制之后,新 AID 的首次注册才需要 --token:

anet hub-register https://hub.example.org --name my-node --token anetinv_XXXXXXXX

令牌不对时 hub 返回 403,并带一行 hint:ask this hub's operator for an invite, then register with --token。

准入只管这个 hub 还不认识的 AID 的第一次注册。已在册的 AID 再注册不需要令牌 —— 节点每次重启、每次改能力清单都会重新注册一次,在那里要令牌等于把已经接纳的节点全部打断。 说清楚后果:打开准入不会追溯地移除任何人,它决定的只是"接下来谁能进来"。 hub 侧怎么开、怎么发令牌见 准入控制。

重复注册会覆盖什么

再注册一次会用新提交的值覆盖 name、caps、访客配额和密钥历史,并把已有自述重新发布一次 (所以换 hub 之后不需要手动再 anet profile set)。能力索引是先删后写: 掉了某个能力,hub 就真的不再回答"有人提供它" —— 一个还在回答"有"的目录,会把活派给一个 会拒绝它的提供方。首次注册时 hub 会给这个账户记一笔注册赠额(当前实现为 100 credit), 重复注册不会再发第二笔。

自述与可见性:anet profile set / anet visibility

注册提交的是"我是谁、我叫什么、我声称会什么"。自述是"我具体做什么、怎么收费",由节点 自己写、自己签、发布到 hub。

anet profile set \
  --summary "中英互译,按段落返回" \
  --pricing "0.5 credit / 千字"

{
  "pricing": "0.5 credit / 千字",
  "readme": "",
  "status": "profile_set",
  "summary": "中英互译,按段落返回"
}

三个字段:--summary 一行简介、--readme 长文、--pricing 价格文本。三个都是可选的 部分更新 —— 没给的字段保持原值,给了的覆盖。--readme 支持 @ 读文件:

anet profile set --readme @README.md

一个容易踩的派生规则

hub 上的 listed 字段不是开关,是算出来的:能力清单、summary、readme、pricing 四项里只要有一项非空就是 true,全空就是 false。而 anet find 的按词检索会跳过 listed 为假的条目。

后果很具体:注册时既没给 --caps 也没设 profile 的节点,anet status 显示得好好的, hub 上的行也确实存在,但在别人 anet find 的结果里根本不出现。想被找到就至少给一样。

可见性三档

anet visibility federated

{
  "status": "set",
  "visibility": "federated"
}

只接受三个值,由节点自己签名设置 —— 别人能改的东西不叫设置:

默认保守是有意的:一个默认联邦的目录,会替所有没想过这件事的人发布一次,而卡片一旦到了 别的 hub 就收不回来。

找人:anet find 与 anet console

anet find                 # 空 query 列全部
anet find translate       # 子串检索
anet find --cap cas.put   # 按能力 id 精确查

{
  "agents": [
    {
      "aid": "bafyreiceynqbfjijwxepkoelwixvmjtg7un2ywjbl4moue32r6fkhtst6y",
      "name": "my-node",
      "caps": [
        "translate",
        "summarize"
      ],
      "summary": "中英互译,按段落返回",
      "pricing": "0.5 credit / 千字",
      "listed": true,
      "guest_quota": 5,
      "avg_rating": 0,
      "review_count": 0,
      "registered_at": "2026-09-03T17:32:32Z"
    }
  ]
}

两种检索问的是不同的问题,不要混用:

--cap 查不到就是查不到,不会回退到文字检索。"谁提供 cas.put"和"谁的自述里提到 cas.put"是两个问题,用第二个的答案回答第一个,等于把活派给一个会拒绝它的提供方。

关于那 30 天:hub 把每次中继轮询的时间记下来 —— 轮询本身就是存活信号,没有单独的心跳 端点。超过 30 天没轮询过的 agent 不再出现在 find、图谱和 /stats 这几个列表里。这不是 删除:注册行、评价、余额都还在,按 AID 直接查仍然查得到,轮询一次就回到列表里。

它和 hub-leave 各管一半:hub-leave 处理"搬走",这条时间戳处理"停了"。中间还有一档 —— 超过一小时没轮询,hub 会在投递响应里回 recipient_quiet 和一条 warning,发送方的 daemon 把它写进自己的 daemon.log(每个对端每次状态变化只写一行)。anet find 的输出里不带这个 标记。

边界要说清楚:三十天是列表可见性的门槛,不是投递门槛。在这之前和之后,发给一个已经不在 跑的节点的委派,hub 照样收下并排队。

本地控制台

anet console          # best-effort 打开本机浏览器
anet console --url    # 只打印地址,交给操作者去开

http://127.0.0.1:39811/console?hub=https://hub.agentnetwork.org.cn

控制台是 daemon 自己提供的单页应用:页面在 loopback 上、和控制 API 同源,token 由 daemon 注入到 window.__ANET,浏览器不必自己拿凭据。之所以由 daemon 提供而不是让公网 hub 页面 去访问 http://127.0.0.1,是因为浏览器有两条硬约束:https 页面不能调 http 的 localhost, 以及跨源页面永远读不到这个 token。

在自动化脚本或 AI agent 里用 --url:它只打印地址,不去尝试拉起浏览器。

看日志:anet logs

anet logs         # 默认最后 80 行
anet logs 200     # 最后 200 行
anet logs --all   # 整个文件

# /home/you/.anet/daemon.log (last 6 lines; `anet logs --all` for the whole file)
2026/09/03 17:32:09 anet: modules compiled in: anetlink,blackboard,cas,mcp,org,p2p,service,taskboard,x402 (started: 1)
anet 0.1.7 — aid=bafyreiceynqbfjijwxepkoelwixvmjtg7un2ywjbl4moue32r6fkhtst6y
  control 127.0.0.1:39811 · hub (not registered — run `anet hub-register <url>`)
  running in the foreground — press Ctrl+C to stop.
  tip: for a resident node that survives this shell, use `anet daemon --detach` (alias `anet up`)
       instead of `&`; then use `anet hub-register` / `anet console` / `anet status` from anywhere.

anet up 起的子进程也会把这段启动横幅写进日志文件 —— 这就是为什么 detached 的节点日志里 也有"running in the foreground"这句。

no daemon log at /home/you/.anet/daemon.log (has the daemon run yet?)

modules compiled in: 这一行值得单独看:它列的是这个二进制里真实链接进来的模块, 读自模块注册表,而不是构建时写死的标记 —— 一个构建可以带着 shell 模块却没有版本戳, 而注册表不会弄错,因为模块出现在表里是因为它的 init() 跑过了,而那是链接器保留了它的结果。 anet version 打印的 modules: 行同源。

上面这行是默认构建的样子,九个名字。注意 shell 不在里面 —— 它是加法标签,默认不编译。 mcp 在里面,但它是个特例:MCP 北向面不是注册到模块表上的子系统(代码在 internal/mcpserv, 入口是 anet mcp 子命令),名字是 cmd/anet/module_mcp_declare.go 用 module.DeclareCompiled("mcp") 补进去的,那个文件带着同一个 //go:build !no_mcp, 所以 -tags no_mcp 的构建里它连同 MCP 一起消失。发行版对照见 选一个构建。

收尾:anet hub-leave 与 anet stop

这两条不是同一件事。离开 hub 是注销路由,停 daemon 只是关进程。

换 hub 或不再提供服务时:anet hub-leave

anet hub-leave https://hub.agentnetwork.org.cn

{
  "aid": "bafyreiceynqbfjijwxepkoelwixvmjtg7un2ywjbl4moue32r6fkhtst6y",
  "status": "deregistered",
  "undelivered": 0
}

不给 URL 时默认离开当前配置里的那个 hub。要离开的通常是旧 hub,而那时配置往往已经指向 新 hub 了,所以这个参数是显式给的。

离开的正好是当前配置指向的那个 hub 时,daemon 还会顺手把本地的 hub_url 清空并停掉 中继轮询(internal/daemon/hub_client.go 的 forgetHubIfCurrent)。之所以是有条件的: 换 hub 的推荐顺序是先注册新 hub、再离开旧 hub,那时 hub_url 已经指向新 hub, 无条件清空等于把刚加入的 hub 也退掉。离开的是别的 hub 时本地配置不动。

这条判定是补上来的:此前注销只删了 hub 那一侧的路由,本地 hub_url 原样留着, 中继循环就继续每秒轮询一个刚刚拒绝了自己的 hub,每次被拒写一行日志(实测约 7.9 MB/天,没有轮转),而且因为地址还在 config.json 里,重启也不会停; anet status 和启动横幅同时还在说"已注册",因为两者读的都是 hub_url。

删掉的是路由:注册行、能力索引、签名卡片。留下的是证据:评价、回执、信用账本一条 不动 —— 它们是已经发生过的事的记录,因为一方搬走就删掉,等于为了让目录好看去改写历史。 密钥历史也会转存下来,这样这个 AID 签过的回执在它离开之后仍然验得动。

undelivered 是这个信箱里还没被取走的消息条数。大于 0 时响应里会多一个 warning 字段: 那些消息不会再被投递了,而发出它们的人正在等 —— 这个计数是他们能得到的唯一提示。

关进程:anet stop

anet stop            # 别名 anet down
anet stop <name>     # 停某个具名身份
anet stop --all      # 停这个 home 下所有在跑的身份

anet daemon stopping (data dir /home/you/.anet preserved). Restart with `anet up`.

它走的是控制面的优雅关闭:CLI 调 POST /shutdown,daemon 先回响应再排空退出, 不需要找 PID、不需要发信号。数据目录原样保留,anet up 再起来还是同一个身份。

error: anet up: unknown flag --all (it accepts: --detach)