Keypirinha：为 Windows 键盘高手打造的极速启动器 #

Keypirinha 是什么？ #

Keypirinha 是一款面向 Windows 键盘流用户（官网称之为 “keyboard ninjas”）的高速启动器，当前版本为 v2.26。它可以用键盘快速搜索并启动应用程序、文件、书签、URL、PuTTY / WinSCP / FileZilla 会话、注册表项等各类项目，也能直接发起网页搜索、即时翻译、数学表达式求值、进制转换、字符串哈希、随机 UUID/密码生成等操作。

官方并不把 Keypirinha 定义为一个单纯的“应用启动器”，而将其描述为“一个被小型搜索引擎加持的条目数据库（a database of items sweetened with a small search engine）”——只要是插件能提供的任务，它都能启动。它采用插件化架构（C++ 内核 + Python3 插件）、文件驱动配置，主打轻量、省电与可扩展，官方定位为 Launchy 的替代品、Alfred 的“表亲”，适合愿意花一点学习成本换取长期效率提升的进阶用户。

Keypirinha 有哪些亮点特色？ #

• 键盘优先，极速响应：整个交互围绕键盘设计，唤出 LaunchBox 后直接输入关键词即可定位目标，官方称其为“a fast launcher for keyboard ninjas on Windows”，搜索算法会根据当前检索词与上下文，为更可能被使用的任务打出更高分数。
• 插件化架构，可脚本化扩展：核心用 C++ 编写以保障速度，官方插件采用 Python3，并提供公开的 Python API；官方插件与 API 均以 zLib 许可证开源，开发者可以自行编写 Package/Plugin 扩展功能。
• 内置丰富的官方功能包（Shipped Packages）：随软件附带 Apps、Bookmarks、Calc、ControlPanel、Env、Everything、FileBrowser、FilesCatalog、FileZilla、GoogleTranslate、PuTTY、RegBrowser、String、TaskSwitcher、URL、WebSearch、WebSuggest、Winamp、WinSCP 等二十余个 Package，覆盖应用启动、文件浏览、会话连接、网页搜索、翻译、计算、环境变量检索等场景。
• 不止能“启动”，还能“计算”与“处理”：支持即时语言翻译、数学表达式求值、数字进制转换、环境变量搜索、直接打开剪贴板中的 http/mailto/skype 链接、拆分 URL 并把参数转成 JSON、按名称切换到正在运行的应用程序、字符串哈希（CRC32、MD5、SHA 等）、生成随机 UUID / 密码 / 字节序列。
• 轻量省电，几乎无感运行：官方强调其内存占用相当小（fairly small memory footprint），并且在默认配置下，初始化完成后处于空闲状态时消耗的 CPU 周期为零，因此对笔记本电池十分友好。
• 绿色便携 + 双运行模式：官网提供的是可直接解压的压缩包，没有安装程序，开箱即运行于“便携模式（Portable Mode）”，配置与运行时文件都放在软件目录下，方便放进 U 盘随身携带；如果移除 portable 目录与 portable.ini 文件，则会自动切换到符合 Windows 规范的“已安装模式（Installed Mode）”。
• 文件驱动配置，机器级与用户级分离：所有配置采用 INI 格式的配置文件管理，并支持机器专属（machine-specific）与用户专属（user-specific）配置分别存放，便于在多台设备或多人共用的环境中同步与区分设置。
• 界面可深度定制，且完全免费无干扰：GUI 的颜色、字体、元素的显示/隐藏与位置均可自定义，官网还提供主题构建器（Theme Builder）与官方预设主题；软件本身为免费软件（Freeware），没有试用倒计时、没有弹窗催促、没有广告。

免费下载 Keypirinha #

以下为 Keypirinha v2.26 的官方便携版安装包（Portable），按需选择完整版或对应架构版本即可，解压后无需安装程序即可使用。

官网同时提示：Keypirinha 也已上架 Chocolatey，习惯命令行安装的用户可通过 Chocolatey 获取；官方下载页另提供各安装包的校验和（Checksums）以便核对文件完整性。

Keypirinha 如何使用？ #

Keypirinha 的核心使用逻辑非常简单：唤出 LaunchBox → 输入关键词 → 选中条目 → 回车执行。官网 “First steps” 章节给出的上手路径大致如下：

1. 启动程序：解压后运行 keypirinha.exe。程序启动后会驻留在后台，并在系统托盘中显示图标。
2. 唤出 LaunchBox：使用全局热键唤出 Keypirinha 的主搜索窗口 LaunchBox（默认热键可在配置文件或 GUI 设置中修改，具体键位以官网 “Keyboard Shortcuts” 章节为准）。输入框即出现光标，直接打字即可。
3. 第一次搜索：输入任意关键词，例如应用名、文件名或网址片段，LaunchBox 会实时列出匹配条目，用上下方向键选择后按回车执行。
4. 第二次搜索与结果筛选：继续输入更精确的词语，搜索引擎会依据当前上下文重新打分，把最可能需要的条目排到前面；也可以用空格分隔多个关键词进一步收窄结果。
5. 为条目关联关键词（Associate a Keyword）：给常用条目绑定一个简短关键词（例如把某个项目目录绑定为 proj），以后只需输入该关键词即可直达，无需再输入完整路径。
6. 传递参数、使用 Actions：执行条目时可以附加参数（Specify arguments）；选中条目后还可调出 Actions 面板，对同一条目执行“以管理员身份运行”“打开所在文件夹”等不同操作。
7. 最大化、退出搜索与拖放：LaunchBox 可最大化显示更多结果；按 Esc 离开当前搜索；还支持把文件拖放到 LaunchBox 上，交给相应的 Package 处理。
8. 进一步定制：通过“Configuration（配置）”“GUI Theming（主题）”“Plugins（插件）”章节调整行为与外观；在 “Customize your Catalog” 中收缩或扩展被索引的条目集合；需要新能力时，可以在 “Extending Keypirinha (API)” 中基于 Python API 自行开发 Package。

