安装

方式一：npm（推荐）

需要 Node.js ≥ 18。安装的是打包并混淆后的 JS CLI（体积小），sharp 等原生依赖按平台自动安装：

npm install -g ventu-cli

验证：

ventu --version
ventu --help

系统要求

项目	要求
Node.js	≥ 18
系统	macOS / Linux / Windows
网络	能访问 npm

升级与卸载

npm update -g ventu-cli          # 升级
npm uninstall -g ventu-cli       # 卸载
rm -f ~/.ventu.json              # 清除本地配置（可选）

方式二：二进制 zip（无需 Node.js）

从 GitHub Releases 下载与你系统匹配的 zip 包：

平台	文件名示例
macOS Apple Silicon	ventu-x.x.x-darwin-arm64.zip
macOS Intel	ventu-x.x.x-darwin-x64.zip
Linux x64	ventu-x.x.x-linux-x64.zip
Windows x64	ventu-x.x.x-win32-x64.zip

解压后不要移动 vendor/ 目录——ventu 需要它与可执行文件在同一文件夹内。

# macOS / Linux
unzip ventu-*-darwin-arm64.zip
cd ventu-*-darwin-arm64
./ventu --version
./ventu config -a <授权码>

# Windows PowerShell
Expand-Archive ventu-*-win32-x64.zip
cd ventu-*-win32-x64
.\ventu.exe --version

可将解压目录加入 PATH，或把 ventu 链接到 /usr/local/bin（macOS/Linux）。

安装完成后前往 快速开始 配置授权码。