dowse(问渠) Skill 技能

Windows 原生本地文件全文搜索工具,把 PDF/Office/截图/源码统一索引,通过 MCP 让 Claude

技能简介

dowse(中文名「问渠」)是一款专为 Windows 平台打造的本地文件内容搜索工具与 MCP server。英文名取自 dowsing rod(探水杖),中文名取自朱熹《观书有感》"问渠那得清如许,为有源头活水来"——你的文件是源头,dowse 帮你随时问得到。它把文件名、PDF 与 Office 文档正文、源代码、Markdown、截图里的文字统一纳入一份本地全文索引,通过 Alt+` 快捷键一键呼出;同时通过 stdio 暴露只读 MCP server,让 Claude Code、Cursor、Codex 等 AI 编程工具能直接调用本地搜索能力。

核心能力

  1. 文档内容全文搜索:支持纯文本、Markdown、源代码、PDF、DOCX、XLSX、PPTX 格式,自动识别 GBK 编码后入索引,专门解决中文老文件乱码问题。
  2. 截图与图片 OCR:本地调用 Windows.Media.Ocr 引擎识别 PNG/JPG/WebP/BMP 截图文字,zh-Hans 语言包覆盖中英混排,无需联网、不上传图片。
  3. 中文分词与排序:jieba 分词 + BM25 排序引擎(tantivy 实现),不是 trigram 切分,中文短语检索更精准。
  4. MCP server 暴露:通过 stdio 把本地搜索能力暴露给 AI agent,提供搜索、长预览、索引状态三类只读工具,agent 不能写文件或删除文件。
  5. NTFS 快速层:管理员权限下启用 MFT 直读 + USN Journal,把海量小文件的文件名搜索压到毫秒级;非管理员权限静默回退常规路径。
  6. 增量索引:运行时监听文件变化,启动时按 mtime/size 对账补齐,新增文件夹不重建已有索引。
  7. 全本地零联网:解析、建索引、OCR、查询全部本地运行,应用不含任何遥测,索引文件需用户自行保护。

安装配置

  1. 从 GitHub Releases 下载 dowse-app_*_x64-setup.exe(当前 0.9.0 版本约 14.98MB),首次运行 Windows SmartScreen 会拦截,点击「更多信息 → 仍要运行」即可继续。
  2. 启动后点击「添加文件夹」选择要索引的目录,等待首次全文索引完成(实测 15100 文件约 46.6 秒,其中 5100 张图片 OCR 全部完成)。
  3. 配置 Claude Code:claude mcp add --scope user dowse -- dowse mcp;其他 MCP 客户端写入 {"mcpServers":{"dowse":{"command":"dowse","args":["mcp"]}}}。

使用步骤

  1. 快捷键呼出:任意界面按 Alt+` 唤出 Acrylic 搜索浮窗,输入即搜、秒级返回。
  2. 基础搜索:输入文件名关键词,或文档正文中的中文短语、英文短语、错误堆栈关键字。
  3. 高级过滤:支持 path:报告、mtime:>2026-01-01、size:>10mb、ext:pdf 操作符,引号短语按位置精确匹配,大写 OR 分组、-词 排除。
  4. 键盘操作:方向键选择结果,Enter 打开,Ctrl+Enter 在资源管理器中显示,Shift+Enter 复制路径,结果集自动分页(每页 50 条)。
  5. AI 编程工具联动:在 Claude Code / Cursor 中直接对话提问,例如"找出 D:docs 里所有提到 Q3 财报的 PDF"或"在 src/ 里搜报错的函数调用栈"。

适用场景

  1. 在大量历史项目代码、合同、文档、论文中快速检索关键字、版本号、客户名、章节标题。
  2. 让 Claude Code、Cursor 等 AI 编程工具在大型代码库里直接搜函数实现、TODO 注释、错误堆栈,避免手动复制粘贴文件路径。
  3. 检索设计稿、截图、PPT 中的文字内容(UI 标注、会议纪要、白板照片)。
  4. 跨语料库搜索 PDF、Word、Excel、PowerPoint 正文,构建本地个人知识库。
  5. 隐私敏感场景:本地完全离线、不联网、不上传,适合法律、医疗、金融、研究人员处理敏感材料。

适用人群

Windows 重度用户、工程师、研究人员、律师、记者、内容运营者;需要在本地让 AI 编程工具直接搜索文件内容的开发者;不愿把文件上传到云端做全文搜索的隐私敏感用户;中文工作流为主、需要正确处理 GBK 老文件的用户。

工作原理

底层用 Rust 编写,搜索内核基于 tantivy 倒排索引引擎,桌面端用 Tauri 框架构建。索引器、命令行、桌面应用、MCP server 共用同一份本地索引,搜索结果完全一致。MCP 端只暴露只读工具(搜索、长预览、索引状态),不允许 agent 代用户写文件或删除文件,安全性可控。

官方链接

团队信息

由 AI 猎手自动发现

评论与建议

0 条评论