主题
安装与准备
本篇先准备模型查看所需环境。完成前三步后,就能打开网页工作台;需要运行物理任务时,再完成下方 Isaac Lab 环境。
开始前确认
在完整仓库根目录执行命令。需要 Git、Git LFS、uv,以及 Node.js ^22.18.0 || ^24.11.0 || >=26.0.0。网页构建固定使用 pnpm 12.18.0,没有 pnpm 时构建入口会通过 npx 准备它。
当前规划原生 wheel 面向 CPython 3.12 / Linux ARM64 / glibc ≥ 2.39;物理运行还依赖匹配的 Isaac Sim 和 GPU/驱动能力。其他主机不能仅凭网页能打开就假定所有后端可用,具体环境限制见软件环境。
环境准备
取得 Git LFS 管理的 CAD 与网格,并安装 Python 工作区依赖:
sh
git lfs install
git lfs pull
uv sync --all-packages --extra cad预期三条命令正常结束。若下载失败,先解决网络或 LFS 资产问题;指针文件不能作为真实模型使用。Python 依赖进入项目环境,不安装到系统 Python。
交互工作台构建
sh
uv run pride build workbench等待构建成功。该入口安装锁定的网页依赖并生成客户端,首次可能需要下载。需要修改客户端协议的开发者另看协议参考。
打开并确认
sh
uv run pride doctor
uv run pride viewdoctor 输出工具、数据根目录和资产信息;它不是完整验收。view 启动后打开终端打印的地址,看到模型和“已同步”即可进入工作台教程。启动只准备模型,不初始化物理引擎或连接实机。
Isaac Lab 3 环境
先安装 backends/isaac/runtime.json 指定的原生 Isaac Sim。Isaac Lab 3 使用该运行时的 bundled Python 创建独立环境;这是上游启动器支持的 native-install venv 路径,不往原生安装中装包。可通过 PRIDE_ISAAC_ROOT 指定已有安装位置。
sh
PRIDE_LAB_INSTALL=$(uv run python -c 'from pride_core.isaac import installation; from pride_core.project import project_root; print(installation(project_root()))')
uv venv --python "$PRIDE_LAB_INSTALL/kit/python/bin/python3" backends/isaaclab/.venv
uv sync --project backends/isaaclab
uv run pride check isaaclab --timeout 300本机锁定官方 Isaac Lab 提交 67fe128(构建为 3.0.0+git.67fe128)、配套 Newton 提交 7f0c13a、Torch 2.11.0/cu130 和原生 Isaac Sim 6.2.0-rc.14。运行时入口会核对 Python 来源和原生版本,复用官方 python.sh 设置库路径;ARM64 cuSPARSELt wheel 复用仓库已有的可追溯标签修复。能力和验收边界见 Isaac Lab 集成。
只阅读文档
文档站可以独立构建,不需要模型资产、物理环境或设备:
sh
uv run pride build docs
npx --yes pnpm@12.18.0 --dir docs preview打开终端打印的本地地址。文档构建结果在 artifacts/docs/site/;源码 Markdown 和截图在 docs/,可以直接阅读。维护文档的方法见文档维护。