文件插件
文件插件会搜索配置根目录中的文件和文件夹。明确想要文件结果时，使用 f 关键字，避免和应用、网页、计算等全局结果混在一起。
快速开始
text
f report
f README.md
f Documents invoice
f .pdf首次运行可能会显示索引状态。初始索引完成后，结果会更快也更完整。空的 f 查询会列出系统最近文件。
会索引哪些内容
打开 设置 -> 插件 -> 文件 管理根目录。Wox 会索引这些根目录，并跳过常见的系统目录和生成目录，避免无用结果影响搜索。
建议保持根目录小而明确：
- 推荐：home 下的常用子目录、项目目录、文档目录、挂载的工作目录。
- 避免：整个系统盘、依赖缓存、构建产物目录、虚拟机镜像目录、巨大的生成树。
快速索引（Windows）
在 Windows 上，文件搜索可以使用可选的快速索引。打开 设置 -> 插件 -> 文件，安装 Wox 的 NTFS 服务。该服务通过卷的 MFT 和 USN 保持大容量 NTFS 磁盘更新，而不必整盘爬取。安装服务需要管理员权限。
快速索引只在 Windows 上提供。macOS 和 Linux 仍使用常规的根目录索引。内容搜索目录和文件名根目录是分开配置的。
功能概览见文件搜索启动器。
动作
| 动作 | 用途 |
|---|---|
| 打开 | 用默认应用打开文件或文件夹 |
| 进入文件夹 / 浏览目录 | 按 Shift+Enter 在 Wox 内浏览选中的文件夹，或文件的所在目录 |
| 打开所在文件夹 | 在文件管理器中显示结果 |
| 删除 | 移入废纸篓 |
| 显示上下文菜单 | 在可用平台上使用系统文件菜单 |
进入目录后，继续按 Shift+Enter 可以浏览子文件夹。Enter 仍使用默认应用打开文件或文件夹。
搜索技巧
- 用文件名片段：
f invoice q1。 - 知道扩展名时加上扩展名：
f proposal .pdf。 - 空格分隔的条件按 AND 匹配，顺序不限：
f amiga .txt可以找到amiga_workbench.txt。连续短语用双引号包裹：f "release notes" .txt。 - 名称太常见时加目录线索：
f design README。 - 结果太多时，优先收窄配置根目录，而不是只靠更长的查询。
索引状态
文件插件在准备、扫描或同步根目录时会显示工具栏状态。首次启动、修改根目录或大量移动文件后，这是正常现象。
如果状态提示权限问题，给 Wox 对应目录的访问权限，然后等待索引刷新。
排查
文件搜不到
- 确认文件在配置的根目录下。
- 确认 Wox 有权限读取该目录。
- 如果文件刚创建，等索引完成。
- 如果是外置磁盘或网络挂载，在 Wox 启动后才连接，重启 Wox 再试。
搜索很慢
- 从根目录中移除巨大的生成目录。
- 只保留真正需要搜索的位置。
- 如果工具栏状态长时间停在某个阶段，查看 Wox 数据目录下的日志。