yjid/kensaku

Kensaku 是一款本地优先的桌面搜索启动器，支持 Windows、macOS 与 Linux。它不只匹配文件名，还会读取文档、代码、日志和截图里的内容，再按相关度、时间或大小排序结果，通过快捷键唤出窗口即可打开。它适合记得内容、却记不住文件名，并且希望搜索留在本机的人。

工作方式的变化

核心变化是按记忆中的内容来搜索。存成 notes-final-2.pdf 的 PDF 可以靠正文找到；文件名毫无意义的截图，可以靠图上显示的错误信息找到。查询既可以用自然语言（如"上个月的大视频"），也可以用查询语法按类型、扩展名、目录、修改时间和正则过滤。输入时结果实时更新，按 Space 可预览 PDF、图片和文本。

索引只需一遍扫描：每个文件同时进入文件名索引和正文索引，之后增量拾取变化并跟踪重命名和删除。作者报告，在 10 万文件、内存热索引的条件下，文件名搜索平均 1.3 ms，文件名与元数据约占 12 MB；具体测试条件和对比局限见性能章节与基准。

使用路径

• 桌面应用： 主要路径，覆盖 Windows、macOS 与 Linux。安装包尚未代码签名，因此 macOS 和 Windows 首次运行时都会出现警告；步骤见安装指南。自动更新器尚未接入。
• 命令行： 每次发布都附带 kensaku-cli，支持文本和 JSON 搜索结果，以及查看索引状态。
• AI 代理通过 MCP 访问： 支持 MCP 的客户端可连接 kensaku-cli mcp；需要 HTTP 的客户端可用 kensaku-cli serve，它只监听回环地址并要求 bearer token。代理工具只读，除非主动启用，reindex 默认关闭。配置见 MCP 章节和代理指南。

前提与限制

用户自行选择索引目录并设置排除项；隐藏文件和常见构建目录默认跳过，.pem、.key、.pfx 等凭据文件默认排除。OCR 已内置：默认使用 PP-OCRv6，首次运行下载约 6 MB 的模型包，Intel Mac 回退到 Tesseract。JPEG 2000、传真和 JBIG2 扫描件暂不支持解码。缩略图只覆盖图片，视觉搜索仍是 beta 下载项，尚未进入搜索结果。

作者说明，目前 Windows 获得的真实环境测试最多，macOS 和 Linux 构建由 CI 产出，还需要更多实际使用反馈。从源码构建需要 Rust 稳定版、Bun 1.1 或更高版本，以及平台 webview 库（也可使用仓库自带的 Makefile 任务）。索引本身属于敏感数据，包含文件名和提取出的文本，作者建议不要同步到共享位置。完整威胁模型见 SECURITY.md。

项目采用 MIT 许可证。HotRepo 在 2026-10-29 的 rust 新项目榜记录到 197 个总 star；这只是单日快照，不能说明增长趋势。