v1.1.9
v1.1.9 · 2026-09-14
-
新增产品 CLI 统一入口
新增
ve arkcli和ve tosutil,可通过ve调用方舟和对象存储产品 CLI。子命令后的参数原样转发,保留各工具自身的参数语法和输出格式;ve toscli保留为ve tosutil的兼容别名。 -
支持按需安装与托管升级
优先使用系统
PATH中已安装的工具,其次使用ve托管版本;尚未安装时,首次调用会从火山引擎 CDN 自动下载,并校验 SHA-256。在线 manifest 不可用时使用内嵌固定版本清单,Ark CLI 的内嵌回退版本为1.0.27。新增
ve proxycli upgrade,支持安装或升级全部托管工具,也可指定arkcli或tosutil,使用--yes跳过确认。系统PATH中的外部安装仍由原包管理器维护。托管目录默认为~/.volcengine/proxy-cli/bin,可通过VOLCENGINE_CLI_PROXY_PATH自定义。 -
支持登录会话刷新与可靠的进程转发
执行代理命令前,尝试刷新当前 Console Login 会话中即将过期的临时 STS 凭证;未登录或刷新失败时仍继续转发,帮助和版本命令跳过刷新。Unix 使用
exec将终端与信号处理交给子 CLI,Windows 保留子进程退出码;同时支持安装状态损坏后的恢复和自定义托管目录的状态隔离。 -
新增托管工具更新提醒与 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 支持的参数应放在 arkcli 或 tosutil 后;ve 原生 API 的 --profile、--region、--endpoint 不能放在代理命令前。各产品 CLI 使用自身的认证和配置规则,Console Login 会话刷新不会自动转换 ve 的全部认证或 profile 配置。
完整变更:v1.1.8...v1.1.9