媒体库管理

媒体库 (Library) 是 Amane 管理本地媒体文件的单位. 每个库对应一个磁盘目录, 其中的文件将注册到 Amane, 并支持自动监听此目录下的文件变更、自动刮削新文件, 并通过整理规则组织文件结构.

创建媒体库

「媒体库 → 添加」

路径模板

路径模板决定整理后文件的存储位置. 模板使用占位符变量:

常用占位符

占位符	说明	示例值
{number}	番号	MIDV-123
{title}	标题	Title Here
{actors}	演员 (逗号分隔)	Actor1, Actor2
{studio}	制作商	Studio Name
{series}	系列	Series Name
{release}	发行日期	2024-01-15
{video_dir}	视频文件渲染后的父目录	—
{dir}	源文件所在目录名	—
{dir_path}	源文件完整路径	—

默认模板

视频: {number}/{number}
缩略图: {number}/{number}-poster
NFO: {number}/{number}

示例

假设番号为 MIDV-123, 标题为 Sample Title:

{number}/{number}.mp4          → MIDV-123/MIDV-123.mp4
{studio}/{number}/{title}.mp4  → Studio Name/MIDV-123/Sample Title.mp4

整理操作

整理 (Organize) 操作会将媒体文件按路径模板放置到指定位置:

1. 在媒体库页面点击「整理」
2. 系统会根据路径模板计算目标位置
3. 按放置方式 (移动/复制/硬链接/符号链接) 执行

Note

整理操作不会自动触发, 需要手动执行. 可以通过任务系统排队整理任务.

分集 (CD) 后缀

Amane 支持自动识别分集文件并添加后缀:

• -CD1, -CD2 — 标准分集标记
• -Part1, -Part2 — 替代分集标记
• -A, -B — 字母分集
• -1 到 -9 — 尾部数字分集

分集后缀模板默认为 -CD{cd}, 可在库设置中自定义.

预告片跳过

库可配置正则表达式匹配预告片文件, 匹配的文件不会被当作正片处理:

• 默认模式: trailer.mp4
• 仅对文件名 (含扩展名) 匹配

自动化工作流

扫描

扫描是发现媒体文件并注册到数据库的过程:

• 手动扫描: 在库页面点击「扫描」
• 自动扫描: 文件监控检测到变化时自动触发

刮削

刮削是为已注册的文件获取元数据的过程:

• 手动刮削: 在影片详情页点击「刮削」
• 自动刮削: 文件监控 + 自动化级别为「监控+刮削」时自动触发

整理

整理是将文件按路径模板放置到正确位置:

• 目前仅支持手动触发
• 整理时会自动下载缺失的资源 (如海报)

多库支持

Amane 支持同时管理多个媒体库, 适用于:

• 不同类型的影片分库存放
• 不同磁盘/分区的媒体
• 测试环境与正式环境分离

Warning

建议不同库的根目录不要重叠 (父子目录关系), 以避免文件归属冲突.