Linux：桌面与无桌面都能用

桌面和无桌面使用同一个完整包。当前预编译目标为 Ubuntu 24.04 x86_64，无需安装 C++ 或 Qt 开发环境。

1. 解压到用户目录

下面以 ZIP 在 Downloads 目录为例；如果在别处，替换路径。

mkdir -p "$HOME/ZhiMuStereo/apps"
unzip "$HOME/Downloads/ZhiMuStereo-0.2.6-linux-x64.zip" -d "$HOME/ZhiMuStereo/apps"
cd "$HOME/ZhiMuStereo/apps/ZhiMuStereo-0.2.6"

后续命令都在这个完整包目录执行。无需 sudo 安装程序；USB 设备权限由管理员设置。

2. 有桌面：图形界面

bash start-camera.sh

插入相机，刷新并打开，先普通拍照，再导入标定并启用深度。录像从主窗口开始 / 停止。

3. 没有桌面：命令行

bash camera.sh devices
bash camera.sh capture --serial YOUR_CAMERA_SERIAL --without-depth
bash camera.sh record --serial YOUR_CAMERA_SERIAL --duration 10

需要深度时先导入该相机的标定：

bash camera.sh calibration import /path/to/this-camera.yaml --vid 15AA --pid 1555 --serial YOUR_CAMERA_SERIAL
bash camera.sh capture --serial YOUR_CAMERA_SERIAL --with-depth --profile quarter

VID/PID 和 YAML 必须对应实际设备。

4. 按需启用 Python 或 ROS

bash setup.sh --sdk
# 只在需要 ROS 2 Jazzy 时运行：
bash setup.sh --ros

分别看 Python 和 ROS 使用步骤。无可用 GPU 时只使用 CPU，完全跳过 GPU 安装。

Linux 不使用 Windows DML。本版 Linux Intel / AMD 核显使用 CPU。Ubuntu 20.04 / 22.04 需要匹配构建和独立实际系统验收。