#安装 lab CLI

lab 是 OpenSDL 的命令行工具，可以操作本地设备服务，也可以构建 OCI 镜像、通过本地 daemon 管理资产、拆分 USD、推送和拉取，并管理本机的 kinematic 仿真实例。资产管理不依赖 Docker 或 LiyanLabs；只要安装 lab，第三方智能体就可以完成“发现 → 拉取 → 校验 → 运行 → 操作 → 停止 → 回收”。

#安装

安装器会识别操作系统和 CPU，下载最新公开发行版。Release 中的同一个 lab 可执行文件包含 CLI、本地资产 daemon、OCI 存储和 kinematic 运行时，无需 Rust 或源码构建。USD 拆分的额外解析依赖见下文；设备 schema、固件和硬件驱动单独准备。

#macOS / Linux

在终端执行：

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/ScienceOL/OpenSDL/releases/latest/download/lab-cli-installer.sh | sh

#Windows

在 PowerShell 执行：

powershell -ExecutionPolicy Bypass -c "irm https://github.com/ScienceOL/OpenSDL/releases/latest/download/lab-cli-installer.ps1 | iex"

也可以在 GitHub Releases 下载对应平台的压缩包和 SHA-256 校验文件，解压后将可执行文件所在目录加入 PATH。

#确认安装

安装完成后打开一个新终端：

lab --version
lab --help
lab daemon --help
lab build --help
lab split --help
lab pull --help
lab run --help
lab ps --help

包名和安装器名使用 lab-cli，日常命令是 lab。使用 v0.3.1 或更新版本；帮助中应包含 daemon、build、split、images、run、ps、logs 和 rm。缺少命令时重新运行 Release 安装器。

如果提示找不到 lab，按安装器输出检查 PATH。默认可执行文件目录是 macOS / Linux 的 ~/.cargo/bin 和 Windows 的 %USERPROFILE%\.cargo\bin；设置了 CARGO_HOME 时，使用该目录下的 bin。

#更新

先用旧版本执行 lab daemon stop，再重新运行安装器或更新工具，最后用新版本执行 lab daemon start。Windows 替换可执行文件前也要停止托管实例。

lab-cli-update

手动解压安装的用户可从 Releases 下载新版本并替换可执行文件。

#USD 拆分的可选运行时

build、push、pull、daemon 和 kinematic 实例由 Release 自带。lab split 还需要 OpenUSD Python；先安装 Python 3.12，再安装固定版本的解析运行时。

macOS / Linux：

python3.12 -m venv "$HOME/.local/share/opensdl-usd"
"$HOME/.local/share/opensdl-usd/bin/python" -m pip install usd-core==25.11
export LAB_USD_PYTHON="$HOME/.local/share/opensdl-usd/bin/python"

Windows PowerShell：

py -3.12 -m venv "$env:LOCALAPPDATA/opensdl-usd"
& "$env:LOCALAPPDATA/opensdl-usd/Scripts/python.exe" -m pip install usd-core==25.11
$env:LAB_USD_PYTHON = "$env:LOCALAPPDATA/opensdl-usd/Scripts/python.exe"

每次新开终端需重新设置 LAB_USD_PYTHON；也可以给 lab split 传入 --python 和该解释器的绝对路径。解析脚本已嵌入 Release，不需要源码仓库。

#从源码安装（开发者）

开发 CLI 或需要自行构建时，先准备 Rust 1.89 或更新版本的工具链和 Git，再执行：

git clone https://github.com/ScienceOL/OpenSDL.git
cd OpenSDL

正常使用直接安装 Release；仅在开发 OpenSDL 或自行编译时执行：

cargo install --locked --path crates/lab-cli

然后确认新命令：

lab asset --help
lab instance --help
lab run --help
lab ps --help

如果系统没有 Rust，先安装 rustup，再重开终端执行上面的命令。源码构建需要 Rust 1.89 或更新版本和 Git；Protobuf 编译器由构建依赖提供，不需要单独安装。

设备接入所需的配置、设备 schema 和固件按 OpenSDL 设备指南 准备；CLI 安装器只安装可执行程序。

安装完成后，继续 Hub Quick Start。如果目标是运行内置示例，再阅读运行实例。