Win顺 · WinShun

双击 Ctrl，搜遍整台电脑 —— 免费开源的 Windows 文件搜索、快速启动器
Press Ctrl twice, search your whole PC — a free, open-source file search and launcher for Windows

中文 · English · 截图 Screenshots

拼音秒搜文件 · 文件内容全文搜索（Word / Excel / PPT / PDF） · 应用和系统设置 · 网页搜索 · 收藏夹 · 插件
“打开 / 另存为”对话框搜索 · 剪贴板历史（代替 Win+V，图片文字也能搜） · 任务栏搜索框（代替 Win+S） · AI 助手 MCP
_{Pinyin file search · full-text search in documents · apps and settings · web search · favorites · plugins · file dialog search · clipboard history with OCR · taskbar search box · MCP server for AI assistants}

---

截图 · Screenshots

---

中文

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

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

功能

🔍 文件搜索

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

搜索语法	含义
报告 2024	每个词都要有（空格分隔，顺序不限）；也可以在所在文件夹的名字里
ndbg、niandubaogao	拼音全拼、首字母，可以混用
"年度 报告"	引号内作为整体
!草稿、!node_modules\	排除文件名、排除文件夹
*.pdf、报告?.docx	通配符
ext:pdf,docx	只要这些扩展名
项目\readme	在名字含“项目”的文件夹下
tools/out/、D:\My Files\	路径直达：回车进去，列出里面的内容

📄 文件内容全文搜索

• 切到 内容 范围，搜文件里的文字，结果显示命中的那一行。
• 能搜的文件：
  • 纯文本：txt、md、log、csv、json、代码等；
  • 文档：Word、Excel、PowerPoint、PDF、WPS，结果里显示第几页、第几张幻灯片或哪个表的第几行。
• 怎么找：可以写多个词、用引号找整个短语，结果按相关度排。
• 只搜某个文件夹：词后面加文件夹名和斜杠，年度报告 abc/ 只在叫 abc 的文件夹里找（/abc 放在最后也行，工作/abc/ 只要“工作”里的那个）；同名的文件夹都搜，搜索框下面列出它们，Shift+Tab 挑其中一个。也可以点下面的收藏文件夹，或在结果的文件夹上右键“在此文件夹中搜内容”。
• 编码和速度：自动识别 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 翻译；
  • 按意思找（默认关）：? 去年报销的规定 也能找到写着“差旅费用申请”的文档。用你选的模型：本机的 Ollama、LM Studio 什么都不上传；硅基流动、百炼、OpenAI 等填自己的密钥，第一次计算前告诉你要发出去多少字，你按回车才开始。见 plugins/winshun.semantic；
  • 自己写插件：零代码的 plugin.json、任意语言的脚本或常驻进程都行，附 Python / PowerShell / C++ SDK；
  • 插件以普通权限、限内存运行。见 docs/plugins.md。

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

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

🗂️ 资源管理器里：双击空白处、右键搜索此处

• 双击空白处：在资源管理器或桌面的空白处双击，弹出收藏的、最近的、别的窗口里开着的文件夹，选一个就在这个窗口里转过去（桌面上开新窗口），和 Listary 一样；还能在当前文件夹里搜、把它加进收藏。
• 菜单不抢焦点，方向键、回车、Esc、首字母都能用；点别处或再双击就关。Listary 在运行时让给它。
• 右键“用 Win顺 搜索此处”：文件夹、文件夹的空白处和磁盘的右键菜单里都有（Windows 11 在“显示更多选项”里），搜索框带着这个文件夹打开，接着打字就在里面找。设置里可以关。

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

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

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

• 在 Windows 11 任务栏上放 Win顺 自己的搜索框（Windows 10 是固定一个按钮），结果从任务栏上方滑出。
• 可以像 Windows 自带的搜索框一样放在开始按钮右边，图标往右让出位置（设置里打开，默认关）。
• 可以接管 Win+S，开始菜单里打字也用 Win顺 搜。

🤖 AI 助手（MCP）

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

🎨 外观和设置

• 外观：浅色、深色跟随系统，Windows 11 云母（Mica）效果和圆角；图标在 150% 缩放下也清晰。界面大小有紧凑、标准、宽松三档，托盘和任务栏的图标可以换成单色。
• 设置：可以搜索（Ctrl+F，kjj 找到“快捷键”），改了立即生效。
• 备份：设置 → 高级里选一个文件夹（放在同步盘里就是云备份），设置、收藏、对话框的固定项、自己加的网页图标和插件会自动备份，保留最近 10 份，随时恢复。
• 更新：有新版本时在托盘提醒，Win顺 不会自己下载、替换程序文件。

