AB
AB
AiBoss站

全部分类

project

kensaku - 本地文件全文与语义搜索的跨平台启动器

kensaku 是一款 MIT 许可的本地文件搜索工具，据项目自述可对文件名、文件内文本、图片 OCR 文字与语义进行统一检索，并通过 MCP 向 AI 代理开放只读索引。本文整理其维护状态、主要能力、安装入口与已知限制。

kensaku 是一个面向个人电脑的本地搜索工具，定位是「按你记得的方式找到文件」：不只匹配文件名，还检索文件内部的文本、图片中的文字，以及用自然语言描述的含义。它同时具备启动器形态——常驻托盘、快捷键唤出、输入即出结果、回车打开。适合文件量大、经常只记得内容而记不住文件名的用户，也适合希望让本地 AI 代理读取自己文件索引的开发者。据项目自述，全部检索在本地完成，不上传云端。

维护者与状态

项目由 yjid 维护，仓库创建于 2026-10-24，最后提交时间为 2026-11-02。最新正式版本为 v1.0.12，发布于 2026-11-02。截至 2026-11-03，仓库星标数为 569。项目采用 MIT 许可证。

需要说明的是，素材中的状态章节标注的版本号与事实表中的最新 release 不一致，本文的版本信息以事实表为准。素材还提到，当前构建尚未进行代码签名，因此 macOS 与 Windows 首次运行时会出现系统警告，项目方称这对独立应用属于预期现象。

主要能力

以下内容据项目 README 自述整理，未经独立验证。

  • 文件名快速检索：项目称在热缓存下对约 10 万个文件进行文件名搜索只需数毫秒，结果随输入实时更新，没有单独的搜索页。
  • 文件内容全文检索：支持 PDF、DOCX、PPTX、XLSX、EPUB、ODT/ODS/ODP、RTF 与纯文本等文档格式，以及 50 多种代码与数据格式，包括 Rust、Python、TypeScript、Go、C/C++、Java、Shell、SQL、JSON、YAML、TOML、Dockerfile 等。
  • 图片 OCR：默认使用 PP-OCRv6，无需额外安装；设置中可切换质量更高的 Indra 引擎（含纠偏、多文字系统识别，约 27 MB 包）或经典 Tesseract。
  • 中日韩与多语言处理：项目称内置针对中文（汉字/注音）、日文（汉字/假名）、韩文（谚文）的自定义 unigram + bigram 分词器，并处理混排文字边界。
  • 语义检索与自然语言时间：可用「关于索引的那份 PDF」这类描述查找，也支持「上周二」「3 天前」「上周」「今天」「昨天」等时间表达。
  • 查询语言：提供 type:pdf、ext:md、in:、modified:7d、size:>10mb、path:、lang:rust、name:、content:、re: 等语法，便于脚本化精确检索。
  • 启动器体验：托盘隐藏启动、全局快捷键唤出、最近打开记录按实际打开行为排序并跨重启保留、空格键快速预览 PDF/图片/文本、网格或列表布局、全键盘导航、明暗主题。
  • 增量索引：变更文件会被增量拾取，无需全盘重扫；项目称会跟踪重命名与删除。
  • 面向 AI 代理的 MCP 接口：兼容的代理可通过 MCP 检索同一份本地索引，默认只读；也支持通过 kensaku-cli serve 以回环 HTTP 方式接入，需配置目录中的 bearer token。
  • 隐私设计：项目称无账号、无遥测、无云搜索，索引保存在操作系统配置目录；默认跳过隐藏文件与常见构建目录，并排除 .pem、.key、.pfx 等凭据文件；默认遵循 .gitignore 与 .cursorignore。

使用入口

仓库地址：yjid/kensaku。

据项目说明，可从最新 release 下载对应平台的安装包：Windows 提供 .exe 或 .msi，macOS 提供通用 .dmg（Apple silicon 与 Intel），Linux 提供 .AppImage、.deb 或 .rpm。每个 release 同时附带命令行工具 kensaku-cli 与 SHA256SUMS 校验文件。首次运行时需选择要索引的文件夹、设置排除项，并可选择下载 OCR 或模型包；首次扫描期间搜索即可使用。

命令行用法示例：

kensaku-cli search "docker error"
kensaku-cli search "invoice" --ext pdf --since 30d
kensaku-cli search "resume" --json
kensaku-cli state

接入 MCP 客户端时，项目给出的配置形式为：

{
  "mcpServers": {
    "kensaku": {
      "command": "kensaku-cli",
      "args": ["mcp"]
    }
  }
}

从源码构建需要 Rust 稳定版、Bun 1.1 或更高版本，以及对应平台的 webview 库；仓库提供 Makefile，包含 make dev、make build、make test、make reset 等常用任务。

许可与限制

许可证为 MIT。素材中列出的已知限制包括：构建尚未代码签名，macOS 与 Windows 首次运行会弹出系统警告，需按文档指引手动放行；索引本身包含文件名与抽取出的文本，项目建议将其视为敏感数据，不要同步到共享位置；代理工具不能修改文件，reindex 默认关闭，需手动启用。

关于性能，项目自述的数字均来自 Linux 发布构建（8 vCPU、SSD）对 10 万文件目录的测量，并明确说明 Spotlight、Everything、Listary 尚未测量，数据也并非来自 macOS 或 Windows。这些数字属于项目自述，本文未做复现。此外，OCR 与语义检索依赖可选模型包，实际效果与磁盘占用会随所选引擎不同而变化。

返回