Upgrade & Version

turing-cli upgrade 用于检查和安装新的 CLI 版本。turing-cli version 用于查看当前版本、commit、构建时间和运行平台。

upgrade check

turing-cli upgrade check [flags]

只检查版本和可写性,不会修改本机文件。

参数	默认值	说明
--version VERSION	latest	目标版本;可以是 latest 或具体版本号
--base-url URL	发布默认地址	升级元数据根 URL
--json	false	输出 JSON,适合脚本或 UI 集成
-h, --help		查看命令帮助

示例:

turing-cli upgrade check
turing-cli upgrade check --json
turing-cli upgrade check --version 0.1.5-rc2

upgrade apply

turing-cli upgrade apply [flags]

下载并安装可用的新版本。别名:

turing-cli upgrade update
turing-cli upgrade run

参数	默认值	说明
--version VERSION	latest	目标版本;可以是 latest 或具体版本号
--base-url URL	发布默认地址	升级元数据根 URL
--json	false	输出 JSON
-h, --help		查看命令帮助

升级流程:

1. 下载 manifest。
2. 根据当前 OS / arch 选择 artifact。
3. 下载 artifact。
4. 校验 SHA-256。
5. 解压并替换当前 turing-cli 二进制。

如果任一步失败,旧二进制不会被替换。

latest 与 prerelease

latest 只指向稳定版本。0.1.5-rc1、0.1.5-rc2 这类 prerelease 会上传到对应版本目录,但不会推进 latest。

turing-cli upgrade apply

只会追 stable latest。要安装 prerelease,需要显式指定版本:

turing-cli upgrade apply --version 0.1.5-rc2

JSON 输出

{
  "current_version": "0.1.5-rc1",
  "latest_version": "0.1.5-rc2",
  "status": "upgrade_available",
  "artifact_url": "https://.../turing-cli_0.1.5-rc2_Darwin_arm64.tar.gz",
  "writable": true,
  "installed": true
}

常见 status:

status	含义
latest	当前版本已是目标版本或更高
upgrade_available	有可安装的新版本
unknown_current_version	当前二进制不是 release 构建,无法比较版本
unsupported_platform	当前 OS / arch 没有对应安装包

version

turing-cli version

输出示例:

turing-cli 0.1.5 (commit abc1234, built 2026-06-23T10:00:00Z, darwin/arm64)

注意事项

• Windows 暂不支持原地替换正在运行的二进制;请使用安装脚本重装。
• 如果安装目录不可写,apply 会停止并提示目录不可写。
• 如果 SHA-256 校验失败,不会替换旧二进制。
• go run 或本地开发构建通常显示为 dev,会返回 unknown_current_version。