常见问题

产品与能力

VSL 和普通 NVR 有什么区别？

普通 NVR 主要负责录像和按时间回放。VSL 在事件层面保存目标 ID、轨迹、规则、大模型摘要和向量，因此可以通过“发生了什么”来查找录像。

VSL 能识别哪些目标？

默认模型使用 COCO 标签，包括人、轿车、卡车、公交车、自行车、动物和常见物品。实际能力由所选模型和训练数据决定，不能把未训练类别仅通过提示词变成可靠检测目标。

为什么还需要视觉大模型？

YOLO 或 D-FINE 擅长回答画面中有哪些对象，视觉大模型更擅长描述对象关系、活动、异常和风险。VSL 用本地模型筛选事件，再用大模型进行更深的语义理解。

数据与隐私

视频会全部上传吗？

不会。本地检测和规则判断不需要上传连续视频。只有规则命中的事件按配置发送给视觉 API。如果关闭 VLM，系统仍可完成检测、跟踪、录像和标签检索。

向量数据库保存什么？

Qdrant 保存事件向量和事件 ID 等检索信息；SQLite 保存事件结构化数据和任务状态；MP4、封面及轨迹元数据保存在本地数据目录。

性能与硬件

CPU 能运行吗？

可以，但适合验证、低分辨率或低推理帧率。持续实时分析建议使用 NVIDIA CUDA。

当前支持四路摄像头吗？

当前版本是单路视频流基础版。四路接入需要把单路管线改造成多摄像头管理器，并为每路维护独立的 ByteTrack、规则和录像状态，同时共享推理引擎。

Jetson Nano 能直接运行吗？

不能直接运行。当前 Docker 镜像是 x86-64 ONNX Runtime 架构。Jetson 需要 ARM64 镜像、JetPack/TensorRT 和硬件视频解码适配；老款 Jetson Nano 4GB 不建议用于多路实时推理。

开源许可

项目使用什么许可证？

VSL 使用 GNU AGPL-3.0。可以学习、修改和部署，但通过网络向用户提供修改后的服务时，应按许可证要求向这些用户提供对应源代码。第三方模型和运行时的许可信息见仓库中的 THIRD_PARTY_NOTICES.md。