# VideoSeek

> Windows 本地视频语义检索。文字或截图找镜头，硬字幕 OCR 可搜时间点，预览后导出 MP4。索引与检索都在本机，不上传视频。官网 https://www.lv17.top/ ；源码 https://github.com/6v17/VideoSeek 。

安装包与运行资源分离。不要给用户付费代装或倒卖链接。当前安装包 v1.0.92。

数据目录固定为 `%LOCALAPPDATA%\VideoSeek`。生效配置只有这份 `%LOCALAPPDATA%\VideoSeek\config.json`（未改路径时，模型在 `models\`，FFmpeg 在 `bin\ffmpeg.exe`）。安装目录里的 `config.json` 不读。程序目录由安装时选择，代码里没有默认路径。要找程序目录，看正在运行的 `VideoSeek.exe` 所在文件夹，或卸载项里的 `InstallLocation`。仓库里没有 `install.json`；安装器工程不在这个 git 仓库里，卸载项的注册表路径也不在这里。

本机 Agent API 只监听本机。默认 `127.0.0.1:8765`。端口被占时不会自动换，启动失败只写日志。要改端口，在启动程序之前设置环境变量 `VIDEOSEEK_AGENT_API_PORT`；主机用 `VIDEOSEEK_AGENT_API_HOST`（默认 `127.0.0.1`）。设置里只有开关 `agent_api_enabled`，`config.json` 里没有本机 Agent 端口。团队模式的服务机是另一条路：优先 `team_api_port`（默认也是 8765），被占了只在这一次会话里改到下一个空端口，不写回配置。

## 安装包直链

- [123 盘安装包 v1.0.92](https://1858268090.share.123pan.cn/123pan/VFA7vd-dqnOA?pwd=6v17#): 国内更快，提取码已填
- [GitHub VideoSeekSetup.exe](https://github.com/6v17/VideoSeek/releases/download/v1.0.92/VideoSeekSetup.exe): 官方直链，无需提取码。sha256 `4bcbd0b9f03f55275c2b84a8fda058cdd015632d0793a69e025bdef2e521442c`
- [GitHub 发布页](https://github.com/6v17/VideoSeek/releases): 版本列表
- [上一版 123 盘 v1.0.90](https://1858268090.share.123pan.cn/123pan/VFA7vd-KKMNA?pwd=6v17#)

## 运行资源

首次至少导入**一个画面模型**和 **FFmpeg**。硬字幕 / 视频理解另需 OCR 包。下面的 sha256 是 GitHub Release 上这 5 个文件的摘要；123 盘同一文件应对上同一摘要。

- [123 盘模型资源](https://1858268090.share.123pan.cn/123pan/VFA7vd-vhJXA): 国内更快
- [GitHub Releases — models](https://github.com/6v17/VideoSeek/releases/tag/models): 官方清单，无需提取码
- [openai-clip.zip](https://github.com/6v17/VideoSeek/releases/download/models/openai-clip.zip): 默认画面模型。sha256 `7001ee89cd2f61e8d14b4608a671e71b92d6312f7fc0ded1b90ad9ddc6f1cf82`
- [chinese-clip.zip](https://github.com/6v17/VideoSeek/releases/download/models/chinese-clip.zip): 可选画面模型。sha256 `26664b4328780d9fe7912da046ec8a24723b8140d70526e3c575c578e2a18fab`
- [siglip2.zip](https://github.com/6v17/VideoSeek/releases/download/models/siglip2.zip): 可选画面模型。sha256 `ea75891dd34ca5dbb32b30e8c9da2431fd39659c8bca5294121c7504f3ac0fba`
- [ffmpeg.exe](https://github.com/6v17/VideoSeek/releases/download/models/ffmpeg.exe): 抽帧 / 导出。sha256 `1a65d5b0b10d8d9a81d2824a3538046a40ed3607c906b335a166add87613f705`
- [rapidocr-zh-understanding.zip](https://github.com/6v17/VideoSeek/releases/download/models/rapidocr-zh-understanding.zip): 硬字幕 OCR 与理解。sha256 `8bee0b642a60754dc402d499bc833d19d41f1eea2645da32bfa831cb3a04d8d8`

导入分两条路，不要混：

1. **应用内导入**：设置里「导入并解析」。**不需要 Python**。
2. **无头脚本**：资源 zip 已在本机时用。先**退出 VideoSeek**，下载脚本，在同一目录执行。脚本不下载文件，只写入已安装应用的 `%LOCALAPPDATA%\VideoSeek`。**需要本机有 Python**。不需要克隆仓库。OCR 包可以和画面模型、`ffmpeg.exe` 一起传入。

脚本：[import_runtime_resources.py](https://raw.githubusercontent.com/6v17/VideoSeek/master/scripts/import_runtime_resources.py)

```bat
python import_runtime_resources.py openai-clip.zip ffmpeg.exe rapidocr-zh-understanding.zip
```

不在源码目录里运行时，`python import_runtime_resources.py --status` 只打印 `config_file`、`model_root` 和 `packages: null`，不列出缺失项。缺失项检查只在源码检出里运行时才有。

## Docs

- [官网](https://www.lv17.top/): 人类入口；上手 / 下载 / FAQ
- [中文 README](https://raw.githubusercontent.com/6v17/VideoSeek/master/README.zh.md)
- [English README](https://raw.githubusercontent.com/6v17/VideoSeek/master/README.md)
- [Agent API 参考](https://raw.githubusercontent.com/6v17/VideoSeek/master/docs/for-agents.md): 本机 HTTP；以运行中应用的 `GET /api/v1/agent-starter` 为准
- [使用教程（飞书）](https://ycnwd8tcjgtu.feishu.cn/docx/ZWkrdSqA6oJTOrxQ2XscxYtmnad): 安装包用户图文步骤

## Optional

- [源码](https://github.com/6v17/VideoSeek)
- [Issues](https://github.com/6v17/VideoSeek/issues)
- [vlc_lib（仅 Windows 源码运行）](https://github.com/6v17/VideoSeek/releases/tag/vlc_lib)
- [许可证 AGPL-3.0](https://github.com/6v17/VideoSeek/blob/master/LICENSE)