Frigate Explore 视图完全指南检索、语义搜索与批量管理跟踪对象【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigateExplore探索是 Frigate 中用于**浏览和检索所有已保存跟踪对象tracked object**的核心视图。本文以 docs/docs/usage/explore.md 为主线结合 frigate/api/event.py、frigate/api/defs/query/events_query_parameters.py 与 web/src/views/explore/ExploreView.tsx 等源码系统讲解 Explore 的默认浏览方式、搜索语法、过滤器参考、对象详情面板、批量操作与语义搜索最佳实践帮助你快速定位某个特定目标而非逐条翻阅录像。Explore 在 Frigate 中的定位Frigate 是一个带实时本地目标检测的 NVR网络录像机。当摄像头画面中出现人、车、狗等目标并被检测追踪后这些目标会作为事件Event写入 SQLite 数据库其快照、缩略图与运动轨迹被持久化保存。Explore 正是面向这些历史跟踪对象设计的事后检索入口默认按标签label分组展示最近对象启用语义搜索后支持自然语言描述与视觉相似度检索点击任意对象可打开详情面板查看快照、生命周期lifecycle与元数据。:::tip 何时用 Review何时用 Explore 如果只是想快速回顾摄像头发生了什么官方文档建议优先使用 Review它会把同一摄像头相互重叠、相邻的活动合并为review item并按 Alerts、Detections、Motion 分类几秒钟内即可扫读和回放。Explore 面向的是事后精确找某个对象——按标签、时间、区域或描述定位到具体的一个跟踪对象。 :::从源码角度看Explore 的默认视图数据来自GET /api/events/explore接口frigate/api/event.py。该接口先对允许访问的摄像头查询所有去重标签再为每个标签取最近limit默认 10条事件、统计该标签总计数最终按事件数与开始时间降序返回返回字段包括id、camera、label、zones、has_clip、has_snapshot、sub_label、top_score、event_count以及data中的description、average_estimated_speed、recognized_license_plate等。前端 web/src/views/explore/ExploreView.tsx 通过useSWR请求该接口并在内存中将事件按label聚合成eventsByLabel分组移动端将 limit 降为 5、桌面端为 10当 WebSocket 推送description更新时会自动重新拉取保证详情面板中修改的描述能即时反映到列表。浏览跟踪对象默认分组视图进入 Explore 后默认展示最近跟踪对象按标签分组的行Person、Car、Dog……每一行标注对象类型与数量。行末的箭头会打开该标签的完整可过滤网格。缩略图交互单击缩略图打开对象详情对话框右键 / 长按缩略图打开操作菜单视图设置可切换到更紧凑的网格布局并调整列数。搜索启用语义搜索后Explore 顶部会出现一个搜索框将两种能力合并在同一个输入框自然语言搜索输入自由文本并回车即可对跟踪对象执行语义检索例如 red sedan driving down a residential street过滤 token输入key:会弹出建议再输入值即可添加结构化过滤条件。每个过滤条件会变成一个可移除的 chip且可以串联多个。搜索可用星形图标保存、之后重新加载也可用清空图标一键清空。帮助气泡help popover会解释 token 语法例如cameras:front_door label:person before:01012024 time_range:3:00PM-4:00PM过滤参考Filter reference最常用的过滤 token 如下过滤项说明Cameras限定一个或多个摄像头。Labels对象标签person、car 等。Sub Labels已识别的子标签如识别出的人脸或姓名。Attributes应用于对象的分类属性。Recognized License Plate匹配识别出的车牌。Zones进入过指定区域的对象。Before / After限定日期范围。Time Range限定一天内的时间段HH:MM-HH:MM。Min / Max Score按对象置信度分数过滤。Min / Max Speed按估算速度过滤需配置速度估算。Has Snapshot / Has Clip只保留保存过快照或录像的对象。Submitted to Frigate只保留已提交的对象启用 Frigate 时。Search Type决定语义搜索匹配对象的Thumbnail缩略图还是Description描述。这些过滤条件在 API 层有严格对应frigate/api/defs/query/events_query_parameters.py 中的EventsQueryParams/EventsSearchQueryParams定义了cameras、labels、sub_labels、attributes、zones、after、before、time_range默认00:00,24:00、min_score、max_score、min_speed、max_speed、recognized_license_plate、has_clip、has_snapshot、is_submitted等参数events_search在 frigate/api/event.py 中将它们组装成 SQLite 查询条件如摄像头交集过滤、子标签大小写不敏感匹配、时间范围按当天小时数比较等并支持limit搜索默认 50与sort。排序Sorting当过滤或搜索激活时Sort控件可按date日期、object score对象分数或estimated speed估算速度升序/降序排列结果当语义查询或相似度搜索激活时还可按relevance相关性排序。后端排序实现见 frigate/api/event.pysort relevance时按search_distance升序score_asc/score_desc、speed_asc/speed_desc、date_asc/date_desc分别对应相应字段排序默认按start_time降序。缩略图搜索与描述搜索Search Type设置决定文本查询匹配对象的缩略图还是描述。每条结果会标明命中的来源thumbnail / description及置信度。自然语言搜索、缩略图搜索与描述搜索都要求启用语义搜索。语义检索由 Embeddings 上下文request.app.embeddings执行context.search_thumbnail(query)与context.search_description(query)分别查询缩略图与描述向量索引距离值经thumb_stats.normalize/desc_stats.normalize归一化后作为相关性依据frigate/api/event.py。当search_type为多模态thumbnail description时还会记录统计用于归一化若同一事件在两类检索中均命中取距离更小者作为最终来源。相似度搜索search_type similarity则以选中事件为锚点执行context.search_thumbnail(search_event)返回与之视觉最相近的对象frigate/api/event.py。跟踪对象详情Tracked Object Details选中对象后打开Tracked Object Details对话框。可用箭头或键盘左右键在相邻对象间切换。对话框包含两个标签页Snapshot / Thumbnail已保存的快照或缩略图Tracking Details对象的生命周期仅在对象有录像时可用。它列出每个关键时刻检测到、进入区域、变为活跃/静止、离开等点击某个时刻会回放该段录像并叠加边界框。设置弹层可显示所有区域并调整标注偏移量annotation offset。详情面板展示对象的label、scores、camera、时间戳、估算speed、识别的车牌、分类属性与描述。管理员可以就地编辑子标签sub label、车牌和属性。描述相关能力非常完整对应以下后端接口frigate/api/event.pyPUT /api/events/{event_id}/description手工编辑描述非空时更新描述向量为空时清理描述 embeddingPOST /api/events/{event_id}/description/regenerate当生成式 AI 描述已启用且对象生命周期已结束时从快照或缩略图重新生成描述POST /api/events/{event_id}/description/generate为指定描述文本生成 embedding。对于speech类对象当音频转写启用时详情面板提供Transcribe转写操作。当 Frigate 启用时管理员可直接在此面板提交快照用于改进模型对应POST /api/events/{event_id}/plus与误报提交接口见 frigate/api/event.py。操作与批量选择Actions and bulk selection在网格中右键或长按对象或其缩略图会打开操作菜单可用操作包括下载视频 / 快照 / 干净快照clean snapshot查看跟踪详情查找相似对象find similar即相似度搜索添加触发器add a trigger在 History 中查看view in History删除该跟踪对象。:::note 删除的边界 删除一个跟踪对象会移除其快照、embedding 与跟踪详情条目但该对象在 History 中的录像片段不会被删除。 :::后端删除路径同样区分单对象与批量frigate/api/event.py 提供DELETE /api/events/{event_id}与DELETE /api/events按 ID 列表批量删除删除时通过context.db.delete_embeddings_thumbnail、delete_embeddings_description清理对应向量索引避免产生孤儿 embedding。批量选择Ctrl/Cmd 点击或右键开始选择被选中的瓦片出现蓝色圆环随后可使用工具栏全选、清空选择或删除删除仅限管理员。语义搜索用法与最佳实践与传统过滤结合使用语义搜索应与其他过滤器配合。传统过滤 语义搜索的组合效果最好。按目的选择搜索类型寻找场景中的特定对象时用thumbnail搜索类型判断对象意图时用description搜索类型。理解多模态搜索的排序特性由于 Frigate 所用 AI 模型的训练方式文本与图像 embedding 距离的对比决定了多模态thumbnail description搜索下命中description的结果通常会排在前面即便某个thumbnailembedding 可能更匹配。请多尝试 Search Type 设置来找到目标。注意如果只给特定对象或区域生成描述搜索结果可能优先展示有描述的对象即使无描述的对象更相关。让查询语言贴近目标本身thumbnail 搜索时把查询写成图片描述image caption。例如搜 red car 可能不如 red sedan driving down a residential street on a sunny day 效果好。大目标更易命中缩略图语义搜索在匹配占据画面大部分的大目标时效果更好像 cat 这样的小目标往往效果不佳。多实验随便找一个跟踪对象持续输入关键词和短语找到最适合你的检索方式。前端在语义查询激活时结果瓦片会显示匹配来源与置信度并以search_distance/search_source字段由后端填充frigate/api/event.py驱动相关性排序用户可直接在 Explore 页面对比不同 Search Type 的召回差异。触发器Triggers从对象的操作菜单中选择Add trigger可以建立按摄像头生效的触发器它利用语义搜索在出现相似对象时自动执行一个动作发送通知、设置子标签或属性。触发器依赖语义搜索在Settings Enrichments Triggers中管理完整配置与最佳实践见 语义搜索文档中的 Triggers 章节。从源码看触发器同样复用语义检索管线创建触发器时frigate/api/event.py 会根据typedescription或thumbnail调用context.generate_description_embedding或基于事件缩略图get_event_thumbnail_bytes生成 trigger embedding并写入vec_thumbnails表与触发缩略图文件get_trigger_thumbnail_path更新、删除触发器时则同步维护缩略图文件与 embedding保证相似对象判定与触发动作始终基于最新模型向量。关键文件速查内容路径Explore 使用文档docs/docs/usage/explore.md事件检索 / 详情 / 删除 / 触发器 APIfrigate/api/event.py搜索与过滤查询参数定义frigate/api/defs/query/events_query_parameters.pyExplore 默认视图前端实现web/src/views/explore/ExploreView.tsx语义搜索配置docs/docs/configuration/semantic_search.md生成式 AI 对象描述配置docs/docs/configuration/genai/objects.mdFrigate 集成docs/docs/integrations/plus.md小结Explore 是 Frigate 中面向精准事后检索的核心视图默认按标签浏览最近对象启用语义搜索后可进行自然语言、缩略图/描述多模态检索与相似对象查找配合 Cameras、Labels、Zones、时间范围、分数/速度、快照/录像等结构化过滤 token再叠加详情面板的生命周期回放与管理员批量编辑能力即可在成千上万条历史事件中快速定位任意一个具体目标。理解其背后的events/explore与events/searchAPI、embedding 检索与排序逻辑将帮助你更高效地使用这一功能也为深度定制如基于 Explore 检索结果自动化处理打下基础。【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Frigate Explore 视图完全指南：检索、语义搜索与批量管理跟踪对象
Frigate Explore 视图完全指南检索、语义搜索与批量管理跟踪对象【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigateExplore探索是 Frigate 中用于**浏览和检索所有已保存跟踪对象tracked object**的核心视图。本文以 docs/docs/usage/explore.md 为主线结合 frigate/api/event.py、frigate/api/defs/query/events_query_parameters.py 与 web/src/views/explore/ExploreView.tsx 等源码系统讲解 Explore 的默认浏览方式、搜索语法、过滤器参考、对象详情面板、批量操作与语义搜索最佳实践帮助你快速定位某个特定目标而非逐条翻阅录像。Explore 在 Frigate 中的定位Frigate 是一个带实时本地目标检测的 NVR网络录像机。当摄像头画面中出现人、车、狗等目标并被检测追踪后这些目标会作为事件Event写入 SQLite 数据库其快照、缩略图与运动轨迹被持久化保存。Explore 正是面向这些历史跟踪对象设计的事后检索入口默认按标签label分组展示最近对象启用语义搜索后支持自然语言描述与视觉相似度检索点击任意对象可打开详情面板查看快照、生命周期lifecycle与元数据。:::tip 何时用 Review何时用 Explore 如果只是想快速回顾摄像头发生了什么官方文档建议优先使用 Review它会把同一摄像头相互重叠、相邻的活动合并为review item并按 Alerts、Detections、Motion 分类几秒钟内即可扫读和回放。Explore 面向的是事后精确找某个对象——按标签、时间、区域或描述定位到具体的一个跟踪对象。 :::从源码角度看Explore 的默认视图数据来自GET /api/events/explore接口frigate/api/event.py。该接口先对允许访问的摄像头查询所有去重标签再为每个标签取最近limit默认 10条事件、统计该标签总计数最终按事件数与开始时间降序返回返回字段包括id、camera、label、zones、has_clip、has_snapshot、sub_label、top_score、event_count以及data中的description、average_estimated_speed、recognized_license_plate等。前端 web/src/views/explore/ExploreView.tsx 通过useSWR请求该接口并在内存中将事件按label聚合成eventsByLabel分组移动端将 limit 降为 5、桌面端为 10当 WebSocket 推送description更新时会自动重新拉取保证详情面板中修改的描述能即时反映到列表。浏览跟踪对象默认分组视图进入 Explore 后默认展示最近跟踪对象按标签分组的行Person、Car、Dog……每一行标注对象类型与数量。行末的箭头会打开该标签的完整可过滤网格。缩略图交互单击缩略图打开对象详情对话框右键 / 长按缩略图打开操作菜单视图设置可切换到更紧凑的网格布局并调整列数。搜索启用语义搜索后Explore 顶部会出现一个搜索框将两种能力合并在同一个输入框自然语言搜索输入自由文本并回车即可对跟踪对象执行语义检索例如 red sedan driving down a residential street过滤 token输入key:会弹出建议再输入值即可添加结构化过滤条件。每个过滤条件会变成一个可移除的 chip且可以串联多个。搜索可用星形图标保存、之后重新加载也可用清空图标一键清空。帮助气泡help popover会解释 token 语法例如cameras:front_door label:person before:01012024 time_range:3:00PM-4:00PM过滤参考Filter reference最常用的过滤 token 如下过滤项说明Cameras限定一个或多个摄像头。Labels对象标签person、car 等。Sub Labels已识别的子标签如识别出的人脸或姓名。Attributes应用于对象的分类属性。Recognized License Plate匹配识别出的车牌。Zones进入过指定区域的对象。Before / After限定日期范围。Time Range限定一天内的时间段HH:MM-HH:MM。Min / Max Score按对象置信度分数过滤。Min / Max Speed按估算速度过滤需配置速度估算。Has Snapshot / Has Clip只保留保存过快照或录像的对象。Submitted to Frigate只保留已提交的对象启用 Frigate 时。Search Type决定语义搜索匹配对象的Thumbnail缩略图还是Description描述。这些过滤条件在 API 层有严格对应frigate/api/defs/query/events_query_parameters.py 中的EventsQueryParams/EventsSearchQueryParams定义了cameras、labels、sub_labels、attributes、zones、after、before、time_range默认00:00,24:00、min_score、max_score、min_speed、max_speed、recognized_license_plate、has_clip、has_snapshot、is_submitted等参数events_search在 frigate/api/event.py 中将它们组装成 SQLite 查询条件如摄像头交集过滤、子标签大小写不敏感匹配、时间范围按当天小时数比较等并支持limit搜索默认 50与sort。排序Sorting当过滤或搜索激活时Sort控件可按date日期、object score对象分数或estimated speed估算速度升序/降序排列结果当语义查询或相似度搜索激活时还可按relevance相关性排序。后端排序实现见 frigate/api/event.pysort relevance时按search_distance升序score_asc/score_desc、speed_asc/speed_desc、date_asc/date_desc分别对应相应字段排序默认按start_time降序。缩略图搜索与描述搜索Search Type设置决定文本查询匹配对象的缩略图还是描述。每条结果会标明命中的来源thumbnail / description及置信度。自然语言搜索、缩略图搜索与描述搜索都要求启用语义搜索。语义检索由 Embeddings 上下文request.app.embeddings执行context.search_thumbnail(query)与context.search_description(query)分别查询缩略图与描述向量索引距离值经thumb_stats.normalize/desc_stats.normalize归一化后作为相关性依据frigate/api/event.py。当search_type为多模态thumbnail description时还会记录统计用于归一化若同一事件在两类检索中均命中取距离更小者作为最终来源。相似度搜索search_type similarity则以选中事件为锚点执行context.search_thumbnail(search_event)返回与之视觉最相近的对象frigate/api/event.py。跟踪对象详情Tracked Object Details选中对象后打开Tracked Object Details对话框。可用箭头或键盘左右键在相邻对象间切换。对话框包含两个标签页Snapshot / Thumbnail已保存的快照或缩略图Tracking Details对象的生命周期仅在对象有录像时可用。它列出每个关键时刻检测到、进入区域、变为活跃/静止、离开等点击某个时刻会回放该段录像并叠加边界框。设置弹层可显示所有区域并调整标注偏移量annotation offset。详情面板展示对象的label、scores、camera、时间戳、估算speed、识别的车牌、分类属性与描述。管理员可以就地编辑子标签sub label、车牌和属性。描述相关能力非常完整对应以下后端接口frigate/api/event.pyPUT /api/events/{event_id}/description手工编辑描述非空时更新描述向量为空时清理描述 embeddingPOST /api/events/{event_id}/description/regenerate当生成式 AI 描述已启用且对象生命周期已结束时从快照或缩略图重新生成描述POST /api/events/{event_id}/description/generate为指定描述文本生成 embedding。对于speech类对象当音频转写启用时详情面板提供Transcribe转写操作。当 Frigate 启用时管理员可直接在此面板提交快照用于改进模型对应POST /api/events/{event_id}/plus与误报提交接口见 frigate/api/event.py。操作与批量选择Actions and bulk selection在网格中右键或长按对象或其缩略图会打开操作菜单可用操作包括下载视频 / 快照 / 干净快照clean snapshot查看跟踪详情查找相似对象find similar即相似度搜索添加触发器add a trigger在 History 中查看view in History删除该跟踪对象。:::note 删除的边界 删除一个跟踪对象会移除其快照、embedding 与跟踪详情条目但该对象在 History 中的录像片段不会被删除。 :::后端删除路径同样区分单对象与批量frigate/api/event.py 提供DELETE /api/events/{event_id}与DELETE /api/events按 ID 列表批量删除删除时通过context.db.delete_embeddings_thumbnail、delete_embeddings_description清理对应向量索引避免产生孤儿 embedding。批量选择Ctrl/Cmd 点击或右键开始选择被选中的瓦片出现蓝色圆环随后可使用工具栏全选、清空选择或删除删除仅限管理员。语义搜索用法与最佳实践与传统过滤结合使用语义搜索应与其他过滤器配合。传统过滤 语义搜索的组合效果最好。按目的选择搜索类型寻找场景中的特定对象时用thumbnail搜索类型判断对象意图时用description搜索类型。理解多模态搜索的排序特性由于 Frigate 所用 AI 模型的训练方式文本与图像 embedding 距离的对比决定了多模态thumbnail description搜索下命中description的结果通常会排在前面即便某个thumbnailembedding 可能更匹配。请多尝试 Search Type 设置来找到目标。注意如果只给特定对象或区域生成描述搜索结果可能优先展示有描述的对象即使无描述的对象更相关。让查询语言贴近目标本身thumbnail 搜索时把查询写成图片描述image caption。例如搜 red car 可能不如 red sedan driving down a residential street on a sunny day 效果好。大目标更易命中缩略图语义搜索在匹配占据画面大部分的大目标时效果更好像 cat 这样的小目标往往效果不佳。多实验随便找一个跟踪对象持续输入关键词和短语找到最适合你的检索方式。前端在语义查询激活时结果瓦片会显示匹配来源与置信度并以search_distance/search_source字段由后端填充frigate/api/event.py驱动相关性排序用户可直接在 Explore 页面对比不同 Search Type 的召回差异。触发器Triggers从对象的操作菜单中选择Add trigger可以建立按摄像头生效的触发器它利用语义搜索在出现相似对象时自动执行一个动作发送通知、设置子标签或属性。触发器依赖语义搜索在Settings Enrichments Triggers中管理完整配置与最佳实践见 语义搜索文档中的 Triggers 章节。从源码看触发器同样复用语义检索管线创建触发器时frigate/api/event.py 会根据typedescription或thumbnail调用context.generate_description_embedding或基于事件缩略图get_event_thumbnail_bytes生成 trigger embedding并写入vec_thumbnails表与触发缩略图文件get_trigger_thumbnail_path更新、删除触发器时则同步维护缩略图文件与 embedding保证相似对象判定与触发动作始终基于最新模型向量。关键文件速查内容路径Explore 使用文档docs/docs/usage/explore.md事件检索 / 详情 / 删除 / 触发器 APIfrigate/api/event.py搜索与过滤查询参数定义frigate/api/defs/query/events_query_parameters.pyExplore 默认视图前端实现web/src/views/explore/ExploreView.tsx语义搜索配置docs/docs/configuration/semantic_search.md生成式 AI 对象描述配置docs/docs/configuration/genai/objects.mdFrigate 集成docs/docs/integrations/plus.md小结Explore 是 Frigate 中面向精准事后检索的核心视图默认按标签浏览最近对象启用语义搜索后可进行自然语言、缩略图/描述多模态检索与相似对象查找配合 Cameras、Labels、Zones、时间范围、分数/速度、快照/录像等结构化过滤 token再叠加详情面板的生命周期回放与管理员批量编辑能力即可在成千上万条历史事件中快速定位任意一个具体目标。理解其背后的events/explore与events/searchAPI、embedding 检索与排序逻辑将帮助你更高效地使用这一功能也为深度定制如基于 Explore 检索结果自动化处理打下基础。【免费下载链接】frigateNVR with realtime local object detection for IP cameras项目地址: https://gitcode.com/GitHub_Trending/fr/frigate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
