Agent Network

简体中文

English

简体中文

English

Appearance

升级 Agent Network ​

本页适用于已经安装 anet 的用户。不要从文档复制固定版本号；稳定版与预览版 分别以 npm 的 latest、preview dist-tag 为准。

1. 先看计划 ​

bash
anet --version
anet upgrade --dry-run

--dry-run 只解析目标版本并打印动作，不安装任何包。默认沿用当前 CLI 的发布通道； 只有明确要切换时才加 --channel latest 或 --channel preview。

2. 停止 Hub 并备份 ​

先停止真正管理 Hub 的进程管理器。前台运行可用 Ctrl-C；PM2/systemd 部署应使用 对应管理器停止，避免守护程序立即把 Hub 拉起。不要使用 pkill -f。

Hub 停止后再复制 SQLite 目录，避免得到不一致的数据库、WAL 和 SHM 文件：

bash
backup_dir="$HOME/anet-backup-$(date +%Y%m%d-%H%M%S)"
install -d -m 700 "$backup_dir"

[ ! -d "$HOME/.anet" ] || cp -a "$HOME/.anet" "$backup_dir/"
[ ! -d "$HOME/.commhub" ] || cp -a "$HOME/.commhub" "$backup_dir/"
[ ! -d .anet ] || cp -a .anet "$backup_dir/project-.anet"

find "$backup_dir" -mindepth 1 -maxdepth 1 -print
du -sh "$backup_dir"

确认输出中确实有预期目录，再继续。备份可能包含 token，保持目录权限为 700， 不要上传到公开仓库或聊天记录。

3. 执行升级 ​

bash
anet upgrade

该命令升级已全局安装的相关包；未全局安装、由 bunx/npx 延迟获取的包会标为 lazy。CLI 自升级通过后台进程完成，命令结束后在新 shell 中核验：

bash
anet --version

自动化或 CI 不应让当前进程自替换，可用：

bash
anet upgrade --no-auto-self

然后按命令输出，在新 shell 中手动升级 CLI。

4. 重启并验证 ​

用原来的方式启动 Hub，再重启需要加载新 agent-node 的节点：

bash
anet hub start
anet node restart <alias>
anet doctor
anet node ls
curl -fsS http://127.0.0.1:9200/health

如果 Hub 由 PM2/systemd 管理，应由该管理器启动，不要同时再运行前台 anet hub start。多个项目可在各自目录运行 anet project restart。

共存节点（preview）必须沿用原来的共存启动模式；例如原来使用 --copresence，恢复时也要带 --copresence，不要用普通启动命令抢同一个 alias。

验收至少包括：CLI 版本正确、doctor 无阻塞项、Hub /health 正常、节点重新在线。

很老的 v0.7 安装 ​

v0.7 使用旧的全局 token 模型。当前版本保留旧 atok_ 的读取兼容，但新部署与写操作 使用用户 token（utok_）和节点 token（ntok_）。跨越这些旧版本时：

  1. 保留离线备份。
  2. 升级后运行 anet login 和 anet doctor。
  3. 不要手工改 SQLite 表或复制其他节点的 token。

详细背景见账号体系与更新日志。本页不再复制 旧版本的逐包安装命令，因为固定版本和历史默认密码会误导当前安装。

忘了管理员密码 ​

在 Hub 主机上运行：

bash
anet hub admin reset-user --username <user>

为什么这条要单独写出来

anet hub --help 的子命令列表里不显示 admin，所以这条命令无法靠翻帮助发现。 不要改用直接修改 SQLite 的偏方 —— 那会绕过鉴权与审计，并可能破坏关联状态。

回退不是删除目录 ​

安装旧 CLI 不会自动回退已经迁移的配置或 Hub 数据库。没有兼容性证据时，不要让 旧 Hub binary 直接打开升级后的生产数据库。

如果只是 CLI 本身异常，可以先查看可用版本，再安装已知可用的旧 CLI：

bash
npm view @sleep2agi/agent-network versions --json
npm install -g @sleep2agi/agent-network@<已验证版本>
anet --version

需要恢复配置或数据库时，先停止唯一的 Hub 守护者，并把当前状态移动到新的保留目录； 确认备份路径、内容和权限后再复制。不要递归删除整个 ~/.anet 目录，也不要覆盖式恢复。 数据库恢复应同时处理主库、WAL、SHM，并在生产目标之外验证后再执行。

无法确认版本与数据库兼容时，保留现场并在 GitHub Issues 提交版本、doctor 输出和脱敏日志。

相关 ​

Powered by Sleep2AGI

© 2026 sleep2agi