yjid/kensaku

选用指南

AI 根据 README 整理 · 2026/10/31 08:01:42

适用场景

适合需要快速查找本地文件内容、截图文字或按语义搜索的场景，例如查找包含特定错误的日志或截图。

查看 README 依据

<img src="assets/hero.png" width="100%" alt="Kensaku — find anything on your computer" /> </p> --- ## Find it the way you remember it You don't remember the filename. You remember what was in it. - The PDF about database indexing, saved as `notes-final-2.pdf`. - The log line from the failed deploy, somewhere in a folder of logs. - The screenshot with a CUDA error, which has no useful name at all. Type what you remember. Kensaku searches names, text inside files, and meaning, and shows the match with the words highlighted. Open it with Enter. ## What Kensaku does that the others don't

使用方式

作为桌面应用使用，支持全局快捷键唤起，也提供命令行工具 kensaku-cli 进行搜索。

查看 README 依据

higher-quality Indra engine (deskew, multi-script recognition, ~27 MB pack downloaded on demand) and classic Tesseract are both selectable in Setup/Settings. **Precise** - Filters and sort: Best match, Newest, Oldest, Largest, Name. - Time travel: "last Tuesday", "3 days ago", "last week", "today", "yesterday". - A query language when you want it (below). **A real launcher** - Starts hidden in the tray and summons with a keystroke. Recents are ranked by what you actually opened, and they survive restarts.

- **macOS:** open the app, then go to System Settings → Privacy & Security and click **Open Anyway**. [docs/INSTALL.md](docs/INSTALL.md) has the full steps. **First run:** choose the folders you want indexed, pick exclusions, and optionally download the OCR or model packs. Search works while the first scan runs. **Command line:** `kensaku-cli` ships with each release. ```bash kensaku-cli search "docker error" kensaku-cli search "invoice" --ext pdf --since 30d kensaku-cli search "resume" --json kensaku-cli state ``` ### Build from source ```bash git clone https://github.com/yjid/kensaku

部署要求

支持 Windows、macOS 和 Linux，需要下载对应平台的安装包；从源码构建需要 Rust、Bun 1.1 或更高版本以及平台 webview 库。

查看 README 依据

| Platform | Download | |---|---| | Windows | `Kensaku_<version>_x64-setup.exe` or `.msi` | | macOS (Apple silicon and Intel) | `Kensaku_<version>_universal.dmg` | | Linux | `.AppImage`, `.deb`, or `.rpm` | Every release also ships `kensaku-cli` for the command line and a `SHA256SUMS` file so you can verify what you downloaded. Builds are not yet code-signed, so macOS and Windows show a warning the first time. That is expected for an independent app, not a sign of a problem. - **Windows:** on the SmartScreen prompt, click **More info** → **Run anyway**.

cd kensaku bun install bun run tauri build ``` You need Rust (stable), Bun 1.1 or later, and your platform's webview libraries. See [docs/INSTALL.md](docs/INSTALL.md). A `Makefile` covers the common tasks: `make dev`, `make build`, `make test`, and `make reset`. ## Connect AI agents (MCP) Point an MCP client at the CLI: ```json { "mcpServers": { "kensaku": { "command": "kensaku-cli", "args": ["mcp"] } } } ``` For clients that connect over HTTP, run `kensaku-cli serve`. It listens on loopback only and requires a bearer token stored in your config directory.

已知限制

构建尚未代码签名，自动更新未启用；OCR 默认使用 PP-OCRv6，可选 Indra 引擎，Intel Mac 回退到 Tesseract，且不支持 JPEG 2000、传真和 JBIG2 扫描；缩略图仅覆盖图片文件。

查看 README 依据

- Agent access over MCP and loopback HTTP, with one-click setup for Claude and Cursor - `.gitignore` and `.cursorignore` respected by default **Known limitations** - Builds are not yet code-signed, and the auto-updater is not wired up yet. - OCR: PP-OCRv6 by default (bundled runtime, ~6 MB model pack downloaded on first run); optional Indra engine with deskew and multi-script recognition (~27 MB pack, downloaded on demand). Intel Macs fall back to Tesseract. JPEG 2000, fax and JBIG2 scans are not decoded yet. - Thumbnails cover image files only. Documents and code show type icons.