VideoSeek

项目概述

VideoSeek 是一款本地视频素材语义检索平台，用一句话、一张截图或一句台词就能在本地视频库里找到对应片段。索引与检索全部在本机完成（ONNX + Lance + FFmpeg），媒体文件不会上传，找到后可直接预览并导出给剪辑软件。

把翻文件夹找素材变成用一句话搜镜头，素材永远留在本地。

主要功能

• 本地库索引：添加文件夹后同步抽取帧与向量，建立可搜索的本地素材库
• 文本语义搜索：描述一个画面即可命中时间范围，支持逐帧或聚合分块
• 图片截图搜索：用参考图或裁帧找相似镜头，支持最佳帧、深搜等模式
• 硬字幕搜索：OCR 识别画面内字幕后按台词检索，支持精确与模糊匹配并高亮
• 预览与导出：时间轴预览并导出 mp4 片段，或生成剪映草稿、Premiere XML、达芬奇 FCPXML
• 视频理解：可选的分块描述与全片总结、recap 混剪规划，本地 CAM++ 说话人聚类
• 标签搜索：理解完成后可按蓝发、红白服装等组合标签过滤镜头
• 视觉模型可换：openai-clip、chinese-clip、siglip2 各有基础与大模型包
• 局域网共享：一台机器建索引当服务端，其他机器直接搜，媒体留在服务端
• Agent API：本机 127.0.0.1 HTTP 接口，供 Cursor 等智能体调用语义、字幕与标签搜索

适用人群

• 短视频与混剪创作者
• 管理本地或 NAS 大媒体库的用户
• 需要粗剪素材的剪辑师
• 想给 AI 智能体接检索的开发玩家

快速上手

1. 从官网或 GitHub 下载安装包，或 pip install -r requirements.txt 后 python main.py 源码运行
2. 首次启动按提示导入运行资产（模型与 FFmpeg）
3. 侧栏「本地库」添加视频文件夹，勾选后点「同步所选」建立索引
4. 侧栏「搜索」输入文字或上传图片检索，预览后导出片段

核心优势

• 隐私本地化：索引和检索都在本机，媒体文件不出门
• 语义直达镜头：按内容而非文件名找素材，效率大幅提升
• 对接剪辑工作流：一键导出剪映、PR、达芬奇工程，搜到即用
• 免费开源：AGPL-3.0，安装器与源码版界面一致

系统要求

项目	要求
操作系统	Windows 10/11（推荐），Linux/macOS 需自行调整 ONNX Runtime
运行依赖	Python、ONNX Runtime、FFmpeg
开源许可	AGPL-3.0

注意事项

• 硬字幕搜索需额外导入 OCR 包并在「字幕」页提取后才可用
• 更换视觉模型需要对相应素材库重新同步
• 视频理解等能力仅桌面版支持
• 请从 GitHub 或官网获取，谨防付费转售的安装副本