文件命名模式
使用占位符和示例选择下载名称,在 Android 和桌面端生成安全的文件名。
在桌面端,打开 设置 → 文件命名模式(也可以通过 下载 中的链接打开)。在 Android 上,打开 设置 → 下载 → 文件命名模式。您也可以在首次运行时设置命名模式。[title] 是可选的:您可以改用日期、批次内的序号或自定义固定文本。
实时预览使用示例数据;实际文件名使用每次下载的元数据。
构建命名模式
点击带有标签的占位符按钮,会在光标位置插入带方括号的代码;没有光标时则追加到末尾。标签跟随应用语言,但 [title] 等代码保持不变。
占位符按钮分为 基本、日期和时间、媒体 和 批量 四组。标签会被翻译,但方括号中的代码在所有语言中保持一致。
一键预设使用 [title]、[title] - [quality]、[date] - [title] 和 [channel] - [title],另外还有 日期 - 时间 ([date] - [time]) 和 频道 - 日期 ([channel] - [date])。实时预览会随编辑更新。
诸如 [titel] 之类的未知标记会在字段旁边显示未知占位符并阻止保存。允许省略 [title]。现有支持的括号语法保持兼容。
仅包含固定文本或 [site] 的模式显示温和的提示:每个文件都会获得相同的名称;数字将被添加。 这不是错误,也不会阻止保存。
占位符
| 占位符 | 值 | 示例 |
|---|---|---|
[title] | 媒体标题(可选) | My video |
[quality] | 所选质量标签 | 1080p |
[ext] | 最终文件扩展名,不含点号 | mp4 |
[date] | 下载的本地日期,YYYY-MM-DD | 2026-10-10 |
[time] | 下载的本地时间,HH-mm-ss | 09-08-07 |
[year] | 来自与 [date] 和 [time] 相同的本地命名时间戳的四位数年份 | 2026 |
[month], [day], [hour], [minute] | 该时间戳记中两位数的月、日、小时或分钟 | 10, 10, 09, 08 |
[site] | 来源页面的主机名,不含 www. | youtube.com |
[uploader], [channel] | 网站提供的上传者文字(如果有);两个占位符使用相同的值 | Sample channel |
[resolution] | 视频尺寸或已知的视频高度;音频和字幕为空 | 1920x1080, 1080p |
[width], [height] | 视频或图像的宽度或高度,单位为像素;无数据时为空 | 1920, 1080 |
[duration] | 提供的视频或音频时长,以总分钟数表示为 mm-ss;无数据时为空 | 02-05 |
[lang] | 字幕轨道语言;不可用或不是字幕时为空 | en |
[format] | 最终文件扩展名,与 [ext] 相同 | mp4 |
[type] | 媒体类型:video、audio、image 或 subtitles | video |
[index] | 批量列表或播放列表中的原始位置,从 1 开始;单个项目为空 | 2 |
[counter] | 所选批次中的连续编号,从 1 开始,按批次大小的位数在前面补零;单个项目为 1 | 一批 12 中的 02 |
不支持 [id]:来源网站并不总能提供可用的媒体 ID。
示例
使用上面的示例值:
| 模式 | 保存的文件名 |
|---|---|
[title]_[quality] | My video_1080p.mp4 |
[title]_[date]_[time] | My video_2026-10-10_09-08-07.mp4 |
[title]_[site]_[index] | My video_youtube.com_2.mp4 |
[title]_[title] | My video_My video.mp4 |
[title].[ext] | My video.mp4 |
[date] - [time] | 2026-10-10 - 09-08-07.mp4 |
[channel] - [date] | Sample channel - 2026-10-10.mp4 |
[year]-[month]-[day]_[hour]-[minute] | 2026-10-10_09-08.mp4 |
[counter] | 一批 12 中的 02.mp4 |
holiday | holiday.mp4,然后 holiday (2).mp4 |
每次出现都会被替换,因此重复占位符也会重复其值。
缺失值和扩展名
缺失的元数据变为空文本,其周围多余的分隔符会被清理。没有上传者时,[title]_[uploader]_[quality] 会变为 My video_1080p.mp4,而不是 My video__1080p.mp4。
如果结果为空或仅有空格,则使用媒体标题。如果该名称也为空,则名称将回退为 download。
最终扩展名会自动添加。在末尾使用 [ext] 不会添加两次。[format] 表示输出容器,不会将下载内容转换为其他格式。
安全的文件名
文件名会被处理为适用于 Android、Windows 和 macOS 的安全名称:删除或替换非法字符及控制字符,去除末尾的点号和空格,保护 Windows 保留设备名,并在保留扩展名的前提下缩短过长的名称。命名模式生成文件名,而不是子文件夹。
现有文件永远不会被覆盖。如果目标中已存在某个名称,或者同一批次中的另一个项目使用该名称,则在扩展名之前添加 (2)、 (3) 等。例如:holiday.mp4、holiday (2).mp4、holiday (3).mp4。
下载位置和临时存储请参阅文件和文件夹。浏览器扩展没有文件命名模式设置。