归档刮削
归档刮削负责把“待整理目录”中的影视或音乐文件识别、重命名、补元数据，并移动/复制/链接到目标媒体库目录。
典型链路：
/CloudNAS/待整理 → 归档刮削 → /CloudNAS/影视库 或 /CloudNAS/音乐库 → 链接同步 → /media 或 /music视频归档流程
- 扫描监控目录中的视频文件。
- 从文件名中解析标题、年份、季集信息。
- 按刮削源顺序查询 TMDB / 豆瓣，必要时使用 AI 辅助识别。
- 根据归档规则生成目标目录和文件名。
- 写入 NFO、封面、海报等元数据。
- 按处理方式移动、复制、硬链接或软链接到目标目录。
- 如配置联动同步，归档完成后自动触发 STRM / 软链接同步任务。
视频归档任务参数
| 参数 | 含义 | 推荐填写 | 注意事项 |
|---|---|---|---|
| 任务名称 | 当前归档任务的显示名称 | 如 115电影归档、电视剧归档 | 建议包含云盘和媒体类型，便于区分 |
| 监控目录 | 待整理文件所在目录 | 如 /CloudNAS/115/待整理/电影 | 转存目标应落在该目录下，Webhook 才能触发 |
| 目标目录 | 归档后的媒体库根目录 | 如 /CloudNAS/115/影视库 | 后续链接同步的源目录通常就是这里 |
| 归档规则 | 决定目录结构、命名模板和分类方式 | 电影选电影规则，剧集选电视剧规则 | 规则不匹配会导致目录结构不符合预期 |
| 刮削源 | 元数据匹配来源 | 海外资源优先 TMDB，中文资源可加入豆瓣 | 多选时按顺序 fallback |
| 监控模式 | 自动触发方式 | 常用 Webhook 或 定时 | 多选可以同时开启，但不要和手动全量任务混淆 |
| 定时归档刮削 Cron | 定时触发表达式 | 如 0 */2 * * * 每 2 小时 | 只有选择定时监控时才生效 |
| 处理方式 | 文件从监控目录进入目标目录的方式 | CloudDrive2 挂载目录优先 CD2移动 或 CD2复制 | 不同方式对速度、空间和可回滚性影响很大 |
| 联动同步任务 | 归档完成后自动触发的同步任务 | 选择对应的 STRM / 软链接同步任务 | 被联动的同步任务不能同时开启监控模式 |
| 强制归档 | 忽略历史记录重新处理所有文件 | 修正规则或重建媒体库时开启 | 会增加扫描和处理量，谨慎使用 |
| 跳过失败 | 遇到无法识别或处理失败的文件时继续任务 | 大批量任务建议开启 | 失败文件可之后手动处理 |
| 跳过重复 | 目标目录已有同名资源时跳过 | 日常自动化建议开启 | 关闭后可能覆盖已有文件 |
| AI 辅助刮削 | TMDB / 豆瓣无法识别时辅助判断标题 | 文件名混乱时开启 | 需要先配置 AI 相关参数 |
视频处理方式说明
| 处理方式 | 含义 | 优点 | 风险 / 限制 |
|---|---|---|---|
CD2移动 | 通过 CloudDrive2 在云盘侧移动文件 | 不占本地带宽，适合云盘内整理 | 目标云盘和源云盘路径需受 CloudDrive2 支持 |
CD2复制 | 通过 CloudDrive2 在云盘侧复制文件 | 保留原文件，适合测试规则 | 会额外占用云盘空间 |
移动 | 容器内文件系统移动 | 本地文件或同一挂载内速度较快 | 跨挂载点可能退化为复制后删除 |
复制 | 容器内复制文件 | 保留原始文件，方便回滚 | 占用额外空间，速度较慢 |
硬链接 | 目标文件与源文件共享同一 inode | 不额外占空间，速度快 | 只能在同一文件系统内使用 |
软链接 | 目标位置创建指向源文件的链接 | 占用极小，适合本地目录 | 媒体服务器和容器都必须能访问源路径 |
视频刮削源说明
| 刮削源 | 作用 | 适合资源 | 需要配置 |
|---|---|---|---|
| TMDB | 查询电影/剧集标题、年份、简介、海报、季集信息 | 海外影视、规范命名资源 | TMDB API Key，国内环境通常需要代理 |
| 豆瓣 | 作为中文资源兜底匹配 | 国产剧、华语电影、中文标题资源 | 通常直连即可 |
| AI 辅助 | 根据混乱文件名推测标题和年份 | 文件名带广告、压制组、杂项信息时 | 需要配置 AI 服务 |
音乐归档流程
- 扫描监控目录中的音乐文件。
- 读取本地音频标签。
- 按刮削源顺序查询 QQ音乐 / 网易云 / 酷狗。
- 写回歌曲名、歌手、专辑、封面等标签。
- 按规则整理到目标目录。
- 可继续通过音乐链接同步生成 Navidrome 可索引的软链接。
音乐归档任务参数
| 参数 | 含义 | 推荐填写 | 注意事项 |
|---|---|---|---|
| 任务名称 | 当前音乐归档任务名称 | 如 115音乐归档 | 建议包含云盘来源 |
| 监控目录 | 待整理音乐文件目录 | 如 /CloudNAS/115/待整理/音乐 | 支持常见音频格式 |
| 目标目录 | 归档后的音乐库目录 | 如 /CloudNAS/115/音乐库 | 后续音乐同步的源目录通常就是这里 |
| 归档规则 | 音乐目录与命名模板 | 如 歌手/专辑/曲目 | 根据个人音乐库习惯选择 |
| 刮削源 | 音乐元数据来源 | 可按 QQ音乐 → 网易云 → 酷狗 顺序 | 多源 fallback 能提升命中率 |
| 监控模式 | 自动触发方式 | Webhook / 定时 | 大库推荐 Webhook + 防抖 |
| 定时归档刮削 Cron | 定时触发表达式 | 如 0 3 * * * 每天凌晨 3 点 | 只有定时监控生效 |
| 处理方式 | 整理文件的方式 | 云盘挂载目录优先 CD2移动 / CD2复制 | 音乐文件写标签时会修改文件内容 |
| 联动同步任务 | 归档完成后触发音乐同步 | 选择 Navidrome 软链接同步任务 | 与同步任务监控模式互斥 |
| 强制归档 | 重新处理所有音乐文件 | 修改规则或重新写标签时使用 | 会重新扫描和处理大量文件 |
| 跳过失败 | 单个文件失败不影响整体任务 | 建议开启 | 失败文件可后续单独处理 |
| 跳过重复 | 目标已存在时跳过 | 日常任务建议开启 | 关闭后可能覆盖目标文件 |
监控模式说明
| 模式 | 含义 | 适合场景 |
|---|---|---|
| 手动 | 点击任务卡片上的运行按钮 | 首次整理、测试规则、临时处理 |
| 事件通知 | 本地文件系统变化触发 | 本地目录或支持事件通知的挂载 |
| Webhook | CloudDrive2 文件变化通知触发 | 推荐用于云盘挂载目录 |
| 定时 | 按 Cron 表达式定期触发 | Webhook 不稳定或希望固定时间扫描 |
Cron 表达式示例
| 表达式 | 含义 | 适合场景 |
|---|---|---|
*/30 * * * * | 每 30 分钟执行一次 | 小型媒体库 |
0 */2 * * * | 每 2 小时执行一次 | 中型媒体库 |
0 3 * * * | 每天凌晨 3 点执行一次 | 大型媒体库，避开使用高峰 |
0 8,20 * * * | 每天 8 点和 20 点执行 | 固定早晚整理 |
联动同步配置
推荐自动化闭环：
归档任务目标目录 = 链接同步源目录
归档任务联动同步 = 对应链接同步任务示例：
| 项目 | 示例 |
|---|---|
| 视频归档监控目录 | /CloudNAS/115/待整理/电影 |
| 视频归档目标目录 | /CloudNAS/115/影视库/电影 |
| 视频链接同步源目录 | /CloudNAS/115/影视库/电影 |
| 视频链接同步目标目录 | /media/电影 |
同一个链接同步任务不能同时开启监控模式并作为归档联动目标。二者同时开启会导致重复触发，系统会自动清理冲突配置。
首次配置建议
- 先用少量文件测试归档规则。
- 目标目录先选择测试目录，确认命名和 NFO 正确后再改正式目录。
- 第一次任务建议手动运行，确认无误后再开启 Webhook 或定时。
- 大库任务建议开启「跳过失败」和「跳过重复」。
- 修改规则后如需重建，使用「强制归档」。
常见问题
| 问题 | 原因 | 处理 |
|---|---|---|
| 文件没有被识别 | 文件名太乱、标题年份不明确、刮削源未命中 | 手动改名、调整刮削源顺序、开启 AI 辅助 |
| Webhook 没触发任务 | 转存目标不在监控目录下，或任务未启用 Webhook | 检查 CloudDrive2 Webhook 和任务监控目录 |
| 归档后媒体服务器看不到 | 还没有执行链接同步，或媒体服务器没有索引目标目录 | 配置联动同步并刷新媒体库 |
| 音乐标签没有变化 | 文件无写权限，或处理方式不允许修改源文件 | 检查目录权限和处理方式 |
| 重复入库 | 关闭了跳过重复，或目标目录规划不一致 | 开启跳过重复并统一目标目录 |