已知问题

下表列出当前版本已确认的问题及推荐的变通方法。

问题	变通方法
IDE 不会下载 YOLO 模型	手动将其下载到目标设备上的 `/etc/models`
扩展无法与 Ubuntu 上的 VS Code Snap 软件包配合使用	安装 `.deb` 软件包 — 参阅在 Ubuntu 上安装 VS Code
开发套件出厂时固件可能过旧	使用入门向导烧录最新镜像
烧录后初始化脚本不会自动运行	烧录后，运行 Dashboard → SDK → Configure Device
使用 QLI 1.3 或更早版本的 Rubik Pi 需要额外的 UFS 配置	在使用扩展之前，请在 IDE 之外完成 UFS 配置步骤
在 macOS / UTM 环境中的测试有限	为获得最佳体验，请使用 Ubuntu 22.04 或 Windows + WSL
在 Ubuntu 24.04 主机上的测试有限	Ubuntu 22.04 是推荐且经过完整测试的主机

对于运行 Qualcomm Linux 软件版本 1.3 或更早版本的设备，需要在 IDE 之外执行额外的 UFS 配置和 CDT 编程步骤。这些步骤请参阅 Qualcomm 开发者文档。