安装

osdk 提供 Windows、macOS 和 Linux 的预编译二进制。每个 Release 安装包会安装三个 同目录程序：主 CLI osdk、负责启动已激活工具的 osdk-shim，以及为 Aube 全局安装提供 进程隔离的内部辅助程序 osdk-aube。请始终把三个程序放在同一目录。

Linux 与 macOS

运行一键安装脚本：

curl --proto '=https' --tlsv1.2 -sSf \
  https://gh-proxy.com/https://raw.githubusercontent.com/lejunyang/one-sdk/main/install.sh |
  OSDK_DOWNLOAD_BASE_URL=https://gh-proxy.com/https://github.com sh

默认安装到 ~/.local/bin。请确认该目录已加入 PATH：

export PATH="$HOME/.local/bin:$PATH"

建议将这行加入 ~/.bashrc 或 ~/.zshrc。

Windows

在 PowerShell 中运行：

$env:OSDK_DOWNLOAD_BASE_URL = "https://gh-proxy.com/https://github.com"
irm https://gh-proxy.com/https://raw.githubusercontent.com/lejunyang/one-sdk/main/install.ps1 | iex

这些示例既代理 Raw 安装脚本，也通过 OSDK_DOWNLOAD_BASE_URL 代理脚本后续 下载的 GitHub Release 二进制和 SHA256SUMS。

默认安装到 %LOCALAPPDATA%\Programs\osdk\bin。如果安装器提示该目录不在 PATH，请将它加入当前用户的 PATH。

自定义安装

通过管道运行适合默认安装；需要传参时，应先下载脚本。

Unix 参数

curl -sSfL \
  https://gh-proxy.com/https://raw.githubusercontent.com/lejunyang/one-sdk/main/install.sh \
  -o install.sh

sh install.sh \
  --base-url https://gh-proxy.com/https://github.com \
  --version 0.0.1 \
  --install-dir "$HOME/bin" \
  --repository lejunyang/one-sdk \
  --target x86_64-unknown-linux-gnu

参数	环境变量	作用
--version	OSDK_VERSION	版本号，可带或不带 v；默认 latest
--install-dir	OSDK_BIN_DIR	二进制安装目录
--repository	OSDK_REPOSITORY	GitHub 的 owner/repo
--base-url	OSDK_DOWNLOAD_BASE_URL	GitHub 或下载镜像根地址
--target	OSDK_TARGET	覆盖自动识别的平台目标
--skip-verify	OSDK_SKIP_VERIFY=1	跳过 SHA-256 校验，不推荐

运行 sh install.sh --help 查看完整帮助。

PowerShell 参数

Invoke-WebRequest `
  https://gh-proxy.com/https://raw.githubusercontent.com/lejunyang/one-sdk/main/install.ps1 `
  -OutFile install.ps1

.\install.ps1 `
  -BaseUrl https://gh-proxy.com/https://github.com `
  -Version 0.0.1 `
  -InstallDir "$HOME\bin" `
  -Repository lejunyang/one-sdk `
  -Target x86_64-pc-windows-msvc

PowerShell 参数为 -Version、-InstallDir、-Repository、-BaseUrl、 -Target 和 -SkipVerify，也支持上表中的环境变量。

安装校验

两个安装器默认下载 Release 中的 SHA256SUMS 并验证归档。只有在你已经通过 其他可信渠道验证文件时，才应跳过校验。

从源码构建

需要 Rust 1.91.1 或更新版本；仓库默认固定 Rust 1.98.0：

git clone https://github.com/lejunyang/one-sdk.git
cd one-sdk
cargo build --locked --release

构建结果位于：

target/release/osdk
target/release/osdk-shim
target/release/osdk-aube

请把三个文件放在同一目录，并将该目录加入 PATH。osdk-aube 是随安装包提供的内部 实现辅助程序，通常不需要由用户直接运行。

如果已经安装 Rust，也可以从 crates.io 安装主命令和内部 Aube 辅助程序：

cargo install osdk-cli --locked

osdk-shim 是独立 package。需要完整的日常安装时仍推荐上面的 Release 安装器， 它会把 osdk、osdk-shim 和 osdk-aube 三个同版本程序一起安装。

在中国大陆可以先配置 rustup 镜像：

export RUSTUP_DIST_SERVER=https://rsproxy.cn
export RUSTUP_UPDATE_ROOT=https://rsproxy.cn/rustup
curl --proto '=https' --tlsv1.2 -sSf \
  https://rsproxy.cn/rustup-init.sh | sh -s -- -y

验证安装

osdk --version
osdk doctor

doctor 会显示数据目录、缓存目录、内容存储、安装目录、链接模式和后端状态。

第一次使用

# 安装 Node.js
osdk install node@20

# 设为全局默认并生成 shims
osdk use -g node@20

# 检查实际版本
node --version

也可以使用 shell 激活，不依赖固定 shim：

eval "$(osdk activate bash)" # 也支持 zsh、fish、powershell

继续阅读详细功能 →