# 环境配置 主场景回放与杯身中段搜索使用 Python 3.12 + venv: ~~~bash python3.12 -m venv .venv .venv/bin/python -m pip install -r requirements-sim.txt .venv/bin/python scripts/prepare_snapshot.py ~~~ Ubuntu 系统组件:python3.12-venv、libgl1、libegl1、libglfw3。图形回放需要桌面显示;无头模型检查使用 MUJOCO_GL=egl。 ## 可选工具 | 用途 | 安装 | | --- | --- | | 网格检查、几何构建 | .venv/bin/python -m pip install -r requirements-geometry.txt | | D405 采集 | .venv/bin/python -m pip install -r requirements-camera.txt | | 旧 mink 抓取演示 | .venv/bin/python -m pip install -r requirements-demo.txt | | STEP 转网格 | .venv/bin/python -m pip install -r requirements-cad.txt | | 历史控制器/手部工具 | .venv/bin/python -m pip install -r requirements-controller.txt | 旧演示依赖已固定版本;CAD 依赖按上游解析,尚未完成各可选环境的全新安装验证;历史硬件工具不属于默认仿真流程,不应为环境检查而运行。 HUG 推理使用其自身兼容 venv、源码与 hug_full.safetensors;MANO 按提供方条件取得。重定向可单独创建 Python 3.12 的 .retarget 环境,安装 requirements-retarget.txt,并准备 retarget_l20_v2.py 及其配置。回放现有候选无需这些工具。 ## 可选资源配置 在运行相关入口前 export 对应变量;Python 工具的相对配置以仓库根目录为基准。config/local.env.example 提供示例。 | 变量 | 默认位置/用途 | | --- | --- | | HUG_ROOT | external/hug;HUG 源码 | | HUG_PYTHON | HUG_ROOT/.venv/bin/python | | HUG_CHECKPOINT | HUG_ROOT/checkpoints/hug_full.safetensors | | RETARGET_PYTHON | .retarget/bin/python | | RETARGETING_ROOT | external/retargeting,需含 l20/retarget_l20_v2.py 和 config/l20 | | LINKERHAND_SDK_ROOT | external/linkerhand-python-sdk;仅历史映射工具使用 | | P7_SCENE_XML | external/p7_bimanual/model.xml;旧场景构建器使用,旁边需有 meta.json,可由 wasm-bimanual-grasp 的 P7 场景提供 | | G20_LEFT_TABLE | assets/L20/LEFT/g20_left_G20.json;当前设备标定,不可直接套用其他设备 | | CALIBRATED_LEFT_URDF | external/calibrated_left/linkerhand_g20_left.urdf;离线标定诊断专用,需相邻网格,缺失时不替换成未标定模型 | | REFERENCE_LEFT_URDF | external/reference/l20_left_with_tips.urdf;独立坐标对比基准 | | HAND_ADAPTER_STEP | external/hand_adapter.STEP;重新测量法兰时使用 | | A7_SDK_LIBRARY | external/a7_sdk/liblbot_api_cpp.so.1.0.5;可选厂家库 | | A7_BRIDGE_SETUP | 现场 ROS 桥的 setup.bash;仅相关历史硬件工具使用 | 外部源码、权重、参考标定模型和 SDK 需另外提供。修改路径不会改变模型物理参数或控制保护。