SwiftList：高性能、可扩展的 Windows 全局检索系统 #

SwiftList 是什么？ #

SwiftList 是一款为 Windows 打造的、键盘优先的极速文件检索启动器，官方将其定位为「高性能、可扩展的 Windows 全局检索系统」，也是商业级文件检索启动器 Listary 的开源替代方案。

它会在后台索引本地磁盘（NTFS 与 ReFS 通过各自的变更日志，其他文件系统直接监听变化）以及网络共享，让你在极短时间内跳转到任意文件、文件夹或应用程序。区别于传统搜索工具，SwiftList 提供主窗口、快速窗口、内嵌窗口三种形态，按下全局热键（默认双击 Ctrl）即可呼出紧凑弹窗，输入关键词、回车直达结果。对于需要频繁在数万乃至数百万文件中定位素材、代码、文档的重度 Windows 用户，SwiftList 用「秒级索引 + 模糊匹配 + 全面可自定义热键 + 开放插件生态」的组合，把找文件这件事压缩成几次按键。它同时提供安装包与便携版，分别覆盖 x64 与 ARM64 两种架构。

SwiftList 有哪些亮点特色？ #

• Listary 的开源替代：官方明确以「现代化高颜值界面 + 支持深度扩展定制」为目标，全面替代并超越商业级文件检索启动器，既有商业软件的体验，又保持开源透明。
• 基于 USN 日志与 MFT 的极速索引：直接利用 Windows USN 日志与 MFT 机制读取磁盘元数据，秒级完成数百万文件的索引，且后台 Service 进程轻量共享，不拖慢系统。
• 模糊匹配与别名体系：支持前缀、后缀、精确、排除等搜索操作符，以及或组、盘符定向、路径模式等进阶写法；对中文文件名还能用拼音别名匹配，输入 wx 就能命中「微信」这类目标。
• 热键全面可自定义：呼出窗口、上/下一项、动作菜单、QuickLook 预览……每一个热键都能按个人习惯重新绑定，完整默认绑定表在用户手册中逐条列出，零学习成本迁移原有习惯。
• 三种窗口自适应场景：主窗口提供最大结果列表与窗内动作面板；快速窗口是置顶的紧凑弹窗，专为「按热键 → 输入 → 回车」的肌肉记忆设计；内嵌窗口则可把搜索框直接塞进受支持的原生文件对话框或文件资源管理器窗口中。
• 开放的插件生态：提供 SwiftList.PluginSdk，插件只是一个普通的 .NET 类库（目标框架 net10.0-windows），可实现自定义搜索源、右键菜单动作、侧栏过滤器、结果列、文件预览、缩略图、主题与语言包等扩展，DLL 放入 Plugins/ 即可被 App 自动扫描加载。
• 服务与界面彻底分离的资源隔离：SYSTEM 服务级后台索引（SwiftList.Service）与 Session 级用户 App 界面完全分离，既保证了索引的稳定性与权限边界，也让用户态界面保持安全、轻量、高效。
• 命令行与 URI 协议双通道：内置 slf 命令行伴侣（fzf 风格），可在终端里直接检索；同时注册 swiftlist:// URI 协议，用一条链接、别的程序或脚本就能跳转到某次搜索或某项设置。

免费下载 SwiftList #

以下为官方提供的各平台安装包，按架构分为 x64 与 ARM64 两种，各有安装包与便携版可选，点击链接即可下载。

说明：x64 版本在绝大多数电脑上都能运行，包括 Windows on ARM 设备（以模拟方式运行）；ARM 设备建议改用对应的 ARM64 原生版本以获最佳性能。自动更新会一直保持在你安装时的架构上，如需更换架构需重新下载。

SwiftList 如何使用？ #

1. 完成首次运行：首次启动时，SwiftList 会安装并启动一个 Windows 服务（SwiftList.Service），专门负责文件索引。可以打开 设置 → 运行状态 查看服务是否已安装、是否正在运行，未安装也可以在这里手动安装。
2. 选择你的窗口形态：从任务栏或开始菜单打开的是 主窗口，结果列表最大并带窗内动作面板；日常使用则直接按下全局呼出热键（默认 双击 Ctrl）唤出 快速窗口，这是最省事的入口。
3. 直接开始打字：结果随输入实时更新并按相关度排序，用可配置的上/下一项热键（默认方向键）移动选中项，回车打开高亮结果。不需要输入任何内容时，快速面板里的 最近文件、收藏夹、历史记录 三个标签同样取用方便，该面板叠在当前前台窗口上打开。
4. 进阶搜索语法：用前缀、后缀、精确、排除等操作符收窄范围，用或组、盘符定向、路径模式进行精细筛选，中文文件可直接用拼音别名匹配——详见用户手册的「搜索语法」章节。
5. 善用动作菜单与插件：对选中结果呼出动作菜单（类右键菜单），可直接调用 QuickLook 预览；「即时答案」提供计算器、环境变量、运行命令等快捷能力，进程管理、窗口切换器、翻译、浏览器数据、设置搜索、网页搜索等则由关键词触发。终端用户还可以用 slf 命令行伴侣，或通过 swiftlist:// 链接直接从脚本跳转到某次搜索。

