SLai 使用说明书（3.5.0 统一版）

写给使用者：不懂技术也能照着做。遇到问题先看第八章「出问题了怎么办」。
文档版本 2026-11 · 与客户端 3.5.0 同步

一、第一次打开

1.1 解压

下载到的是压缩包（SLai-3.5.0.zip 或 .7z）。先解压再运行，不要在压缩包里直接双击。

• 右键 → 解压到当前文件夹
• 建议解压到 D:\SLai（别放桌面，桌面文件多了会卡）
• 路径里尽量别有中文和空格

1.2 双击 SLai.exe

第一次打开会出现两道确认：

① 用户协议与风险告知

把内容滚到底 → 勾选「我已阅读并同意」→ 点「同意并进入」。没滚到底不能勾，这是故意的。

② 使用须知（红色警告）

顶部红框是「严禁用于游戏作弊」等禁止事项，勾选「我已阅读公告」→「知道了」。

这两道确认只做一次，协议内容更新后才会重新要求同意。

1.3 界面长什么样

┌──────────────────────────────────────────────────────────────┐
│ S SLai   ● 正在捕获 1920×1080 @ 60fps      采集 60 FPS 推理 0 │ ← 顶栏
├──────────┬───────────────────────────────────────────────────┤
│ 工作区   │  页面标题 + 一句话说明                            │
│  采集    │                                                   │
│  模型    │  内容区（卡片 / 列表 / 按钮）                     │
│  插件    │                                                   │
│  设置    │                                                   │
├──────────┴───────────────────────────────────────────────────┤
│ 当前模型 / 未加载模型        ● 已加载插件: xxx  v3.5.0        │ ← 状态栏
└──────────────────────────────────────────────────────────────┘

四个页面：采集（选画面、调阈值、开始推理）、模型（导入/加载 onnx）、插件（装/卸/配）、设置（界面、推理、模型目录、关于）。

二、激活（第一次必须做）

2.1 什么是激活

软件按卡密授权：一张卡密绑定一台设备，激活后票据 24 小时有效，软件在后台自动续期，你不需要每天操作。

2.2 怎么激活

1. 打开软件 → 激活窗口（或「设置 → 关于」里的授权入口）
2. 输入卡密，形如 SL-XXXX-XXXX-XXXX-XXXX 或渠道商给你的卡号
3. 点「激活」→ 看到绿色提示即成功；状态栏下方出现设备码

设备码（8 位十六进制）是这台机器的身份，客服处理换绑时要用它。

2.3 换电脑 / 重装系统

• 换设备请先在「设置 → 关于」里点「解绑」，或联系客服协助解绑（自助解绑每天有次数上限）
• 一机一码的卡：解绑后可在新设备激活
• 换硬件（主板/硬盘）可能导致设备码变化，此时走客服换绑

2.4 离线能用多久

软件在启动、登录、开始推理三个时机各联网校验一次授权；无法联网时会暂停使用，恢复网络后自动解除。

2.5 激活失败提示对照

三、模型怎么用

3.1 支持什么模型

YOLO 系列 .onnx（v5 – v26，含姿态模型）。软件内统一显示为 SLaiv11 / SLaiv8 这类版本标识。

3.2 放哪里

两个目录都会被扫描：

• 安装目录下的 models\
• %LOCALAPPDATA%\SLai\models\

「设置 → 模型目录」里能看到这两个路径，按钮分别是「打开目录 / 添加模型 / 刷新目录」。

3.3 加载

模型页 → 选中卡片 → 右上角「加载」。状态栏出现绿色文字：

模型加载成功: xxx.onnx (SLaiv11, 2类, DirectML, FP32)

3.4 推理后端

3.5 参数怎么调

• 置信度阈值：0.5 起步；漏检多就降到 0.3，误检多就升到 0.6
• 采集尺寸：640×640 是速度和精度的平衡点；1080p 画面建议先缩到 640 再推理
• 分块推理（SAHI）：小目标密集时开，帧率会掉
• 姿态估计：需要 SLai-pose 模型，开启后画 17 个关键点与骨架