按键	作用
双击 Ctrl	打开 / 关闭搜索框（可另设组合键，如 Alt+Space）
Enter / Ctrl+Enter / Ctrl+Shift+Enter	打开 / 打开所在文件夹 / 以管理员身份运行
Ctrl+C / Ctrl+Shift+C	复制文件 / 复制路径
Ctrl+1～Ctrl+9	打开第几行（图标上的数字）
Tab	切换范围：全部 / 文件 / 内容
Shift+Tab	在 文件 里切换类型，在 内容 里切换文件夹
Ctrl+S	最匹配 → 最新在前 → 最早在前
Ctrl+G（对话框里）	转到文件管理器正在显示的文件夹
Win+V / Win+S（设置里打开后）	剪贴板历史 / 任务栏上方的搜索框

下载安装

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

不想安装的话，下载 WinShun-版本号-x64-portable.zip，解压到任意文件夹，运行里面的 WinShun.exe 就行。设置、记录、剪贴板历史和索引都存在它旁边的 data 文件夹里，整个文件夹可以拷到 U 盘或别的电脑；第一次启动时，这台电脑上原来的设置和数据（%APPDATA%\WinShun、%LOCALAPPDATA%\WinShun）会复制过来，原处的不动。升级时把新版解压到同一个位置覆盖，data 留着。删掉 data 文件夹（先退出 Win顺），就和安装版一样存在原来的地方。

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

管理员权限

• 平时不用：Win顺 以普通权限运行。安装版带一个很小的“Win顺 索引服务”，由它读 NTFS 主文件表（MFT）和 USN 变更日志，所以照样几秒建好索引、实时跟上改动。安装时要管理员同意一次，之后登录和打开都不弹 UAC。
• 能看到哪些文件：和 Everything 一样，索引里有整块盘的文件名，包括这台电脑上其他用户的；没有权限的文件照样打不开。
• 便携版：默认一个个文件夹走一遍来建索引，第一次慢一些，之后实时跟上改动。在设置 → 索引方式里可以装上索引服务，或以管理员身份重新启动。
• 管理员直读：管理员账户可以在设置 → 索引方式里选“管理员直读”，像旧版一样整个程序以管理员身份运行、直接读盘。
• 以管理员身份运行的程序：Windows 不让普通权限的程序往它们里面打字。往这样的窗口里粘贴时，Win顺 只复制，提示你按 Ctrl+V；对话框旁的搜索框也不出现在这些程序上。
• 打开的东西是普通权限：从 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；不用它一分钟后，任务管理器里降到十几 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 年度报告; a mistyped homophone (年度报高) is retried by sound.
  • Where: all local drives, USB drives if you like (an unindexed one that is plugged in is offered at the end of the list), and NAS / SMB network shares, still searchable while their server is off.
  • Order: your own files first, the date modified on each row, Ctrl+S for best match / newest / oldest. Recent files are listed when the box is empty.
  • Shortcuts: Ctrl+1…Ctrl+9 opens a row (its number is on its icon).
  • By kind: under Files, a row of kinds (folders, documents, pictures, videos, archives…); Shift+Tab steps through them, + adds your own.
  • Drag out: drag results into a chat, a mail or Explorer.
  • Query syntax: "exact phrase", !exclude, !node_modules\, wildcards * ?, ext:pdf,docx, folder\name, and paths (D:\My Files\, tools/out/).
• 📄 Full-text search
  • What: the Content scope searches inside txt, md, logs, source code and Word, Excel, PowerPoint, PDF and WPS files, showing the page, slide or sheet and row.
  • In one folder: add a folder's name and a slash, annual report abc/, to search only in folders named abc (/abc last works too; work/abc/ takes the one in work); folders of the same name are all searched and listed under the box, Shift+Tab picks one. Or pick a favorite folder there, or right-click a folder in the results → Search contents in this folder.
  • How: ranked by relevance, with a content index for speed; UTF-8, UTF-16 and GBK are detected. Files over the size limit, in system folders or of unlisted text types are skipped; the list says how many of each, and one click searches them too.
  • Safety: documents are read by a separate process with restricted rights.
• 🚀 Apps and settings
  • Apps: everything in the Start menu (Store apps included), by name, pinyin, initials (vsc) or program file (winword).
  • Settings: about 1,200 Windows settings pages and Control Panel items (ncpa.cpl, “network adapter”), plus Group Policy, Disk Management, hosts, AppData and more.
