第6章 Ante 更新机制与版本通道管理

# 更新与通道 Ante 以单个二进制文件的形式发布，并支持就地更新——执行首次安装的那份 install.sh 脚本，会在运行 ante update 时被重新执行，以检查当前二进制文件所跟踪的通道。 ## 更新 检查当前通道上是否有更新的 Ante 版本，如有则安装： ante update
如果存在更新版本，Ante 会运行同一通道的安装程序，安装完成后打印新版本号。重启 Ante 即可使用新版本。 如果已经是最新版本，Ante 会打印确认信息后直接退出，不会改动二进制文件。 ## 从 TUI 更新 当有新版本可用时，正在运行的 TUI 会在聊天中显示一条通知，附上更新日志预览，绝不会用模态框阻塞启动流程。 /update 安排该版本在你退出 Ante 时安装 /update cancel 保留更新提示，但取消已安排的退出安装 /update skip 永久跳过该版本；后续更高版本仍会提示 安装选择仅在当前会话内有效。Ante 会在退出并恢复终端后应用已确认的更新，下次启动时即使用新版本。 ## 锁定或回滚 使用 --version 安装指定版本： ante update --version v0.2.8
ante update --version 0.2.8
这会绕过通道"必须比当前版本新"的检查，因此可以升级、重装当前版本，或回滚到较早的已发布版本。回滚时，Ante 会记住你离开的版本，这样后台更新通知不会立刻提示你重装它。 ## 通道 发布通道是具名的构建版本轨道。Ante 发布两个通道： 通道描述stable推荐日常使用。由发布工作流发布的带标签版本。nightly基于开发分支构建。新功能和 bug 都会最先出现在这里。 默认通道是 stable。二进制文件跟踪的通道记录在所选设置文件的 channel 字段中。ante update 默认读取 ~/.ante/settings.json，除非你通过进程级的 --profile 标志选择一个已有的命名配置；TUI 也使用相同的所选配置来处理应用内更新通知。 {
"channel": "nightly"
}
将 channel 设为空字符串或直接省略，会回退到 stable。 latest 是已废弃的通道名称。设置或命令中仍在使用 latest 的地方都会被当作 stable 处理。 ## 切换通道 通道可以作为位置参数传入，也可以用 --channel 标志： # 位置参数形式
ante update nightly

# 标志形式
ante update --channel nightly


# 使用 ~/.ante/work.settings.json 中的 channel
ante --profile work update
这两种方式都会获取指定 channel 的清单，并基于该清单运行安装程序。这种覆盖仅对本次更新生效。若希望持久切换，请在未来运行将使用的配置文件（默认为 ~/.ante/settings.json，或指定的 profile 文件）中设置 "channel": "nightly"。 Channel 名称仅允许包含 ASCII 字母、数字、.、_ 或 -。 初始安装 安装程序接受相同的 channel 名称。若要在全新机器上安装非默认 channel：
curl -fsSL https://ante.run/install.sh | bash -s -- nightly
若不传参数，安装程序默认使用 stable。 默认情况下，安装程序将二进制文件写入 ~/.ante/bin。若需安装到已存在于 PATH 中的目录，请设置 ANTE_INSTALL_DIR：
curl -fsSL https://ante.run/install.sh | ANTE_INSTALL_DIR=/usr/local/bin bash
更新检查机制 Ante 在启动及长会话期间，会在后台查询更新缓存。针对不同 channel 清单的网络检查会在多个正在运行的 Ante 进程间共享，且每小时最多执行一次；检查结果和发布说明缓存在 ~/.ante/versions.json 中。当有新版本可用时，TUI 会添加前文所述的聊天内通知。ante update 会忽略缓存，始终获取最新清单。