参数改完点「保存当前设置」，写进本机配置文件。

四、采集源怎么选

4.1 六种来源

换源不用重启程序，选完点「开始推理」即可。

4.2 OBS 接入

1. OBS 里开「虚拟摄像机」
2. SLai 采集源选 OBS（或 DXGI 抓 OBS 预览窗口）
3. 状态栏出现 [OBS] 正在捕获 即通

4.3 状态提示对照

五、插件怎么用

5.1 装插件

两种方式，都是丢进 plugins\：

• zip：直接把 xxx.zip 丢进 plugins\，重启软件，宿主会自动解开
• 文件夹：把整个插件目录（里面有 plugin.json）丢进 plugins\

软件内也可以走「插件 → 浏览插件市场」下载安装。

5.2 启用 / 停用

「插件」页 → 找到插件 → 点「加载」，状态变「运行中」，同时状态栏显示 已加载插件: xxx。

不想用了点「卸载」，插件立刻停止，不影响主程序。

5.3 配置插件

插件右侧出现「设置」按钮，说明它有配置面板（设备控制、追踪等都在这配）。

5.4 更新插件

• 市场里提示有新版 → 点更新，宿主会替换目录并重新加载
• 手动更新：用新目录覆盖 plugins\<插件id>\，重启软件 → 「刷新」

5.5 插件状态含义

5.6 插件排错

六、界面与快捷键

设置页四块：

• 界面：隐藏预览面板（省 GPU 合成）、显示投影标签
• 推理：启用姿态估计（需 SLai-pose 模型）
• 模型目录：路径展示 + 打开 / 添加 / 刷新
• 关于：版本、后端状态、用户协议、风险告知、客服 QQ

七、这是什么 / 不是什么

• 这是一个通用视觉检测工具：给它画面和模型，它给出目标框、类别、置信度。
• 检测结果有误差（光照、遮挡、分辨率、训练数据都会影响），不能作为安全决策、医疗判断、工业控制、交通调度的唯一依据。
• 严禁用于游戏作弊（外挂/自瞄/透视/宏）、绕过反作弊、未授权访问他人系统、非法监控等违法用途。

八、出问题了怎么办

8.1 看不到检测框

1. 模型是否加载成功（状态栏绿字）
2. 是否点了「开始推理」
3. 置信度阈值是否过高（降到 0.3 试试）
4. 「界面 → 显示投影标签」是否勾上

8.2 程序打不开 / 闪退

1. 是否装了 VC++ 运行库（软件启动会自检并提示）
2. 解压路径是否含特殊字符
3. 看日志：%LOCALAPPDATA%\SLai\error.log、startup.log
4. 杀软是否把某个 dll 隔离了（加白名单后重新解压）

8.3 帧率低 / 卡

• 采集尺寸降到 640×640
• 关掉「分块推理（SAHI）」
• 预览面板开「隐藏预览」（省合成开销）
• 笔记本确认用的是独显（电源模式选高性能）

8.4 提示未授权 / 请激活

• 卡密是否过期（设置 → 授权，可看到到期时间）
• 是否换了硬件导致设备码变化 → 走换绑
• 校验失败 → 检查网络后重试

8.5 日志在哪

%LOCALAPPDATA%\SLai\error.log     错误
%LOCALAPPDATA%\SLai\startup.log   启动自检
%LOCALAPPDATA%\SLai\inference.log 推理

反馈时请附：设备码（状态栏）+ 软件版本 + 显卡型号 + 复现步骤。

九、性能参考

实际帧率还取决于模型大小（n/s/m/l）与是否开分块推理。

十、客服与售后

• 客服 QQ：3247131402 / 3225324877
• 工作时间：工作日 10:00–22:00；激活、换绑一般 24 小时内处理
• 反馈模板：设备码 + 软件版本 + 问题描述 + error.log 片段
• 官网：jwdgd.asia（文档、下载、授权说明都在这）

常见问题速查