面向本地 Claude、Codex 等 Agent 会话历史的检索工具,提供 Rust 检索内核、JSON CLI 和桌面应用。
- Star
- 1,023
- Fork
- 72
- 未关闭 Issue
- 13
- 最近提交
- 昨天
这是什么?
Kensaku 是一款面向 Windows、macOS 和 Linux 的桌面文件启动器。它会索引你指定的文件夹,支持按文件名、PDF、DOCX、EPUB、代码和日志中的正文、图片中通过 OCR 识别的文字,以及语义来搜索。输入时结果实时更新,还支持“上周”这类自然语言时间筛选,以及 type:pdf、modified:7d 等查询语法。
整个应用在本机运行,无需账号,没有遥测,也不依赖云端搜索。内存中对约 10 万个文件名的搜索平均约 1.3 毫秒,文件名和元数据索引约占 12 MB 内存。应用启动后隐藏在系统托盘,通过快捷键呼出。每个版本还附带命令行工具 kensaku-cli。
此外,Kensaku 可以通过 MCP 把本地索引开放给 AI 智能体,默认只读;也提供仅监听本机回环地址、需要 bearer token 认证的 HTTP 服务。
核心功能
- 01在一次搜索中同时匹配文件名、文档正文、图片 OCR 文字和语义。
- 02支持 PDF、DOCX、PPTX、XLSX、EPUB、RTF、代码、日志及中日韩文本。
- 03支持“上周”“3 天前”等自然语言时间筛选,以及带运算符的查询语法。
- 04增量索引,只处理变化的文件,无需整盘重新扫描。
- 05以托盘启动器形式运行,支持全局快捷键和空格键预览。
- 06通过 MCP 以只读方式向 AI 智能体开放本地索引。
适用场景
- 只记得文档内容而忘了文件名时,查找 PDF 或笔记。
- 在截图或日志文件中搜索报错信息。
- 在不把数据上传到云端的前提下,让本地 AI 智能体只读访问你的文件。
快速上手
- 1
从最新发布页面下载适合你系统的安装包
- 2
安装命令行工具并运行搜索示例
kensaku-cli search "docker error" - 3
从源码构建:克隆仓库
git clone https://github.com/yjid/kensaku - 4
安装依赖并构建桌面应用
bun install && bun run tauri build
使用前须知
- 安装包尚未进行代码签名,因此 macOS 和 Windows 首次运行时会显示警告。
- 从源码构建需要 Rust、Bun 1.1 或更高版本以及平台的 webview 库。
- 自动更新功能尚未接入。
- 目前 Windows 版本经过的真实环境测试最多,macOS 和 Linux 版本测试较少。
收录于专题
标签
常见问题
- kensaku 是什么?
- 一款免费、本地运行的开源桌面启动器,可搜索文件名、文档正文、截图文字和语义,并支持 AI 智能体通过 MCP 调用。 Kensaku 是一款面向 Windows、macOS 和 Linux 的桌面文件启动器。它会索引你指定的文件夹,支持按文件名、PDF、DOCX、EPUB、代码和日志中的正文、图片中通过 OCR 识别的文字,以及语义来搜索。输入时结果实时更新,还支持“上周”这类自然语言时间筛选,以及 type:pdf、modified:7d 等查询语法。
- kensaku 可以免费使用吗?用的什么许可证?
- kensaku 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- kensaku 还在维护吗?
- 活跃维护中。kensaku 最近一次提交是在 2026年11月6日。
- kensaku 适合用来做什么?
- 只记得文档内容而忘了文件名时,查找 PDF 或笔记。 在截图或日志文件中搜索报错信息。 在不把数据上传到云端的前提下,让本地 AI 智能体只读访问你的文件。
- kensaku 怎么安装和运行?
- 从最新发布页面下载适合你系统的安装包 安装命令行工具并运行搜索示例: kensaku-cli search "docker error" 从源码构建:克隆仓库: git clone https://github.com/yjid/kensaku 安装依赖并构建桌面应用: bun install && bun run tauri build
- 在哪里获取 kensaku?
- 源代码和安装说明在 GitHub 上:https://github.com/yjid/kensaku
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
36140RustApache-2.0维护活跃更新于 3个月前
本地优先的命令行搜索工具,结合 ripgrep、BM25 和向量检索,供人和 AI 代理查找工作区内容。
4264+51 本周261RustApache-2.0更新于 21小时前
一款私密的原生 macOS 应用,可保存网页、文本、链接、笔记和图片,并通过全文搜索和 OCR 快速找回。
88+2 本周4SwiftMIT维护活跃更新于 19天前
开源桌面 AI 智能体应用与 Rust 库,可低成本运行大量智能体。
4.3万+134 本周4212RustGPL-3.0更新于 18小时前
跨平台桌面截图、录屏与文字识别工具,素材保存在本机。
55730RustMIT维护活跃更新于 24小时前
本地优先的笔记本环境,人、Jupyter 内核和 AI 智能体可以同时编辑同一份实时文档。
19125RustBSD-3-Clause更新于 17小时前