| 现象 | 解决 |
|---|
shimeta_infer: not found | 先执行 . /mnt/setup.sh |
wget: not found | 板卡没有 wget，联系技术支持获取替代安装方式 |
网络错误 | 确认板卡能访问 mirrors.shimetapi.cn |
| SD 卡挂载失败 | SD 卡设备可能是 mmcblk0p1，用 ls /dev/mmc* 确认 |
| 现象 | 解决 |
|---|
Model load failed: -8 | 模型版本和 NPU 不匹配，用模型平台重新编译的版本 |
No NPU device detected | 驱动没加载，联系管理员 |
| 结果全是 99%+ 但位置很随机 | 让模型平台检查 cv3 量化参数 |
| 结果置信度都 <5% | 同上，检查 cv3 的 scale/zp；或临时用 conf=0.01 |
| 模型 zip 加载失败 | 确认 zip 里有 neuron_network.xmm，且文件开头不是 PK 开头 |
| 现象 | 解决 |
|---|
| MJPEG 画面不显示 | 确认板卡 IP 能 ping 通，浏览器强刷页面 |
| VLC 画面花屏 | shimeta_svp 命令末尾加 h264 参数 |
如果模型 zip 不含 labels.txt，系统默认使用 COCO 80 类名。使用自定义标签时，在模型 zip 中包含 labels.txt（每行一个类名），或直接使用训练平台导出的包。
联系 ShiMetaPi 技术支持或访问社区论坛：https://www.shimetapi.cn/