小提示：官网建议不要把 Keypirinha 放在桌面或开始菜单文件夹中，否则会失去“应用被安装/卸载时目录自动刷新”带来的好处。

Keypirinha 的常见问题？ #

Keypirinha 到底是什么？ 官方定义是：一款为 Windows 键盘高手打造的快速启动器。它本质上是一个条目数据库加上一个小型搜索引擎，可以启动由插件提供的任意任务——文档、URL、网页搜索、PuTTY 或 FileZilla 会话、切换正在运行的应用程序、即时计算数学表达式等等。

它只是一个“开始菜单替代品”吗？ 不是。官网明确提醒，把 Keypirinha 仅当作应用启动器是一种误解。它的架构刻意做得非常通用、可配置、可脚本化（Python3），只要能通过插件描述出来，就能被它启动和触发。

它是开源软件吗？ 简短回答：应用本体不是，官方插件与公开的 Python API 是。应用本体以免费软件（Freeware）形式分发，无时间限制、无弹窗催促、无广告；随软件附带的官方插件及其公开的 Python API 则采用宽松的 zLib 许可证开源。

它是 Beta 阶段的软件吗？ 不是。官方表示 Keypirinha 可被视为稳定版本，由一个规模不大但活跃的社区在长期使用，社区反馈问题积极，一旦出现严重问题通常能较快推出维护版本。

支持 Windows 之外的平台，或者中文界面吗？ 官网明确说明它运行于 Windows（7、8、8.1、10），不需要额外依赖；同时 FAQ 中表示近期没有支持更多语言的计划（“Sorry, there is no plan to support additional language in a near future”）。

为什么叫 Keypirinha 这个奇怪的名字？ 它是 Keyboard（键盘）与 Caipirinha（巴西鸡尾酒）两个词的组合，作者还很鼓励你尝一尝这款鸡尾酒。

Keypirinha 如何安装？ #

Keypirinha 目前没有安装程序，官网提供的就是一个可解压到任意位置的压缩包，解压后即可运行。

Windows（官网唯一支持的平台，适用于 Windows 7 / 8 / 8.1 / 10，无需额外依赖）

1. 从上方下载表格获取对应版本（不确定时选 full 完整版），并使用 7-Zip 等工具解压 .7z 压缩包，得到一个包含 keypirinha.exe 的目录。
2. 把该目录放到一个你希望长期保留的位置，例如 C:\Tools\Keypirinha。官网建议避免放在桌面或开始菜单文件夹下。
3. 双击 keypirinha.exe 启动。开箱即用状态下，它会以 便携模式（Portable Mode） 运行。
4. 为方便日常使用，可在快捷方式属性中设置“以管理员身份运行”，或把启动项加入开机自启（可由系统托盘菜单或配置完成）。

两种运行模式的差别与切换

• 便携模式（Portable Mode）：当 keypirinha.exe 所在目录中存在 portable 文件夹或 portable.ini 文件时启用。配置文件与下载的额外包存放在 portable\Profile，缓存与临时文件存放在 portable\Local。还可以通过 portable.ini 中的 portable_dir 参数把数据目录指定到别处（该目录必须已存在且可读写，路径支持相对路径与环境变量，文件需为 UTF-8 编码）。
• 已安装模式（Installed Mode）：当软件目录中不存在 portable 目录也不存在 portable.ini 时启用。配置文件与额外包存放于 %APPDATA%\Keypirinha，缓存与临时文件存放于 %LOCALAPPDATA%\Keypirinha。
• 官方说明：目前没有自动化的模式切换方式，如需切换请手动复制目录，并务必先确保 Keypirinha 没有在运行。

其他安装渠道

Keypirinha 也已发布在 Chocolatey 上，习惯包管理器的用户可以直接通过 Chocolatey 命令安装（具体包名以 Chocolatey 官方页面为准）。

Keypirinha 如何卸载？ #

由于 Keypirinha 没有传统安装程序，卸载方式取决于你当前使用的运行模式：

便携模式（Portable Mode）

1. 先退出 Keypirinha（在系统托盘图标上右键选择退出）。
2. 直接删除整个 Keypirinha 程序目录即可。配置、缓存与额外下载的包都位于该目录下的 portable\Profile 与 portable\Local 中，会随目录一并清除。
3. 如果你在 portable.ini 中通过 portable_dir 把数据目录指向了别的位置，请额外手动删除该 portable_dir 目录，否则会残留配置文件与缓存。

已安装模式（Installed Mode）

1. 退出 Keypirinha。
2. 删除程序所在目录（因为没有安装程序，也就没有卸载向导）。
3. 手动清理用户数据目录，以免残留：
   • 配置与额外包：%APPDATA%\Keypirinha（例如 C:\Users\%USERNAME%\AppData\Roaming\Keypirinha）
   • 缓存与临时文件：%LOCALAPPDATA%\Keypirinha（例如 C:\Users\%USERNAME%\AppData\Local\Keypirinha）

通过 Chocolatey 安装的情况

1. 打开命令行执行 Chocolatey 的卸载命令（例如 choco uninstall <包名>，包名以 Chocolatey 官方页面为准）。
2. 卸载后按上面的路径检查并清理 %APPDATA%\Keypirinha 与 %LOCALAPPDATA%\Keypirinha 残留目录。

提示：删除任何目录前，建议先备份 Profile 目录中的配置文件，以便日后重新安装时快速恢复你的关键词绑定、主题与插件设置。