系统要求

  • macOS 12+ 或 Linux (x86_64 / ARM64)
  • Windows 10+ (PowerShell)
  • Node.js 18+（用于 npm 安装）
  • Rust 1.75+（用于从源码构建）

安装方式

curl (macOS / Linux)

最快的安装方式：

curl -fsSL https://alius.tech/install | sh

Windows PowerShell

irm https://alius.tech/install.ps1 | iex

npm

通过 npm 全局安装：

npm install -g @alius-tech/alius

npm 包的安装原理：

  1. 检测 process.platform 和 process.arch
  2. 解析对应的平台二进制包或本地开发二进制
  3. 启动原生 alius 二进制
  4. 转发 stdio 和进程信号

支持的平台包会随 @alius-tech/alius 主包自动安装。

Homebrew

brew tap AliusTech/tap
brew install alius

从源码构建

git clone https://github.com/AliusTech/alius.git
cd alius
cargo build --release

二进制文件位于 ./target/release/alius。

验证安装

alius --version

确认版本号正确输出即可。

全局参数

你可以在任何 Alius 命令前使用以下全局参数：

参数作用备注
--model <model>覆盖当前命令的默认模型alius run --model 是最明确的消费路径
--provider <provider>覆盖默认提供商部分分发路径可能未消费此参数
--workspace <path>指定工作空间目录部分分发路径可能未消费此参数
--config <path>指定自定义配置文件主分发当前直接调用 Settings::load()
--verbose设置日志详细程度日志行为以实际代码路径为准

全局参数在 CLI 类型定义中声明，但并非所有分发路径都会消费每一个参数。以 alius run --model 为例，这是最明确的一次性模型覆盖参数。

下一步