Skip to content

v1.1.9

Choose a tag to compare

@github-actions github-actions released this 14 Sep 06:41
· 2 commits to master since this release

v1.1.9 · 2026-09-14

  1. 新增产品 CLI 统一入口

    新增 ve arkclive tosutil,可通过 ve 调用方舟和对象存储产品 CLI。子命令后的参数原样转发,保留各工具自身的参数语法和输出格式;ve toscli 保留为 ve tosutil 的兼容别名。

  2. 支持按需安装与托管升级

    优先使用系统 PATH 中已安装的工具,其次使用 ve 托管版本;尚未安装时,首次调用会从火山引擎 CDN 自动下载,并校验 SHA-256。在线 manifest 不可用时使用内嵌固定版本清单,Ark CLI 的内嵌回退版本为 1.0.27

    新增 ve proxycli upgrade,支持安装或升级全部托管工具,也可指定 arkclitosutil,使用 --yes 跳过确认。系统 PATH 中的外部安装仍由原包管理器维护。托管目录默认为 ~/.volcengine/proxy-cli/bin,可通过 VOLCENGINE_CLI_PROXY_PATH 自定义。

  3. 支持登录会话刷新与可靠的进程转发

    执行代理命令前,尝试刷新当前 Console Login 会话中即将过期的临时 STS 凭证;未登录或刷新失败时仍继续转发,帮助和版本命令跳过刷新。Unix 使用 exec 将终端与信号处理交给子 CLI,Windows 保留子进程退出码;同时支持安装状态损坏后的恢复和自定义托管目录的状态隔离。

  4. 新增托管工具更新提醒与 npm 可选预装

    托管工具支持独立的后台版本检查,发现新版本后提示执行 ve proxycli upgrade,检查不阻塞子 CLI。设置 VOLCENGINE_CLI_DISABLE_UPDATE_CHECK=1 可关闭后台检查。npm 安装默认按需获取代理 CLI,设置 VOLCENGINE_CLI_INSTALL_PROXY_CLIS=1 可在安装 ve 时同时预装。中英文文档补充了代理命令用法及各产品 CLI 的官方文档入口。

使用示例:

ve arkcli --help
ve tosutil help
ve proxycli upgrade
ve proxycli upgrade tosutil --yes

参数与认证说明:子 CLI 支持的参数应放在 arkclitosutil 后;ve 原生 API 的 --profile--region--endpoint 不能放在代理命令前。各产品 CLI 使用自身的认证和配置规则,Console Login 会话刷新不会自动转换 ve 的全部认证或 profile 配置。

完整变更:v1.1.8...v1.1.9