SwiftList 的常见问题？ #

安装包和便携版有什么区别，该选哪个？ 安装包（SwiftList-Setup.exe）会自动处理依赖并注册后台索引服务，还可以设置为随 Windows 启动，官方推荐使用。便携版（SwiftList-Portable.zip）解压即可运行、无需安装，之后仍可在 设置 → 运行状态 里手动安装后台服务。

首次运行提示要安装一个 Windows 服务，是正常的吗？ 正常。SwiftList 有意把后台索引拆分为独立的 SwiftList.Service 服务进程，与用户态的 App 界面资源隔离，以获得更好的稳定性和权限边界。可以在 设置 → 运行状态 中随时查看与安装。

我的电脑是 ARM 设备，应该下载哪个版本？ 优先选择原生版本：SwiftList-Setup_arm64.exe 或 SwiftList-Portable_arm64.zip。x64 版本在 Windows on ARM 设备上虽然也能以模拟方式运行，但性能不如原生。注意自动更新会保持在你安装时的架构上，换架构需要自己重新下载。

便携版提示缺少 .NET 桌面运行时怎么办？ 便携版不自带运行环境，如果电脑上还没有 SwiftList 所需的 .NET 桌面运行时，运行一次自带的 install-dotnet-runtime.bat 即可；安装包会自动处理这一步，不需要手动操作。

便携版用完直接删文件夹可以吗？ 不建议直接删除。便携版没有卸载程序，删除文件夹前请先双击自带的 portable-cleanup-registry.reg（确认弹窗提示），它会移除 SwiftList 自己创建的两项每用户注册表项——swiftlist:// URI 协议注册与「开机自动启动」。两者都只在 HKCU（当前用户）范围内，不需要管理员权限。

可以用命令行或脚本调用 SwiftList 吗？ 可以。SwiftList 内置 slf 命令行检索工具，风格接近 fzf；同时注册了 swiftlist:// URI 协议，可通过一个链接、其他程序或脚本直接跳转到某次搜索或某项具体设置。

SwiftList 如何安装？ #

SwiftList 目前仅面向 Windows 平台（同时提供 x64 与 ARM64 架构版本），安装方式分为两类。

方式一：使用安装包（推荐）

1. 确认系统架构：普通 PC 下载 SwiftList-Setup.exe；Windows on ARM 设备下载 SwiftList-Setup_arm64.exe。
2. 双击运行安装程序，按提示完成安装。安装包会自动处理 .NET 桌面运行时依赖。
3. 安装过程中会注册并启动后台索引服务 SwiftList.Service，可勾选设置为随 Windows 启动。
4. 安装完成后从开始菜单或桌面快捷方式启动，首次运行会开始建立索引。

方式二：使用便携版（免安装）

1. 下载对应架构的压缩包：SwiftList-Portable.zip（x64）或 SwiftList-Portable_arm64.zip。
2. 解压到任意目录（建议放在固定路径，避免后续移动导致快捷方式失效）。
3. 如果系统缺少 .NET 桌面运行时，先运行目录内的 install-dotnet-runtime.bat。
4. 运行主程序即可使用；如需后台索引服务，可在 设置 → 运行状态 中手动安装。

插件安装补充：插件是普通的 .NET 类库，编译后将生成的 DLL 复制到 SwiftList App 的 Plugins/ 文件夹（与 SwiftList.App.exe 同级），App 启动时会自动扫描并加载其中的每一个插件程序集。

SwiftList 如何卸载？ #

卸载安装包版本

1. 打开 Windows「设置 → 应用 → 已安装的应用」（或控制面板的「程序和功能」）。
2. 找到 SwiftList，选择卸载并按照向导完成操作。
3. 如果后台索引服务未被一并移除，可在卸载前先进入 设置 → 运行状态 查看服务状态，或在系统的「服务」管理界面确认 SwiftList.Service 已停止并移除。
4. 建议重启一次系统，确保服务句柄与索引缓存被彻底释放。

卸载便携版

1. 关闭正在运行的 SwiftList 程序。
2. 双击便携版目录下自带的 portable-cleanup-registry.reg，在确认弹窗中确认，清除 SwiftList 创建的两项每用户注册表项（swiftlist:// URI 协议注册与「开机自动启动」）。
3. 若此前手动安装过后台服务，请先在 设置 → 运行状态 中将其卸载。
4. 直接删除便携版所在的整个文件夹即可完成卸载。

残留清理提示：SwiftList 的注册表改动均在 HKCU（当前用户）范围内，无需管理员权限即可清理；如果你曾自定义过热键、收藏夹、历史记录或插件配置，卸载后相关配置可能仍保留在用户目录下，可按需手动删除。官网文档未逐一列出全部配置文件的存放路径，删除前建议先做好备份。