123SUDODocs
指南

文件命名模式

使用占位符和示例选择下载名称,在 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-DD2026-10-10
[time]下载的本地时间,HH-mm-ss09-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 或 subtitlesvideo
[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
holidayholiday.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。

下载位置和临时存储请参阅文件和文件夹。浏览器扩展没有文件命名模式设置。

在此页面上