视觉与运行时
摄像头画面
Q：右上角"物象"框黑屏？
Pico-G1 自带 SC465SL 摄像头（MIPI CSI）。
| 可能原因 | 解决方法 |
|---|---|
| shimeta-svp/xmm 未启动 | 视觉 Tab 点击"运行"按钮 |
| 摄像头未连接 | 检查排线 |
| 服务启动失败 | 检查板端 shimeta-svp/xmm 是否安装 |
Q：摄像头排线怎么插？
参考 支持的硬件。
Pico-G1 板端摄像头接口为专用 MIPI CSI，其他型号暂不兼容。
Q：画面卡顿 / FPS 低？
| 可能原因 | 优化方法 |
|---|---|
| NPU 温度过高（>85°C） | 改善散热 |
| 输入分辨率过大 | 用更小的模型 |
| 网络带宽不足 | 用有线网络 |
shimeta-svp
Q：什么是 SVP？
板端内置的 9 种预编译场景化检测工具，无需训练即可启动。
Q：9 种场景是什么？
详见 ch05 视觉 - SVP。
Q：场景启动无反应？
| 可能原因 | 排查 |
|---|---|
| 摄像头未连接 | 排线检查 |
| 服务启动失败 | 终端 SSH 启动 shimeta-svp <scene> 看错误 |
| 与 shimeta-xmm 端口冲突 | 先停一个 |
Q：能同时跑多个场景吗？
不能。一次只能跑一个。
Q：调参后没生效？
shimeta-svp 调参后必须重启该场景生效。点击场景卡片"运行"重新启动。
shimeta-xmm
Q：面板显示"暂无模型"？
板端 /mnt/models/xmm/ 目录为空。需先部署模型：
- 切到 模型 Tab
- 选模型 → 部署到板卡
- 切回视觉 Tab
Q：点击"运行"无响应？
| 可能原因 | 排查 |
|---|---|
| 模型文件损坏 | 重新部署 |
| 端口冲突 | shimeta-svp 还在运行；先停 |
| NPU 不兼容 | 用 AIHub 重新导出 |
Q：检测置信度全 < 5%？
模型与 NPU 不匹配。用 AIHub 重新导出 .xmm。
shimeta-py IDE
Q：什么是 shimeta-py？
板端的 Python 运行时（v1.0.4）。IDE 编辑的代码由 shimeta-py 执行。
Q：点击"运行"没反应？
| 可能原因 | 排查 |
|---|---|
| 板卡未连接 | DEVICE TREE 检查 |
| 板端 shimeta-py 未安装 | 固件问题；联系技术支持 |
Q：输出"No space left on device"？
板端磁盘满。SSH 登录清理旧文件：
ssh shimetad@192.168.49.10
df -h
rm -rf /mnt/old_models/Q：Python 代码能访问板端硬件吗？
可以。shimeta-py 在板端运行，可调用 NPU / GPIO / I2C 等：
import subprocess
result = subprocess.run(['uname', '-a'], capture_output=True, text=True)
print(result.stdout)终端
Q：终端启动后无响应？
板卡未连接。回 ch02 设备管理。
Q：能 SSH 到 root 用户吗？
可以：
ssh root@192.168.49.10
# 密码：123456Q：命令无输出？
检查命令是否正确；或用 Ctrl+C 中断。
Agent
Q：Agent 提示"请先连接板卡"？
DEVICE TREE 检查连接状态。板端未连接时 Agent 无法操作。
Q：自然语言指令无响应？
- 重启 IDE
- 或新建会话
- 简化指令（具体化比模糊好）
Q：Agent 执行 SSH 失败？
shimetad 用户权限问题。切到终端 Tab 验证。
性能问题
Q：IDE 启动很慢？
| 可能原因 | 解决方法 |
|---|---|
| 板卡未连接（启动时反复重连） | 先连接板卡 |
| 项目文件过多 | 清理工作区 |
| 系统资源紧张 | 关闭其他程序 |
Q：IDE 占用 CPU 过高？
可能是：
- 摄像头预览 MJPEG 解码
- 多个 Agent 会话同时运行
- 多板卡心跳
端口冲突
Q：8080 端口冲突？
shimeta-svp 和 shimeta-xmm 都用 8080 端口，不能同时启动。
如需切换：
- 停止当前服务
- 启动新服务
摄像头
Q：能换其他摄像头吗？
当前仅适配 SC465SL。其他型号暂不兼容。
Q：能用 USB 摄像头吗？
暂不支持，仅 MIPI CSI 接口的 SC465SL。
常见问题
| 现象 | 解决 |
|---|---|
| 画面黑屏 | 检查摄像头排线 + 服务启动 |
| FPS 很低 | 检查 NPU 温度 |
| 模型不显示 | 重新部署 |
| Agent 不响应 | 重启 IDE |
| 终端卡死 | Ctrl+C 中断；重连 |