Windows
ZhiMuStereo-0.2.6-windows-x64.zip
解压到 F:\ZhiMuStereo\apps，进入解压后的 ZhiMuStereo-0.2.6，双击 Start Camera.cmd。
一套相机软件，按用途使用
每个系统只需要一个安装包。先打开相机拍一张照片；需要写代码或接 ROS 时，再启用对应入口。
1. 拿到你系统的完整包
Linux
ZhiMuStereo-0.2.6-linux-x64.zip
解压到自己的用户目录。桌面运行 bash start-camera.sh；没有桌面运行 bash camera.sh devices。
完整包已包含程序、命令行、Python 安装资源和加密模型；Linux 包还包含 ROS 2 Jazzy 的离线安装资源。内部 GPU 资源保持压缩状态，没有可用 GPU 时不会解压或安装，也不会另外下载。
2. 这些名字分别负责什么？
GUI
点击按钮CLI
终端命令Python SDK
写 Python 程序ROS
发布机器人消息
点击按钮CLI
终端命令Python SDK
写 Python 程序ROS
发布机器人消息
同一套相机核心：控制 → 采集 → 校正 → 视差 / 深度 → 保存
推理自动选择：TensorRT → CUDA → Windows DML → CPU
| 你想做什么 | 使用入口 | 操作 |
|---|---|---|
| 拍照、录像 | GUI | 打开启动程序 |
| 无桌面拍照、脚本调用 | CLI | 运行随包命令行 |
| Python 拍照和读取深度 | SDK | setup.cmd --sdk 或 bash setup.sh --sdk |
| 机器人视频、深度、点云 | ROS | Linux：bash setup.sh --ros |
| 下载管理平台标定 | GUI 云端标定 / SDK | 启用 SDK 助手，登录并绑定资产 |
GPU 是推理加速能力。它由各入口自动使用，客户无需再挑选 GPU 产品或拼装额外相机包。
3. 相机打开后先这样用
- 插入相机，刷新设备并打开，核对硬件序列号。
- 先普通拍照：关闭“拍照时生成深度”，拍一张，确认左右图。
- 需要深度时，导入这台相机的标定或通过“云端标定”下载，再启用深度，档位先用四分之一。
- 需要录像时，点击开始 / 停止录像。录像保存原始视频；按需拍照仍可输出本次视差和深度。
后端保持 auto。有可用 GPU 优先加速；无可用 GPU 直接 CPU，不下载、安装 GPU 环境或构建引擎。CPU 处理大图会更慢，可以先用四分之一档。