wpm 插件管理器使用教程：命令行装插件的正确姿势

wpm 是什么，解决什么问题

wpm 是 Wox Package Manager 的简称，一个跑在 Wox 搜索框里的插件管理工具。它把「找插件、装插件、升级、卸载」这些动作全部收进命令行，不需要进设置界面一层层点。

它解决的是三个具体痛点：

• 装插件太慢。设置界面里要浏览列表、翻页、点详情、等安装，步骤多。
• 升级不直观。插件装多了之后，很难知道哪些有新版本。
• 换机器要重来一遍。手动一个个装，等于把之前的劳动重做一次。

用命令行之后，这三个问题都能压到一条指令以内。尤其是第三点，把装过的插件写成一份清单，换机器时按清单批量装，几分钟就能恢复环境。

基本用法：四条命令覆盖全部操作

wpm 的核心命令只有四条，记住这四条就够用了：

在 Wox 搜索框里输入 wpm 加一个空格，通常会自动提示可用子命令。这是最省事的记忆方式——不需要背，输到一半就有提示。

搜索与安装的实际流程

装插件前先搜一下，这一步很多人会跳过，结果是装了一堆功能重叠的东西。

搜索时用功能关键词而不是插件名。比如想找翻译功能，搜「翻译」比搜某个具体插件名更有效，因为插件名你可能记不准，但功能需求是明确的。

安装时注意观察返回信息。如果提示依赖缺失或版本不兼容，说明这个插件不适合你当前的 Wox 版本——这时候换一个同类插件比强行修依赖更划算。

批量恢复环境：最实用的一招

wpm 最有价值的用法，其实不是日常装插件，而是在新机器上重建环境。

做法是：在旧机器上用列表命令导出已安装的插件清单，保存成文本文件放进网盘；在新机器上装好 Wox 之后，按清单逐条安装。

这个过程看起来还是「一条条装」，但区别在于你不需要回忆「我原来装了哪些」——清单就是答案。对于装了十几个插件的人，这个差别很大。

更进一步，可以把清单写成一个批处理脚本，一次执行完。如果你经常重装系统或换机器，这个投入完全值得。

升级策略：什么时候升级，什么时候别动

插件更新不像系统更新那样必须及时。一个务实的策略是：

1. 正在用的插件，不主动升级。它现在能用，升级只会带来风险。
2. 装了但没用的插件，直接卸载，不要升级。
3. 需要新功能时才升级，并且升级前记下当前版本号，方便回滚。

这套策略的道理很简单：插件升级带来的收益通常小于它可能引入的问题。启动器是每天用的工具，稳定性比新功能重要得多。

装完不生效怎么排查

按这个顺序查，基本能定位：

1. 插件是否出现在已安装列表里？不在，说明安装过程失败了，重试或换网络环境
2. 是否需要重启？部分插件安装后需要重启 Wox 才加载
3. 触发关键词是什么？去插件的说明里确认前缀，很多「装了没用」其实是不知道该输什么
4. 有没有报错日志？看 %APPDATA%\Wox\Logs\ 下当天的日志

第 3 条是最常见的坑。插件装好了、也加载了，但用户不知道该输入什么前缀，于是以为没生效。

安全提醒

插件本质是可以在你机器上执行代码的程序。从官方渠道或知名社区仓库安装风险较低，但从不明来源下载的插件包需要谨慎，尤其是那些要求网络权限却只做本地计算的插件。

判断标准可以很朴素：这个插件需要的能力，和它声称的功能匹配吗。一个颜色转换插件要求联网上传数据，就值得警惕；需要管理员权限才能工作的插件，先想清楚它为什么需要。

在公司电脑上使用尤其要注意，很多环境对第三方代码执行有明确限制。装之前确认一下策略，比装完被拦下来省事。

wpm 之外的插件管理方式

命令行不是唯一选择，两种方式各有适用场景：

设置界面管理

适合刚开始用的人。可以在列表里浏览插件说明、看截图、确认版本要求，信息比命令行更完整。缺点是操作步骤多，不适合批量。

插件目录直接管理

直接操作 %APPDATA%\Wox\Plugins\ 目录，适合调试和批量迁移。把整个目录打包带走，换机器时解压即用，比逐个安装快得多。

注意这种方式绕过了安装流程，某些插件可能有额外的注册或依赖步骤，直接拷贝不一定能正常工作。拷完之后要逐个验证。