PowerToys Run插件开发资源总览:awesome-powertoys-run-plugins的模板、NuGet包与ptr工具全解

原创2026-11-14 12:38:381,364 阅读

PowerToys Run插件开发资源总览:awesome-powertoys-run-plugins的模板、NuGet包与ptr工具全解

awesome-powertoys-run-plugins 是 PowerToys Run 社区插件的开箱即用资源中心,一站式提供插件清单、dotnet new 模板、NuGet 依赖包与 ptr 命令行工具。无论你是想安装社区插件扩展启动器,还是准备动手开发自己的 PowerToys Run 插件,这份指南都能帮你快速上路。

PowerToys Run 插件启动器深色主题界面

🗂️ 项目概览:社区插件的"精选目录"

PowerToys Run 是 Windows 上的开源快速启动器,支持通过插件扩展功能。awesome-powertoys-run-plugins 则扮演了"精选目录"的角色,收录了大量经过审核的社区插件与配套开发资源,并在主文件 readme.md 中按分类组织。

整个仓库结构非常轻量,核心文件包括:

文件 作用
readme.md 插件清单与资源总览(入口文档)
checklist.md 社区插件开发规范清单
contributing.md 向清单提交插件的贡献指南
security.md 安全策略与漏洞报告说明
pull_request_template.md 拉取请求(PR)模板
code-of-conduct.md 贡献者行为准则

🔌 社区插件清单:即装即用的能力扩展

清单中收录了 30 多个社区插件,覆盖文件搜索、包管理、文本处理等高频场景。挑几个有代表性的:

  • Everything — 用 Everything 引擎秒搜文件与文件夹
  • WinGet / Scoop — 在启动器里直接安装和管理 Windows 软件包
  • ClipboardManager — 搜索剪贴板历史并一键粘贴
  • ProcessKiller — 快速查找并结束 Windows 进程
  • TOTP — 复制基于时间的两步验证(2FA)动态码
  • CurrencyConverter — 按最新汇率转换传统货币与加密货币
  • LocalLLM — 通过 Ollama 查询本地大语言模型
  • WebSearchShortcut — 用预定义的搜索引擎快捷指令搜索网页

PowerToys Run 社区插件搜索效果浅色主题界面

这些插件的详细列表(含各自仓库链接与一句话简介)都维护在 readme.md 的 Plugins 小节中,可直接按需查找。

🧩 插件开发核心资源:模板、NuGet 包与 Lint

想从零写一个 PowerToys Run 插件?仓库的 Resources 小节(见 readme.md)准备了完整的"脚手架":

dotnet new 模板与 Visual Studio 模板

  • Community.PowerToys.Run.Plugin.Templates — dotnet new 命令行模板,一条命令生成插件工程骨架
  • Visual Studio Template — 面向 Visual Studio 的图形化项目模板

两种方式对应"命令行党"与"IDE 党"的习惯,选哪种都能快速拿到包含 plugin.json 的标准工程结构。

四个配套 NuGet 包

  • Dependencies — 社区插件的公共依赖打包
  • Abstractions — 社区插件抽象层,避免强耦合官方实现
  • Update — 为插件提供自动更新支持
  • Lint(ptrun-lint) — 插件静态检查工具,发布前用它扫一遍可避免常见打包错误

💡 提示:发布前运行 ptrun-lint 并通过检查,是插件被收入清单的硬性要求之一。

⌨️ ptr 命令行工具:插件安装管理一条龙

ptr 是专为社区插件打造的 CLI 工具,用于安装和管理 PowerToys Run 插件,省去手动下载 zip、解压、放置到插件目录的繁琐步骤。在 readme.md 的 Resources 小节可以查到它的官方仓库入口。

另外,清单中还推荐了一个名为 Community.PowerToys.Run.Plugin.Install 的"插件"——它让你直接在 PowerToys Run 搜索框里输入安装指令,从本清单中一键安装社区插件,体验相当顺滑。

✅ 开发规范清单:发布插件前逐项核对

如果你认真准备开发插件,务必通读 checklist.md,它规定了打包与命名的硬性要求:

  • zip 命名:<name>-<version>-<platform>.zip,如 InputTyper-0.2.0-x64.zip
  • 目录命名:PascalCase,与 plugin.json 中的 Name 及程序集后缀一致
  • 触发关键字(Action Keyword):必须唯一,且避开官方已占用的 =、# 等符号
  • plugin.json 的 Website 字段:必须指向插件源码仓库地址
  • 发布方式:将 zip 作为 Asset 挂到 GitHub Release

清单还特别列出了 zip 中不应包含的冗余 DLL(如 PowerToys.Common.UI.dll、Wox.Plugin.dll),这些文件随 PowerToys 本体提供,打包进去反而引发冲突。

📝 贡献指南:把你的插件提交进清单

当你完成了插件开发并通过了检查清单,就可以按 contributing.md 的流程提交 PR 了。几个关键规则:

  1. 插件需"养"满 30 天——从首个实质提交或开源之日算起,给项目一点成熟时间
  2. 查重:提交前搜索清单,避免与已有插件功能重复;若确属同类,需说明你的插件为何更好
  3. PR 格式:插件名 - 一句话简介。,简介要求客观、简洁,首字母大写、句末加句号
  4. 每个建议单独开一个 PR,并参考 pull_request_template.md 中的确认清单逐项勾选

PR 标题需使用 Add 插件名 格式(如 Add GEmojiSharp),这是评审通过的细节加分项。

🔒 安全提示:安装社区插件前必读

安装任何社区插件前,请先阅读 security.md 中的安全策略。仓库方说明:清单中的插件链接均"按现状"(as is)提供,不作任何担保;入选插件在合并前会经过人工审核、测试,并用 VirusTotal 扫描。建议你在本地也保持基本的来源核验习惯,只从可信仓库下载插件。

🎯 小结

你的目标 看这里
找好用的社区插件 readme.md 的 Plugins 小节
从零开始开发插件 dotnet new 模板 + Dependencies/Abstractions NuGet 包
发布前自检 checklist.md + ptrun-lint
提交插件进清单 contributing.md + PR 模板

从模板起步、用 NuGet 包补齐依赖、靠 ptr 与 Lint 工具兜底,再到按清单规范发布——跟着这套流程走,你的第一个 PowerToys Run 社区插件就会顺利诞生。

登录后查看全文
awesome-powertoys-run-plugins