faq.md

常见问题解答 (FAQ)

安装与运行相关问题

Q: 启动时报错：`qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.`

可参考#541、#496。

Q: GPU版本运行时闪退？

可参考#500。

界面交互相关问题

Q: 应用启动时，首次点击无效？

此问题暂时无解。

模型相关问题

Q: 下载完的模型每次重新启动应用时都被自动删除重新下载

注意模型路径不得有中文字符，否则会有异常。（#600）

Q: AI模型推理时如何识别特定的类别？

当前仅支持部分模型设置此选项。具体地，以 yolo 系列模型为例，用户可通过在配置文件中添加 filter_classes，具体可参考此文档。

Q: in paint assert len(self.points) in [1, 2, 4] AssertionError.

可参考#491。

Q: 加载自定义模型报错？

可参考以下步骤解决：

1. 检查配置文件中的定义的类别与模型支持的类别列表是否一致。
2. 使用 netron 工具比较自定义模型与官方对应的内置模型输入输出节点维度是否一致。

Q: 运行完没有输出结果？

可参考#536。

Q: 使用 Grounding DINO 模型进行 GPU 推理时报错：

Error in predict_shapes: [ONNXRuntimeError] : 1 : FAIL : Non-zero status code returned while running Expand node. Name:'Expand_33526' Status Message: Expand_33526: left operand cannot broadcast on dim 2 LeftShape: {1,900,4}, RightShape: {1,900,256}

可参考#389。

Q: Missing config : num_masks

可参考#515。

Q: AttributeError: 'int' object has no attribute 'replace'

查看配置文件是否有定义纯数字标签。请注意在定义以**纯数字**命名的标签名称时，请务必将其加上单引号 `''`

Q: Unsupported model IR version: 10, max supported IR version: 9

ONNX Runtime 版本过低，请更新：

# 安装 CPU 版本
pip install --upgrade onnxruntime

# 安装 GPU 版本
pip install --upgrade onnxruntime-gpu

Q: Your model ir_version is higher than the checker's.

onnx 版本过低，请更新：

pip install --upgrade onnx

标签导入导出相关问题

Q: Export mask error: "imageWidth"

可参考#477。

Q: operands could not be broadcast together with shapes (0,) (1,2)

可参考#492。

Q: 导出关键点标签时报错：int0 argument must be a string, a byteslike object or a number, not 'NoneType'

group_id字段缺失，请确保每个矩形框和关键点都有对应的群组编号。

Q: 'NoneType' object has no attribute 'shape'

检查文件路径是否包含中文字符。