• 🌐 Web search: zhihu 显卡, baidu 天气: a keyword and a space search that site. Ten Chinese sites are built in; add your own with %s in the URL.
• ⭐ Favorites: right-click → Add to favorites. They come first when the box is empty; give one a keyword to open it, and Tab searches inside a favorite folder.
• 🧩 Plugins
  • Bundled: = 1+2*3, 12 inch to cm, #ff8800, timestamps, UUID, Base64, hashes; kill processes, bm browser bookmarks, tr translation.
  • Search by meaning (off by default): ? last year's expense rules finds a document that says “travel cost requests”. It uses the model you pick: Ollama or LM Studio on your PC uploads nothing; for SiliconFlow, Model Studio, OpenAI and others you enter your own key, and before the first run it says how much text would be sent and waits for your Enter. See plugins/winshun.semantic.
  • Your own: zero-code plugin.json, scripts in any language, or resident processes, with SDKs for Python, PowerShell and C++. Plugins run with normal rights under a memory limit. See docs/plugins.en.md.
• 📂 Open / Save dialogs
  • Search bar: a search bar under every file dialog; type a name (pinyin too), press Enter, and the dialog goes there.
  • Ctrl+G: jumps to the folder open in File Explorer, Total Commander or Directory Opus, like Listary.
  • Suggestions: open folders, a path you just copied, favorites and recent folders.
  • Going there by itself: optional, as the dialog opens, or only when you come back to it from the file manager.
• 🗂️ In File Explorer: a double click, a right-click
  • Folder menu: double-click the blank space of a File Explorer folder or of the desktop: favorite, recent and open folders; pick one and the same window goes there (the desktop opens a new one), like Listary. Also: search this folder, add it to the favorites.
  • It never takes the focus: arrows, Enter, Esc and first letters work; a click elsewhere or another double click closes it. It stays out of the way while Listary runs.
  • “Search here with WinShun” on the right-click menu of folders, a folder's blank space and drives (under “Show more options” on Windows 11): the search window opens with that folder typed. It can be turned off.
• 📋 Clipboard history (replaces Win+V)
  • What: text, pictures and files, opened with Win+V or your own shortcut, by the text cursor, without taking the focus.
  • Search: pinyin, @app filters, and words in copied pictures (PaddleOCR text recognition, on your PC and offline, good with numbers and small print in screenshots).
  • Preview: full text, pictures, HEX / RGB / HSL color values.
  • Drag pictures out: hold a picture and drop it on a folder to save it as a PNG file.
  • Organize: pins, groups, multi-paste in order, and Alt+1…Alt+9; pinned items can come first, and the order is yours to drag or move with Ctrl+↑/↓.
  • Privacy: passwords from password managers are not kept, and the history stays on your PC.
• 🔎 Taskbar search box (replaces Windows search): WinShun's own search box on the Windows 11 taskbar (a pinned button on Windows 10), optionally right of Start where Windows' own box sits; it can take over Win+S and typing in the Start menu.
• 🤖 AI assistants (MCP)
  • What: WinShun is an MCP server. Claude Desktop, Claude Code, Cursor and VS Code connect in one click and search file names, file contents and recent changes.
  • Safety: read-only by default, limited to what the AI client may see, with folders kept from AI and a call log.
• 🎨 Looks and settings
  • Looks: light and dark themes following Windows, Windows 11 Mica and rounded corners, sharp icons at any scaling; compact, standard or roomy sizes, and a monochrome tray and taskbar icon if you like.
  • Settings: searchable (Ctrl+F).
  • Backup: choose a folder under Settings → Advanced (a synced folder makes it a cloud backup); settings, favorites, dialog pins, your own web icons and plugins are backed up as they change, the last 10 kept, ready to restore.
  • Updates: announced in the tray; WinShun never replaces its own files.

Key	Action
Ctrl twice	Open / close the search bar (another shortcut, such as Alt+Space, can be set)
Enter / Ctrl+Enter / Ctrl+Shift+Enter	Open / show in folder / run as administrator
Ctrl+C / Ctrl+Shift+C	Copy the file / copy its path
Ctrl+1…Ctrl+9	Open the nth row (the number on its icon)
Tab	Switch scope: All / Files / Content
Shift+Tab	In Files, step through the kinds; in Content, through the folders
Ctrl+S	Best match → newest first → oldest first
Ctrl+G (in a file dialog)	Go to the folder shown in your file manager
Win+V / Win+S (once turned on)	Clipboard history / search above the taskbar

Download and install

1. Download WinShun-<version>-x64-setup.exe from the Releases page and run it. If Windows says “Windows protected your PC”, click More info → Run anyway: the app is not code-signed yet.
2. When the WinShun icon appears in the notification area, it is running; the first index takes a few seconds. Press Ctrl twice and type.
3. To upgrade, run a newer installer: your settings and index are kept. Uninstall from Windows Settings → Apps.

