dowse 0.8.0

本地文件全文搜索引擎核心库:tantivy 倒排索引 + jieba 中文分词,含编码探测、NTFS/USN 快速索引与 Windows OCR
# dowse


**Windows 本地文件极速全文搜索**的命令行工具,基于 [tantivy](https://github.com/quickwit-oss/tantivy) + jieba 中文分词。同时可作为 [MCP](https://modelcontextprotocol.io) 服务,供 AI 客户端调用本地搜索能力。

> ⚙️ **平台**:主要面向 **Windows**(NTFS/USN 快速索引、OCR 均为 Windows 专属能力)。
> 其他平台可编译安装,核心全文检索仍可用,但上述加速/OCR 功能会自动降级停用。
> **需要 Rust 1.85+**(edition 2024)。

## 安装


```sh
cargo install dowse
```

## 用法


```sh
# 建索引(全量)

dowse index D:\notes

# 搜索

dowse search 分布式 限流器          # 多词默认 AND
dowse search "rate limiter"         # 引号短语
dowse search 报告 -n 20             # 最多 20 条
dowse search 笔记 --ext md,txt      # 只搜指定扩展名
dowse search 笔记 --sort mtime_desc # 按修改时间排序(relevance/mtime_desc/mtime_asc/size_desc)

# 查看索引概况:位置、文档数、落盘体积、已注册根、最近更新时间

dowse status

# 前台监听文件变更、实时增量更新(调试用),Ctrl+C 退出

dowse watch

# 作为只读 MCP 服务对接 AI 客户端,例:

#   claude mcp add dowse -- dowse mcp

dowse mcp
```

## 功能


- 中文分词全文检索(jieba + tantivy,BM25 相关性排序)
- 多词 AND、引号短语、扩展名过滤、多种排序
- 自动编码探测(GBK / UTF-8 等)
- PDF / Office / 纯文本内容抽取
- 增量索引 + 文件变更实时监听
- NTFS/USN 快速索引与图片 OCR(Windows)
- 作为 MCP 服务对接 AI 客户端

## License


MIT OR Apache-2.0