使用说明书
从安装到排错，十章覆盖全部功能。遇到问题先查这里，再联系客服。
01安装与首次启动
1.1 系统要求
| 项目 | 最低 | 推荐 |
|---|---|---|
| 操作系统 | Windows 10 21H2 (64 位) | Windows 11 23H2 |
| CPU | 4 核 | 8 核以上 |
| 内存 | 8 GB | 16 GB 以上 |
| 显卡 | 支持 DirectX 12 的集显 | NVIDIA GTX 1660 / AMD RX 580 以上 |
| 显存 | 2 GB | 6 GB 以上 |
| 硬盘 | 500 MB 可用 | 2 GB 可用（含模型） |
| 运行库 | Visual C++ 2015-2022 x64（缺失时软件会提示下载链接） | |
1.2 安装步骤
-
下载安装包
从官网下载
SLai-3.5.0.zip（约 123 MB）。 -
解压到硬盘
右键 → 解压到
D:\SLai之类的目录。⚠ 不要在压缩包里直接双击运行。 单文件程序需要读写同目录的ort_dml\、plugins\， 在临时目录里启动会缺文件。 -
首次启动
双击
SLai.exe，会依次出现三屏：用户协议 → 使用须知 → 授权激活。前两屏都要滚到底勾选同意。 -
验证安装成功
进入主界面后：左上角显示采集 FPS，右下角显示
DirectML (通用 GPU)与设备码，即为正常。
1.3 目录结构
| 路径 | 内容 | 能删吗 |
|---|---|---|
SLai.exe | 主程序（单文件，运行时已内嵌） | 不能 |
ort_dml\ | DirectML + ONNX Runtime 原生库 | 不能 |
OpenCvSharpExtern.dll | OpenCV 原生库 | 不能 |
models\ | 模型文件（.onnx） | 可替换 |
plugins\ | 插件目录 | 可替换 |
config\ | 插件市场配置 | 不建议 |
| 程序校验文件 | 程序自带（请勿改动） | 不能（删了启动报错） |
1.4 日志位置
出问题时先看日志，两份：
%LOCALAPPDATA%\SLai\error.log—— 错误与异常栈%LOCALAPPDATA%\SLai\startup.log—— 启动流程（DLL 加载、设备检测）
%LOCALAPPDATA%\SLai\ 回车即可打开。
02激活与授权
2.1 卡密格式
卡密为 10 位大写字母与数字组合，例如 SPDGNJB6GG。区分大小写，不含连字符。
2.2 激活步骤
- 输入卡密
在激活窗输入，支持粘贴，回车可直接提交。
- 点「激活」
保持网络畅通，等提示「激活成功」。
- 进入软件
之后正常启动不需要再输卡密。
03画面来源
3.1 六种来源对比
| 来源 | 延迟 | 适用场景 | 注意 |
|---|---|---|---|
| DXGI（屏幕） | 最低 | 采集本机屏幕或某个窗口 | 独占全屏可能抓不到，用无边框窗口 |
| 采集卡 | 低 | 外接 HDMI 采集卡 | 需装驱动，支持 YUY2 / NV12 / MJPEG |
| 视频文件 | 无 | 离线跑通链路、验证模型 | 支持 mp4 / mkv / avi |
| NDI | 低 | 局域网内另一台机器的画面 | 需装 NDI Runtime |
| OBS | 中 | OBS 虚拟摄像头输出 | OBS 里开启「虚拟摄像机」 |
| 安卓 USB | 中 | 采集手机画面 | 需开 USB 调试，走 ADB + scrcpy |
3.2 DXGI 采集设置
- 采集尺寸 —— 建议 640×640（多数模型的训练尺寸）。设太大会显著增加推理耗时。
- 目标帧率 —— 默认 60。显卡较弱时降到 30 可明显降低占用。
- 自动选择可用源 —— 不确定选哪个时点这个，会挑第一个能用的。
3.3 采集卡排查
| 现象 | 原因 | 解决 |
|---|---|---|
| 列表里没有设备 | 驱动没装或被占用 | 装厂商驱动；关掉 OBS 等占用程序 |
| 能选但黑屏 | 格式不匹配 | 换 YUY2 或 NV12 试试 |
| 画面撕裂 | 帧率不匹配 | 把目标帧率设成采集卡的输出帧率 |
3.4 安卓 USB 采集
- 开启开发者选项
设置 → 关于手机 → 连点版本号 7 次。
- 开启 USB 调试
开发者选项 → USB 调试。连接后手机上点「允许」。
- 软件里选设备
采集页 → 来源 → 安卓 USB → 选择设备。
首次连接会自动推送 scrcpy-server.jar 到手机，需要几秒。
04模型与推理后端
4.1 双后端怎么选
| 后端 | 需要什么 | 速度 | 兼容性 |
|---|---|---|---|
| DirectML | 任意 DX12 显卡 | 中 | 最广，AMD / Intel / NVIDIA 都能跑 |
| TensorRT | NVIDIA 显卡 + 扩展包 | 快（约 1.5-2×） | 仅 NVIDIA，需软件内下载扩展包 |
4.2 加载模型
- 打开模型页
左侧导航 → 模型。
- 选模型文件
支持
.onnx。也可以点「添加模型」把文件拷进models\。 - 点「加载」
加载成功后，「开始推理」按钮才会从灰色变成可点。
4.3 模型版本
| 模型 | 说明 |
|---|---|
| SLai v5 - v26 | 标准检测模型，输出边框 + 类别 + 置信度 |
| SLai-pose | 姿态模型，输出 17 个关键点 |
4.4 精度选择
- FP32 —— 最准，最慢，显存占用最大
- FP16 —— 精度几乎无损，速度快约 2×，推荐
- INT8 —— 最快，需要量化模型，精度有损
4.5 装 TensorRT 扩展包
- 确认显卡
必须是 NVIDIA。设置 → 推理后端 会显示「检测到 NVIDIA 显卡」。
- 软件内下载
设置 → 推理后端 → 下载 TensorRT 扩展包（约 800 MB）。
- 切换后端
下载完成后，后端下拉里出现 TensorRT 选项。
05检测与叠加
5.1 信心阈值
| 值 | 效果 | 什么时候用 |
|---|---|---|
| 0.20 - 0.35 | 检出多，误检多 | 目标很小或很模糊 |
| 0.45 - 0.55 | 平衡 | 默认 |
| 0.65 - 0.85 | 检出少，准确率高 | 只要最确定的目标 |
5.2 分块推理（SAHI）
把大画面切成小块分别推理再合并，显著提升小目标检出率，代价是耗时增加 2-4 倍。
适合：远处的小目标、高分辨率画面（1080p 以上）。
5.3 姿态估计
需要加载 SLai-pose 模型。输出 17 个关键点（头、肩、肘、腕、髋、膝、踝），与检测框同屏显示。
5.4 叠加与投射
- 实时预览 —— 主界面右侧显示处理后的画面
- 投射 —— 把叠加层投到独立窗口，可全屏、可置顶
- 隐藏预览 —— 关掉主界面预览以节省 GPU
5.5 识别结果面板
主界面下方显示每一帧的检出目标：类别、置信度、左上角坐标、尺寸。可导出。
06插件
6.1 插件是什么
插件是独立的 DLL，在隔离的加载上下文里运行。插件崩溃不会影响主程序。
6.2 装插件
- 打开插件页
左侧导航 → 插件。
- 浏览市场
点「浏览插件市场」，列出可用插件。
- 安装
点「安装」，自动下载并解压到
plugins\。 - 加载
安装后点「加载」启用。
6.3 内置插件
| 插件 | 功能 | 版本 |
|---|---|---|
| 设备控制 | 把检测结果转成键鼠 / 串口 / HID 动作 | v5.5 |
| 目标追踪 | 跨帧轨迹 + 速度预测 | v1.0 |
| SLai 样板插件 | 插件开发起点，含完整注释 | v1.0 |
| 演示插件 | 最小可运行示例 | v1.0 |
6.4 卸载插件
插件页 → 找到插件 → 点「卸载」，会删除 plugins\ 下对应目录。
6.5 插件加载失败
| 提示 | 原因 | 解决 |
|---|---|---|
| 未运行 | 还没点加载 | 点「加载」 |
| 加载失败：版本不匹配 | 插件要求的宿主版本更高 | 升级软件 |
| 加载失败：缺少依赖 | 插件 DLL 不全 | 卸载重装 |
| 加载失败：完整性校验 | 插件文件被改过 | 重新下载 |
07快捷键
| 快捷键 | 功能 |
|---|---|
F5 | 开始 / 停止推理 |
F6 | 显示 / 隐藏预览 |
F7 | 投射到独立窗口 |
F8 | 保存当前设置 |
Ctrl + O | 打开模型目录 |
Ctrl + R | 刷新模型 / 插件列表 |
Ctrl + , | 打开设置 |
Esc | 关闭弹窗 / 停止投射 |
完整列表见：设置 → 快捷键。
08性能调优
8.1 先定位瓶颈
| 现象 | 瓶颈 | 先做什么 |
|---|---|---|
| 采集 FPS 高，推理 FPS 低 | 推理 | 降精度 / 换 TensorRT / 换小模型 |
| 采集 FPS 本身就低 | 采集 | 降采集尺寸 / 换采集方式 |
| 两者都低，延迟高 | CPU 或内存 | 关后台程序 / 加内存 |
| 用一会儿变慢 | 散热降频 | 清灰 / 改善散热 |
8.2 按顺序优化
- 后端换成 TensorRT
NVIDIA 显卡能提升 1.5-2 倍。
- 精度降到 FP16
几乎无损，速度约 2 倍。
- 采集尺寸降到 640×640
这是多数模型的训练尺寸，再大不会更准。
- 关掉分块推理
SAHI 会让耗时增加 2-4 倍，只在需要找小目标时开。
- 关掉预览
预览本身要占 GPU。
8.3 显存不够
- 降到 FP16 或 INT8
- 换输入尺寸更小的模型
- 关掉浏览器硬件加速
- 关掉其他占显存的程序
09常见问题
双击没反应 / 一闪就没了
看 %LOCALAPPDATA%\SLai\error.log：missing:xxx.dll 是解压不完整；modified:xxx 是文件被杀毒删了；没有日志也没进程就重启电脑（单实例互斥体残留）。
提示缺少 VC++ 运行库
装 https://aka.ms/vs/17/release/vc_redist.x64.exe，装完重开软件。
杀毒软件报毒
这是误报，可以放心使用。Windows Defender：设置 → 病毒和威胁防护 → 管理设置 → 排除项 → 添加文件夹 → 选 SLai 目录。
卡密提示不存在
检查大小写（区分）、连字符、有没有多余空格。都不行就联系客服核对。
激活时提示连接超时
等一分钟再试即可。
提示已绑定其他设备
去发卡平台后台解绑，或联系客服帮忙解绑，然后在当前机器重新激活。
开始推理按钮是灰的
还没加载模型。去「模型」页加载一个 .onnx 文件。
画面能采集但不推理
看主界面上方是否显示「DFPS 0」。如果是 0，通常是模型没加载成功或后端初始化失败，看 error.log。
识别不准
① 信心阈值调低；② 换更匹配的模型；③ 确保光线充足、目标清晰；④ 检查采集尺寸是否与模型训练尺寸一致。
换了电脑要重新买卡吗
不用。解绑后在新机用同一张卡激活即可。
会不会上传我的画面
不会。推理全在本地显卡完成，画面上传字节数为 0。只上报设备标识与错误摘要用于授权校验。
怎么看到期时间
设置 → 授权，或状态栏右下角。
10联系与支持
报问题时请提供三样
- 设备码
设置 → 授权 → 设备码，或状态栏右下角。
- 报错截图
整个窗口，包括标题栏。
- 日志文件
%LOCALAPPDATA%\SLai\error.log
提供这三样，定位速度会快很多。