To skip the installer, download WinShun-<version>-x64-portable.zip, unzip it anywhere and run WinShun.exe in it. Settings, history, clipboard and index are kept in the data folder beside it, so the whole folder can go on a USB stick or another PC; on the first start, what this PC already has (%APPDATA%\WinShun, %LOCALAPPDATA%\WinShun) is copied in, the originals left in place. To upgrade, unzip the newer one over it and keep data. Without the data folder (quit WinShun first), it keeps them where the installed copy does.

Requires Windows 10 or 11, 64-bit.

Administrator rights

• Not needed day to day: WinShun runs with your normal rights. The installed version comes with a small “WinShun Index Service” that reads the NTFS master file table (MFT) and change journal (USN) for it, so millions of files are still indexed in seconds and changes followed live. An administrator approves the install once; after that there is no UAC prompt at login or when you open it.
• Which files you see: as with Everything, the index holds the file names of whole drives, other users' on this PC included; files you have no rights to still won't open.
• Portable version: by default it walks the folders one by one, so the first index is slower; changes are followed live after that. Settings → Index access can install the index service or restart it as administrator.
• Direct as administrator: on an administrator account, Settings → Index access → “Direct (administrator)” runs the whole app as administrator and reads the drives itself, as earlier versions did.
• Programs running as administrator: Windows doesn't let normal-rights programs type into them. Pasting into such a window only copies, and WinShun tells you to press Ctrl+V; the search bar beside file dialogs doesn't appear on them either.
• What you open is not elevated: files and apps you open from WinShun run with your normal rights; only Ctrl+Shift+Enter runs one as administrator.

FAQ

How is it different from Everything or Listary? WinShun builds its own index, so Everything is not needed. File names, pinyin, apps and file contents are searched from one box, tuned for Chinese. File dialogs get Listary's Ctrl+G and a search bar, but WinShun does not embed itself in Explorer windows.

Ctrl twice clashes with another program? Listary and PowerToys' Find My Mouse use it too: turn it off on one side, or give WinShun another shortcut. Full-screen games and games that hide the mouse are ignored by default.

AutoHotkey remaps don't work in WinShun? With “Direct (administrator)” chosen, WinShun runs as administrator, and Windows keeps normal-rights programs from intercepting keys sent to it. Pick another index access, or run the script with UI Access or as administrator.

Memory? Index location?

• Memory: about 30 MB of index per million files; the whole app is usually 120–140 MB while in use, and drops to about 15 MB in Task Manager a minute after you stop using it.
• Index location: the index can move to another built-in drive under Settings → Advanced.

Is it free? Does it collect data? Free and MIT-licensed. It goes online only to check GitHub for new versions (you can turn that off), to fetch a web shortcut's or bookmark's site icon once, and, if you turn on the “Search by meaning” plugin with a cloud service, to send document text to the service you chose. The index and history stay on your PC (%LOCALAPPDATA%\WinShun).

Feedback

Bug reports and suggestions are welcome in Issues.

Build from source

Needs Visual Studio 2022 (Desktop development with C++), Qt 6.8 or later (6.12 recommended, MSVC 2022 64-bit kit), CMake 3.25+ and Ninja.

./scripts/build.ps1                                # build and run the unit tests
./scripts/build.ps1 -QtDir C:\Qt\6.12.0\msvc2022_64 # pick a Qt kit (default: QTDIR or the newest under C:\Qt)
./scripts/build.ps1 -Deploy                        # make the distributable folder dist\WinShun
./scripts/release.ps1                              # package the installer and SHA256SUMS.txt (needs Inno Setup 6.5+); -Publish makes the GitHub release

Architecture, design notes and benchmarks (in Chinese) are in docs/architecture.md.

---

LINUX DO

本项目积极参与并认可 LINUX DO 社区。

WinShun is proud to be part of the LINUX DO community.

许可证 · License

Win顺 以 MIT 许可证 发布。Copyright © 2026 LingCore.

WinShun is released under the MIT License. Copyright © 2026 LingCore.

随附的第三方内容按各自的许可使用，不在 MIT 许可范围内 · Bundled third-party content keeps its own license:

• resources/fonts/ 阿里巴巴普惠体 3.0 · Alibaba PuHuiTi 3.0 — © Alibaba Group，按其免费商用授权随程序附带 · redistributed under its free commercial-use terms.
• 图片文字识别 · Text recognition — ONNX Runtime（MIT）和 · and PaddleOCR 的 PP-OCRv6 模型 · models（Apache-2.0），见 · see third_party/ppocr/LICENSE；安装后在 · installed in licenses\。
• 拼音读音数据 · Pinyin data — pinyin-data，MIT，见 · see tools/data/pinyin-data-LICENSE.txt。常用字的读音以其中的《通用规范汉字字典》（2013）数据为准。