常见问题

Windows 系统

FPGA 控制器驱动

需安装厂商提供的 SDK，FPGA 需要按照实际需求定义和烧录timetable。模拟模式下无需实际硬件。

Linux 系统

Qt 图形库依赖

sudo apt install libxcb-cursor0 libxcb-xinerama0 libegl1-mesa

相机权限

Andor / BlackFly 需配置 udev 规则。

Windows Subsystem for Linux (WSL)

WSL 用户请确保在 Linux 文件系统挂载上运行，避免在 Windows 文件系统上操作导致意外错误。

Web 远程控制平台（quatm.web）

旧版本安装缺少 quatm.web 子包

从旧版本升级时 Web Hub 启动报错并提示缺少子包：重新执行 pip install -e . 即可（quatm.web 随 quatm 核心一起安装）。

与桌面 GUI 同时操作同一进程

桌面进程管理器与 Web 进程页同时管理同一批服务/GUI。任一入口启动条目前会 先终止另一入口管理的实例，避免双开；若发现进程被意外重启，检查是否在另一端 执行了启动操作。