使用插件

插件扩展了 Motrix 处理下载的能力:自动重命名文件、把下载页解析成真实的文件链接、在下载完成时做点什么,等等。每个插件都运行在隔离沙箱里,只能做你在安装时允许的事——侧栏的 「插件」 页就是这一切的家。

Motrix 出厂自带三个插件——见内置插件

从插件市场安装

插件页的 「可安装的插件」 一节列出官方插件注册表。每个条目显示作者、版本、“它能做什么”的简介、「权限」 预览和兼容性徽标;优秀的插件带 「精选」 徽标。点进详情,再点 「安装」

Note

注册表里展示的权限只是预览。你最终确认的授权提示,始终以插件包内的 manifest 为准。

从其他渠道安装

插件也以 .moext 文件的形式分发。点 「添加插件」,以下三种都行:

  • GitHub 地址——owner/repo[@tag],从该仓库的 release 安装。
  • URL——指向 .moext 包的直链。
  • 本地文件——选择 .moext 文件,或直接拖进对话框。

输入框会自动识别你贴的是哪种。安装刻意分两步:先 「检查该插件」,看清它要什么,再 「同意并安装」

授权界面——务必读一读

安装任何东西之前,Motrix 都会把插件想要的权限摆在明处:

  • 「所需权限」「可选权限」,全是大白话——“读取网站""使用 FFmpeg""管理你的下载”之类。
  • 「主机访问范围」——插件能访问哪些网站。这是运行时强制的边界:超出列表的请求会被直接拦截。申请访问任意 URL 的插件会得到红色的 「广泛主机访问」 警告,值得多一分怀疑。
  • 是否 「调用其他插件的命令」,以及确切的安装 来源

Caution

注册表之外的插件会标记 「未经验证」。只有信任作者、并预期它会使用列出的权限时才继续。如果插件必须 FFmpeg 而本机没有,Motrix 会阻止安装,并指引你去 设置 → 集成 → 媒体工具

升级时的提示更轻量:「相对上次授权的变化」 只显示新增的部分——新增权限、新增主机访问、新增公开命令——你审阅的是增量,不用把整张清单再看一遍。

管理已安装的插件

每个已安装插件是一张卡片,带状态和一句大白话的安全说明(比如”它仅保存自身设置,不访问任何网站”)。点进详情页:

  • 「概览」——状态、健康度与近期问题。
  • 「设置」——插件自己的选项,由它的 manifest 自动生成。
  • 「权限」——插件已获得的权限;可选权限的授予和查看都在这里。
  • 「日志」——藏在标签栏右侧的小图标后面:实时输出,带级别筛选、「复制」「清空」「详细模式」 会在 1 小时内捕获完整 URL 与 header——调试利器,谨慎使用。

启用开关可以在不卸载的情况下关掉插件;卸载 则会连插件数据一起删除。

更新

插件页的 「检查更新」 会扫描注册表。有新版的插件显示 「可更新」,一键更新;个别更新需要重启后完全生效。内置插件的更新走独立的授权对话框,而且永远可以用 「还原为内置版本」 回滚。

顺手一提

motrix://plugins/<id> 链接——比如来自某个插件的官网——会在 Motrix 里打开该插件的市场详情页。它只做跳转,绝不会擅自安装任何东西。

想自己写一个?从插件开发开始。