WinShun

截图 · Screenshots

中文

Win顺 是 Windows 上免费开源的快速搜索启动器：连按两下 Ctrl 弹出搜索框，边打字边出结果。按文件名或拼音秒找文件，搜 Word、Excel、PDF 里的文字，打开应用和系统设置，还有剪贴板历史、对话框搜索、任务栏搜索框、插件和给 AI 用的 MCP 搜索。

它直接读 NTFS 主文件表（MFT）建索引，三百多万个文件几秒建好，增删改名实时跟上，不用装 Everything。不需要账号，不上传数据。界面有简体中文和英文。

功能

🔍 文件搜索

• 双击 Ctrl 打开，再按一次或 Esc 关闭；三百多万个文件里搜一次只要几毫秒。
• 拼音和首字母：ndbg → 年度报告，baog → 报告；多音字按常用读音。
• 搜整台电脑：所有本地磁盘，U 盘可选；NAS、内网共享文件夹（SMB） 也能加进来一起搜，服务器关机时收录过的照样能搜到。
• 排序懂你：自己的文件在前，系统目录、node_modules 在后，名字完全一样的最前。每行显示修改日期，Ctrl+S 在最匹配、最新、最早之间切换。不输入时列出最近打开或最近修改的文件。
• 数字键直达：按住 Ctrl 显示序号，Ctrl+1～Ctrl+9 打开第几行（也可改成 Alt）。
• 只找文件夹：选中 文件 后再按 Tab。
• 拖出去就能用：结果直接拖进微信、邮件、资源管理器。
• 实时更新：读 USN 变更日志，改名、新建、删除马上搜得到；拔 U 盘不会提示“设备正在使用”。

📄 文件内容全文搜索

• 切到 内容 范围，搜文件里的文字，结果显示命中的那一行。
• 能搜的文件：
  • 纯文本：txt、md、log、csv、json、代码等；
  • 文档：Word、Excel、PowerPoint、PDF、WPS，结果里显示第几页、第几张幻灯片或哪个表的第几行。
• 怎么找：可以写多个词、用引号找整个短语，结果按相关度排。
• 编码和速度：自动识别 UTF-8、UTF-16、GBK 编码；有内容索引，几十万个文件也很快。
• 安全：文档由一个权限受限的独立进程读取。

🚀 应用和系统设置

• 应用：开始菜单里的所有应用都能搜，含 Microsoft Store 应用。名称、拼音、首字母（vsc）、程序名（winword）都行；Ctrl+Shift+Enter 以管理员身份运行。
• 系统设置：约 1200 个 Windows 设置页和控制面板项。shipeiqi、“网卡”、ncpa.cpl 都能打开网络连接；另外补了组策略、磁盘管理、hosts、AppData 等开始菜单里没有的。

🌐 网页搜索 · ⭐ 收藏夹 · 🧩 插件

• 网页搜索：baidu 天气、zhihu 显卡、jingdong 键盘，关键词加空格就在那个网站上搜。
  • 自带百度、必应、B 站、知乎、微博、抖音、小红书、淘宝、京东、翻译。
  • 可以用 %s 网址添加自己的网站，图标、列表都能导入导出。
• 收藏夹：
  • 右键“加入收藏夹”，不打字时排在最前；
  • 起个关键词，一打就开；
  • 收藏的文件夹按 Tab 进去接着搜。
• 插件：
  • 随包的小工具：= 1+2*3 计算器、12 inch to cm 单位换算、#ff8800 颜色，还有时间戳、UUID、Base64、哈希；
  • kill 结束进程，bm 搜浏览器书签，tr 翻译；
  • 自己写插件：零代码的 plugin.json、任意语言的脚本或常驻进程都行，附 Python / PowerShell / C++ SDK；
  • 插件以普通权限、限内存运行。见 docs/plugins.md。

📂 “打开”“另存为”对话框

• 对话框旁的搜索框：输入文件夹或文件名（拼音也行），回车，对话框直接转过去；网页上传文件、WPS 的对话框也认。
• Ctrl+G：转到资源管理器、Total Commander 或 Directory Opus 正在显示的文件夹，和 Listary 的同名快捷键一样。
• 不输入时：列出打开着的文件夹、刚复制的路径、收藏和最近用过的文件夹。
• 自动转过去：可以设成对话框一出现就转到文件管理器的文件夹。

📋 剪贴板历史（代替 Win+V）

• 记什么：复制过的文字、图片、文件都记下来。
• 怎么打开：Win+V 或自设的快捷键；开在输入光标旁，不抢焦点。
• 怎么粘贴：双击或 Enter 粘贴，Shift+Enter 粘贴为纯文本，Alt+1～9 直接粘贴第几条。
• 能搜：拼音搜索，@wx 只看微信里复制的；图片里的字也能搜（Windows 自带的文字识别 OCR，在本机，不联网）。
• 预览：全文、大图、颜色值的 HEX / RGB / HSL。
• 整理：固定、分组、多选按顺序合并粘贴，钉住后可以一条接一条地往表格里填。
• 隐私：密码管理器复制的密码不记录，历史只存在本机。

🔎 任务栏搜索框（代替 Windows 搜索）

