内置插件
Motrix 自带两个官方插件，装好就已经启用。它们负责给下载好的文件改名，以及为其他插件提供通用的媒体链接解析能力。每个插件都可以在左侧边栏的 「插件」 页里调整设置或关掉。
内置插件可以关闭，但不能卸载——它们没有 「卸载」 按钮。
快速了解
| 插件 | 作用 | 你可以改什么 |
|---|---|---|
| Motrix 文件名模板 | 下载完成时按你写的模板给文件改名 | 模板本身 |
| Motrix URL 解析器 | 供其他插件复用的底层能力，用来把媒体页面链接换成文件链接 | 首选清晰度 |
打开 「插件」，点进某个插件，会看到四处地方：「概览」、「设置」、「权限」，以及右侧那个小卷轴图标背后的 「日志」。在 「设置」 里改的内容，点 「应用」 才会保存；点 「重置」 可以恢复默认值。
Note
从 beta.41 起，Motrix 不再内置页面抓取插件，避免响应缓慢的下载页面阻止任务创建。遇到需要特殊处理的网页，请使用文件直链或兼容的站点解析插件。
Motrix 文件名模板
下载回来的文件常常叫 dl_38fa20b.zip 或者 download.php。这个插件会在下载完成的那一刻，按你写好的模板给文件改名。改名发生在文件放入下载目录之前，所以那串乱名字你根本不会看到。
模板只负责文件名主体，扩展名会自动帮你接回去——这也是默认模板 {{title}} 的效果等于「保持原样」的原因。
占位符
{{ }} 里的内容会被替换成这个下载任务的实际值。
| 占位符 | 替换为 |
|---|---|
{{title}} | 不含扩展名的原文件名 |
{{original}} | 包含扩展名的完整原文件名 |
{{ext}} | 不含开头点号的原扩展名 |
{{date}} | 任务创建日期，格式为 YYYY-MM-DD |
{{time}} | 任务创建时间，格式为 HH-mm-ss |
{{id}} | 下载任务 ID |
{{host}} | 文件来源的主机名，例如 www.example.com |
{{domain}} | 去掉开头 www. 的同一个主机名 |
{{urlPath}} | 解码后的来源链接路径 |
{{createdBy}} | 任务的创建方式：user、protocol 或 api |
{{meta.key}} | 其他插件写入任务的元数据值，支持 {{meta.show.season}} 这样的嵌套键 |
自定义日期和时间
{{date}} 和 {{time}} 支持在冒号后写格式，例如 {{date:YYYYMMDD}}、{{time:HH-mm}}，也可以混搭成 {{date:YYYY/MM}}。可用的格式标记有：
| 标记 | 含义 |
|---|---|
YYYY | 四位年份 |
MM | 两位月份 |
DD | 两位日期 |
HH | 两位小时，24 小时制 |
mm | 两位分钟 |
ss | 两位秒 |
过滤器
在占位符后面加 |，就能对取到的值做进一步处理。过滤器可以从左到右串联使用。
| 过滤器 | 作用 |
|---|---|
trim | 删除首尾空白 |
lower | 全部转为小写 |
upper | 全部转为大写 |
slug | 生成小写、连字符分隔的名称 |
truncate:N | 最多保留 N 个字符 |
replace:"旧值":"新值" | 把所有匹配到的文本替换掉 |
default:"默认值" | 占位符取到的是空值时，用默认值填上 |
pad:N | 在左侧补零，直到长度为 N |
示例
以下每一行都以 2026 年 8 月 18 日从 www.example.com 下载的 Vacation Photos.zip 为例：
| 模板 | 保存为 |
|---|---|
{{date}} {{title}} | 2026-08-18 Vacation Photos.zip |
{{date:YYYYMMDD}}-{{domain}}-{{title|slug}} | 20260818-example.com-vacation-photos.zip |
{{meta.artist|default:"Unknown"|slug}}-{{title|slug}} | unknown-vacation-photos.zip |
最后一行是使用其他插件元数据的安全写法：元数据可能存在也可能不存在，default 会把空缺填上，而不是留下一个孤零零的连字符。
设置项
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 「文件名模板」 | {{title}} | 文件名主体的模板，原扩展名会自动保留 |
一些细节
- 对 HTTP、FTP 和 BitTorrent 下载都生效。
- 复合扩展名会完整保留：
.tar.gz、.tar.bz2、.tar.xz、.tar.zst、.tar.lz、.tar.lzma、.user.js、.min.js、.min.css、.d.ts、.d.mts和.d.cts。 - 文件系统不接受的字符——
/ \ < > : " | ? *、控制字符，以及不可见的文字方向控制字符——都会替换成_。CON、COM1这类 Windows 保留名会在前面加一个下划线，末尾的空格和点号会被去掉。整个文件名最长 240 个 UTF-8 字节，而且被截断的永远不会是扩展名。 - 正因为
/属于上述字符，{{urlPath}}里的斜杠最终都会变成下划线。 - 模板写错时——用了不存在的占位符或过滤器、
{{没有闭合、过滤器少了参数——插件不会改名，而是保留原文件名，并把原因写进 「日志」。改名没生效时，先去那里看一眼。 - 模板最长 512 个字符。
Motrix URL 解析器
这个插件更像是底层能力，而不是一个你会直接用到的功能。它为各网站的解析插件提供一套通用机制，把媒体页面链接换成 Motrix 真正该下载的文件链接，并提供一个所有解析插件都能读取的清晰度偏好。
开箱状态下它只认识一个网站：Wikimedia Commons。粘贴 https://commons.wikimedia.org/wiki/File:… 这样的链接，Motrix 会向 Commons 查询原始文件的地址，然后下载文件本身，而不是保存网页。这个解析器的作用是演示整套机制确实能跑通。
Important
其他网站的支持来自你自行安装的 site-resolver 插件。Motrix 不内置任何视频网站的解析器，启用这个插件也不会带来这类能力。当已安装的解析器都不认识某条链接时，Motrix 会完全按你输入的地址下载。
设置项
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 「首选清晰度」 | 720p | site-resolver 插件优先请求的清晰度：1080p、720p 或 480p |
这只是一个转达给 site-resolver 插件的偏好，不是保证。内置的 Wikimedia Commons 解析器始终取原始文件，所以在你安装会读取这个偏好的解析器之前，这项设置不起作用。
内置插件如何更新
内置插件各自带版本号，不必等 Motrix 发新版就能更新。每次更新都是一个由 Motrix 团队签名的插件包，Motrix 会先验证签名再安装。
在桌面版里打开某个插件，看它标签栏右侧的按钮：
- 那个环形箭头按钮是 「检查更新」。
- 有更新等着时，这个按钮会变成 「更新到 v…」，同时列表里该插件的卡片上会出现 「可更新」 标记。
点下去，Motrix 就开始安装。如果新版本申请了旧版本没有的权限，会弹出 「更新内置插件」 对话框，在 「此更新请求了新的访问权限：」 下逐条列出变化，等你选择 「安装」 还是 「取消」——更新永远不会在你不知情的情况下扩大插件的权限范围。安装完成后，你可能会看到 「更新已安装，重启 Motrix 后完全生效。」
改主意了？当某个插件正运行着它自己拉取的更新时，旁边会出现一个撤销按钮：「还原为内置版本」 会把 Motrix 安装包里自带的那一份换回来。
Note
这些更新控件属于桌面版。Docker 和服务器版的内置插件来自镜像，要更新它们就得更新镜像。