模型与部署

模型 Tab

Q：模型 Tab 加载失败？

可能原因	解决方法
PC 无法访问 aihub.shimetapi.cn	检查网络
AIHub Token 过期	重新登录
服务端维护	等待或联系官方

Q：找不到自己训练的模型？

可能原因	解决方法
训练未完成	AIHub 训练任务状态应为"已完成"
未导出 .xmm 格式	训练完成后必须导出 XMM 格式
选错 Tab	切到"用户模型"子 Tab

Q：模型卡片只有 PT/ONNX？

说明训练后导出时未选 XMM 格式。重新在 AIHub 训练详情页导出 XMM。

详见 AIHub 文档 → 导出格式。

Q：能在 IDE 外下载模型吗？

可以。在 AIHub 网页端也能下载 .xmm.zip，然后：

工作台 → 本地模型 → 导入本地模型
选择已下载的 zip

Q：模型 zip 包有多大？

模型	典型大小
yolov8n	6-12 MB
yolov5n	5-10 MB
自定义数据集	5-200 MB

一键部署

Q：部署卡在"推送模型"？

可能原因	解决方法
板卡离线	检查 DEVICE TREE 连接状态
SSH 凭据错误	shimetad 用户连不上；检查固件
防火墙阻挡 scp	临时关闭防火墙

Q：部署成功但视觉 Tab 没显示？

可能原因	解决方法
模型 .xmm 文件损坏	重新部署
部署到错误目录	应部署到 `/mnt/models/xmm/`
视觉 Tab 没刷新	切换 Tab 再切回来

Q：能同时部署多个模型吗？

shimeta-camera（旧版）和 shimeta-xmm 共用 8080 端口，不能同时启动。如需多模型：

方式	操作
顺序运行	停 A 启 B
多板卡	不同 Pico-G1 跑不同模型

Q：部署历史能查看吗？

部署历史 UI 在 v1.0.0 中位置未标准化。可通过 SSH 登录板端查看 /mnt/models/xmm/ 目录确认部署状态。

模型选择

Q：怎么选模型？

场景	推荐
通用目标检测	yolov8n
速度优先	yolov5n
特定场景	在社区/官方模型中搜索对应类别

Q：怎么知道模型支持哪些类别？

官方模型：模型卡片显示
社区模型：模型详情页查看
自训练模型：在 AIHub 训练时设置

Q：能下载别人的模型吗？

社区模型的所有用户可下载。点击模型卡片的下载按钮。

模型市场

Q：官方模型 vs 社区模型？

类型	来源	谁可下载
官方模型	公司发布	所有用户
社区模型	用户发布	所有用户

模型来源不同，但 Pico-G1 都能部署运行。

Q：怎么发布自己的模型？

在 AIHub 网页端发布。Workbench IDE 内不直接支持发布。

训练模型

Q：在 Workbench 内能训练吗？

不能。模型训练在 AIHub 平台完成：

点击模型 Tab 右上角 "模型训练" 链接
浏览器跳转到 aihub.shimetapi.cn 训练页
完成训练 + 导出 .xmm

详见 AIHub 文档 → 训练指南。

Q：训练积分怎么扣？

训练积分在 AIHub 平台管理，IDE 不显示积分相关 UI。

Q：能把训练任务迁移到 IDE 吗？

不能。AIHub 训练任务只能在 AIHub 网页端管理。

模型版本

Q：同一模型有多个版本，怎么选？

通常选择最新版本（默认显示）。如有特殊情况：

场景	推荐版本
追求最高精度	最新版本
追求最快速度	旧版本（模型小）
复现历史实验	当时的版本

Q：能删除已部署的旧模型吗？

板端：

ssh shimetad@192.168.49.10
rm -rf /mnt/models/xmm/<model>/

离线场景

Q：完全离线能用 Workbench 吗？

可以，但功能受限：

功能	离线时是否可用
本地模型部署	✅ 可用
终端 SSH	✅ 可用
模型 Tab 浏览	❌ 不可用
AIHub 训练	❌ 不可用

Q：能导入同事给我的模型吗？

可以。工作台 → 本地模型 → 导入 → 选择 .xmm.zip。

常见问题

现象	解决
模型 Tab 加载缓慢	检查网络；首次需拉取列表
找不到自己训练的模型	训练未导出 XMM
"部署到板卡"无响应	板卡未连接
部署失败	板端磁盘满；清理旧模型