• 在 Windows 11 任务栏上放 Win顺 自己的搜索框（Windows 10 是固定一个按钮），结果从任务栏上方滑出。
• 可以接管 Win+S，开始菜单里打字也用 Win顺 搜。

🤖 AI 助手（MCP）

• 能做什么：Win顺 是一个 MCP 服务器，AI 能用它搜文件名、文件内容和最近修改的文件。
• 怎么连：Claude Desktop、Claude Code、Cursor、VS Code 在设置里一键连接。
• 安全：
  • 默认只读，只看得到 AI 客户端自己有权限看的文件；
  • 可以设不让 AI 看到的文件夹；
  • 每次调用都有记录。

🎨 外观和设置

• 外观：浅色、深色跟随系统，Windows 11 云母（Mica）效果和圆角；图标在 150% 缩放下也清晰。
• 设置：可以搜索（Ctrl+F，kjj 找到“快捷键”），改了立即生效。
• 更新：有新版本时在托盘提醒，Win顺 不会自己下载、替换程序文件。

下载安装

1. 到 Releases 页面 下载 WinShun-版本号-x64-setup.exe，双击安装。Windows 提示“已保护你的电脑”时，点 更多信息 → 仍要运行（还没有代码签名证书）。
2. 装完托盘里出现 Win顺 的图标，索引几秒就建好。连按两下 Ctrl 开始搜索。
3. 升级时运行新的安装程序，设置和索引都保留。卸载在 Windows 的“设置 → 应用”里。

系统要求：Windows 10 或 11，64 位。

为什么需要管理员权限

• 为什么要：读 NTFS 主文件表（MFT）和 USN 变更日志，才能几秒建好索引、实时跟上改动。开机自启用的是最高权限的计划任务，所以开机不弹 UAC。
• 打开的东西仍是普通权限：从 Win顺 打开的文件和应用都以普通权限运行，只有 Ctrl+Shift+Enter 才以管理员身份运行。

常见问题

和 Everything、Listary 有什么区别？ Win顺 自己建索引，不用装 Everything。文件名、拼音、应用和文件内容在一个框里搜，针对中文做了优化。对话框里有和 Listary 一样的 Ctrl+G 和搜索框，但不嵌进资源管理器窗口。

双击 Ctrl 和别的软件冲突？ Listary、PowerToys 的“查找鼠标”默认也用双击 Ctrl，关掉其中一边就行。也可以在 Win顺 里改用别的组合键。游戏全屏、藏起鼠标时，Win顺 默认不响应双击 Ctrl。

AutoHotkey 改的键在 Win顺 里不起作用？ Win顺 以管理员身份运行，Windows 不让普通权限的程序拦截发给它的按键。用 AutoHotkey 的 UI Access 模式，或以管理员身份运行脚本。

占多少内存？索引能不放 C 盘吗？

• 内存：每 100 万个文件约 30 MB，整个程序一般 120～140 MB。
• 索引位置：在设置 → 高级 → 索引位置里，可以移到其他内置硬盘。

收费吗？会上传数据吗？ 完全免费，MIT 开源。只在两种时候联网：到 GitHub 检查新版本（可以关掉），第一次显示某个网页搜索时取一次那个网站的图标。索引和历史只存在本机（%LOCALAPPDATA%\WinShun）。

反馈

遇到问题或有建议，欢迎在 Issues 里提出。

从源码编译

需要 Visual Studio 2022（“使用 C++ 的桌面开发”）、Qt 6.8 或更新版本（推荐 6.12，MSVC 2022 64 位套件）、CMake 3.25+ 和 Ninja。

./scripts/build.ps1                                # 编译 + 运行单元测试
./scripts/build.ps1 -QtDir C:\Qt\6.12.0\msvc2022_64 # 指定 Qt（默认用 QTDIR 或 C:\Qt 下最新的版本）
./scripts/build.ps1 -Deploy                        # 生成可分发的文件夹 dist\WinShun
./scripts/release.ps1                              # 打包安装程序和 SHA256SUMS.txt（需要 Inno Setup 6.5+）；加 -Publish 发布到 GitHub

也可以用 Qt Creator 或 VS Code（CMake Tools）打开，预设见 CMakePresets.json。源码结构和设计见 docs/architecture.md，踩过的坑见 docs/pitfalls.md。

English

WinShun (Win顺, "Windows made smooth") is a free, open-source search launcher for Windows. Press Ctrl twice and a search bar pops up, with results as you type:

• find files and folders by name or by pinyin;
• search the text inside Word, Excel and PDF files;
• launch apps and open Windows settings.

It also brings a clipboard history, a search bar for file dialogs, a taskbar search box, plugins and an MCP server for AI assistants.

It reads the NTFS master file table (MFT) directly, indexing three million files in a few seconds and following every change live: no Everything install needed. It needs no account and uploads nothing. The interface comes in English and Simplified Chinese. Screenshots: above.

Features

• 🔍 File search
  • Speed: press Ctrl twice; a search over three million files takes milliseconds.
  • Pinyin: ndbg finds 年度报告.
  • Where: all local drives, USB drives if you like, and