VideoSeek 是本地视频素材检索工具,核心能力是依靠文字描述或者截图,在本地素材库里定位视频片段时间点,支持预览并直接导出剪辑片段。全部索引、检索运算在本机完成,依托 ONNX、Lance、FFmpeg 整套栈,原始视频不会上传到任何云端,保护素材隐私。

核心功能(完成视频库同步即可启用)
- 本地视频素材库:添加本地文件夹作为素材库,同步阶段自动抽帧并生成向量索引。
- 文字语义搜索:输入画面描述,在索引好的全部视频中,匹配相似画面对应的时间区间。
- 图片/截图检索:上传参考图、裁剪截图来找同款镜头,提供定位、精细检索多种选项。
- 硬字幕OCR检索:识别画面内内嵌硬字幕,关键词检索台词出现的时间;支持精确匹配与模糊匹配,检索结果高亮展示。
- 检索范围灵活控制:可选择全库检索、指定素材库、单个视频检索;支持保存搜索预设,一键复用整套检索条件。
- 检索命中模式:支持单帧匹配,或是按语义块聚合结果,方便筛选连续镜头。
- 预览与片段导出:检索结果带时间轴预览,可直接导出MP4视频片段。
可选扩展能力
- 视频理解模块(桌面可选):为语义块生成画面描述、视频整体摘要;可自动化影视解说剪辑流程,完成镜头挑选、字幕排布。对白分离采用本地 CAM++ 人声聚类模型,模型权重存放于 resources/asr/campplus.*。
- 剪映草稿导出:挑选好的镜头素材、解说剪辑工程,可直接导出剪映草稿,内置所需依赖。
- 本地Agent HTTP API:本机 127.0.0.1 接口,可供 Cursor 等智能体调用,提供语义检索、字幕检索、素材列表、片段导出接口(API不含视频理解功能)。
- 网页视频下载:解析网页视频链接,下载到本地文件夹后,纳入素材库做索引检索。
- 插件扩展:可通过环境变量
VIDEOSEEK_PLUGINS、配置文件或者pip包加载自定义扩展页面,开源本体不自带第三方插件。
适用人群
- 大量素材存放在硬盘或者NAS,需要依靠画面语义查找镜头,不想手动逐个翻阅文件的剪辑创作者;
- 剪辑前期快速筛选素材,之后再进入专业剪辑软件精细加工;
- 想本地私有化部署,让Cursor等AI Agent调用视频检索能力。
最简上手步骤
- 配置资源:首次启动跟随指引,或者在设置页下载导入模型、FFmpeg等依赖。
- 添加素材库:侧边栏视频库面板,添加本地文件夹。
- 同步素材:勾选目标视频,执行同步,等待抽帧与向量索引生成。
- 检索素材:切换到搜索面板,使用文字或者图片进行检索。
补充:视频理解、硬字幕提取、Agent API均属于可选功能,前提是素材库完成同步;字幕检索额外需要导入OCR模型,并在字幕库标签页执行字幕提取。
要点小结
- 定位:本地私有化视频素材检索工具,视频文件不上云,底层 ONNX+Lance+FFmpeg
- 检索方式:文字语义搜图、截图搜镜头、OCR硬字幕台词检索,定位片段时间轴,导出MP4
- 增值能力:解说剪辑、人声分离,支持直接导出剪映草稿;开放本地HTTP API对接AI Agent
- 部署:本地运行,插件系统可扩展;OCR、视频理解属于可选组件,按需开启