跳到主要内容

版本更新与发布通道

Ante 以单一二进制文件分发并支持原地自我更新 —— 首次安装使用的 install.sh 脚本会被 ante update 针对当前二进制追踪的通道重新运行。

本指南对应 v0.3.2（2026 年 11 月 1 日）。运行 ante --version 可查看已安装版本。

检查与更新​

检查当前通道是否有更新的 Ante 发行版并在可用时安装：

ante update

若存在新版本，Ante 会运行对应通道的安装程序，并在安装就绪后打印新版本号。重启 Ante 即可使用新版本。

发布清单提供下载大小时，安装程序会在下载行显示该大小，并在验证新二进制文件后替换现有文件。下载或验证失败时，现有二进制文件会保留。

如果当前已是最新版本，Ante 会打印确认信息并退出，不会修改二进制文件。

在 TUI 终端界面中更新​

当有新版本可用时，正在运行的 TUI 会在聊天界面中显示包含 Release Notes 摘要的轻量提示。绝不会使用弹窗打断启动。

  • /update：安排在退出 Ante 时自动安装该版本
  • /update cancel：保留更新提示，但取消退出时自动安装的计划
  • /update skip：永久忽略当前版本；后续有更新的版本时仍会提示

安装选择仅作用于当前运行的会话。Ante 在退出并恢复终端后完成更新应用，下次启动即进入新版本。

锁定或回滚版本​

使用 --version 安装指定版本：

ante update --version v0.3.2
ante update --version 0.3.2

该方式会跳过通道的“版本更新校验”，因此可用于升级、重新安装当前版本，或回滚到已发布的历史版本。回滚时，Ante 会记录您回滚前的版本，避免后台更新提示立即建议重新安装。

发布通道​

发布通道是特定构建流的命名跟踪分支。Ante 提供两个通道：

通道说明
stable推荐日常使用。经过发布流程验证的稳定标签版本。
nightly基于开发主分支构建。新功能与 Bug 修复首先在这里发布。

默认通道为 stable。二进制追踪的通道保存在所选设置文件的 channel 字段中。ante update 默认读取 ~/.ante/settings.json；传入进程级 --profile 参数可选择已有的命名 Profile。TUI 的更新提示也会使用同一 Profile。

{
  "channel": "nightly"
}

将 channel 设置为空字符串或省略该字段时，将回退至 stable。

latest 是已废弃的历史通道名称。现有设置或命令中若仍使用 latest，将被视为 stable。

切换发布通道​

通过位置参数或 --channel 切换通道：

# 位置参数形式
ante update nightly

# 参数标识形式
ante update --channel nightly

# 使用 ~/.ante/work.settings.json 中的通道
ante --profile work update

前两种形式均会获取指定通道的发布清单并执行更新。此覆盖仅对单次更新生效；若希望永久切换，请在后续运行使用的设置文件中配置 "channel": "nightly"（默认为 ~/.ante/settings.json，或所选 Profile 文件）。

通道名称仅可包含 ASCII 字母、数字、.、_ 或 -。

首次全新安装指定通道​

安装脚本同样支持传入通道名称。在全新机器上安装非默认通道：

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

安装程序会为支持的 Shell（Bash、Zsh、Fish、sh 和 ash）配置 PATH。打开新终端后可直接运行 ante；如需在当前终端立即启动，请使用安装程序打印的完整路径。在 GitHub Actions 中，安装目录也会写入 GITHUB_PATH，供后续步骤使用。

若希望自行管理 PATH，并保持 Shell 启动文件及 GITHUB_PATH 不变：

curl -fsSL https://ante.run/install.sh | NO_MODIFY_PATH=true bash

更新检查机制​

在启动以及长会话运行期间，Ante 会在后台异步检查更新缓存。针对通道清单的网络请求由所有运行中的 Ante 进程共享，最多每小时检查一次；检查结果和发布说明会缓存在 ~/.ante/versions.json 中。当有新版本时，TUI 会显示上述轻量提示。ante update 命令行会忽略本地缓存，实时重新拉取清单。

升级到 v0.3​

v0.3.0 修改了 ~/.ante/catalog.json 中的凭据配置方式，以及 ~/.ante/settings.json 中 MCP 服务器的凭据配置方式。旧设置不会自动转换。按旧方式编写的目录条目会在启动时被跳过，并提示应替换为何种写法（ante doctor 会列出这些条目）；带有旧 oauth 配置块的 MCP 服务器会连接失败，并说明处理方法。

最简单的方式： 运行 ante，让它帮你完成迁移，例如输入 “把我的 catalog.json 和 settings.json 更新到 v0.3”。Ante 内置的指南了解这些变更，会直接为你改写文件。

已存储的 API 密钥和登录状态会自动保留。MCP 服务器的登录不会保留：请为每个服务器运行一次 ante auth login <server>。

手动迁移对照表：

旧写法v0.3
"auth": { "bearer": { "env_key": "MY_KEY" } }"credential": "env:MY_KEY"
"auth": { "header": { "name": "x-api-key", "env_key": "MY_KEY" } }"credential": "env:MY_KEY", "credential_header": "x-api-key"
"auth": { "bearer": { "oauth_preset": "anthropic" } }"credential": "oauth:anthropic"
"auth": { "query": { … } }不再支持
"auth": null，或无需密钥的提供商未设置 auth"credential": null（省略 credential 时，现在会读取通过 ante auth add <provider> 存储的密钥）
"http_headers": { … }"headers": { … }
请求头中的 "{session_id}""${session_id}"
顶层 "models": { "<id>": { … } }"providers": { "<provider>": { "preferred_models": [{ "id": "<id>", … }] } }
--provider antix-api-key--provider antix（同样会读取 ANTIX_API_KEY）
MCP 服务器上的 "oauth": { … }删除该配置，并运行 ante auth login <server>
ante mcp login <server> / ante mcp logout <server>ante auth login <server> / ante auth logout <server>
ante auth login（默认 Antix）、--forceante auth login antix；再次运行 login 总会重新登录

新设置请参阅凭据与 MCP 认证。