常见问题
下面这些问题，是我们在安装、调试与长期运行中最常听见的疑问。
安装与平台
支持哪些操作系统？ Quatm 使用 Qt 6/PySide6，支持范围以 Qt 6.11 的支持矩阵为准：Windows 10（1809+）与 Windows 11（x86-64）、macOS 13 或更高版本，以及 Linux x86-64（Ubuntu 22.04/24.04、Debian 12 或同等环境）。ARM64 桌面支持有限，详见 Qt 6.11 支持平台矩阵。Python 3.9 及以上。
最低配置是什么？ 运行完整桌面界面与数据服务时，建议至少 8 GB 内存与 4 核 CPU。实时控制需要 FPGA 级控制器。
设备与驱动
是否必须使用特定硬件？ 不需要绑定单一厂商，但时序控制需要具备 TTL/DAC 输出的实时控制器。使用标准协议的仪器可以通过选择或编写驱动接入；工作量取决于协议与厂商 SDK。
如何接入自定义设备？
编写驱动类，并在 device_db.py 中以 type: local 注册；也可以通过 attr / generic_attr 映射通道。详见设备驱动。
支持哪些相机？ Andor、FLIR/BlackFly 等科学相机由驱动目录覆盖；其他相机可以通过项目本地驱动接入。
数据
数据以什么格式保存？ 实验数据归档为 HDF5，并可选启用流式传输或导出服务。
文件有多大？ 一次典型的吸收成像运行约为 10–50 MB，具体取决于图像数量与分辨率。长期实验应提前规划磁盘容量与保留策略。
升级
如何升级？ 更新 Python 环境并重新安装软件包，或拉取仓库后重新运行 bootstrap。请查阅发布说明以了解不兼容变更。
实验脚本会失效吗？ Quatm 的公共接口遵循语义化版本；重大变更会附带迁移说明。正式实验前请先在模拟环境中验证。