yjid/kensaku

免费开源的本地文件搜索启动器:文件名、文件里的正文(PDF、DOCX、EPUB 等)、截图里的文字(OCR)和语义一起搜,还能通过 MCP 让 Claude、Cursor 等代理只读地搜同一份索引。

免费开源的本地文件搜索启动器:文件名、文件里的正文(PDF、DOCX、EPUB 等)、截图里的文字(OCR)和语义一起搜,还能通过 MCP 让 Claude、Cursor 等代理只读地搜同一份索引。

星数 221(+216 / 24h)

理由

  • 作者称在 Linux 上对 10 万个文件做文件名搜索平均 1.3 毫秒,文件名和元数据约占 12 MB 内存;首次索引 101101 个文件用了 184 秒
  • 支持自然语言时间(“上周的截图”)和查询语法(type:pdf、size:>10mb、modified:7d、re: 正则等);OCR 默认 PP-OCRv6,Intel Mac 退回 Tesseract
  • MCP 默认只读、reindex 默认关闭,返回内容有大小上限并按数据而非指令返回;不收集遥测,.pem、.key 等凭据文件默认不索引

用法

  • 从 Releases 下载 Windows exe / msi、macOS 通用 dmg 或 Linux AppImage / deb / rpm,首次运行选要索引的文件夹,可选下载 OCR 和模型包
  • MCP 客户端里把 command 设为 kensaku-cli、args 设为 ["mcp"];走 HTTP 的客户端用 kensaku-cli serve(只监听本机,需要令牌)

风险

  • 安装包还没有代码签名,macOS 和 Windows 首次运行会报警;自动更新还没接上
  • 索引里有文件名和提取出的正文,作者提醒不要同步到共享位置;性能数字是作者在 Linux 上自测,没和 Spotlight、Everything 比过;仓库 10 月 24 日建,许可证 MIT

打开

GitHub

浏览最新 AI 动态