解放双手，半自动化批量导入方案

[chivehao]

RFC :番剧半自动化批量导入方案

概述	番剧批量导入时自动拉取条目并绑定剧集
已创建	2024 年 09 月 25 日
状态	WIP
所有者	chivehao
贡献者	chivehao

背景和动机

当存在大量番剧时，一个个导入，并绑定剧集很是麻烦，需要批量导入的方案。

目标和非目标

目标

导入目录时，自动根据该目录下的目录名称，查询番组计划和TMDB，拉取条目，并自动匹配目录下的剧集文件，和条目的剧集绑定，绑定时自动绑定剧集文件的同名字幕。

非目标

注意：非目标可实现可不实现，只是作为后续的优化方向。

• 播放剧集时，如当前剧集需要字幕，则自动去网络查询并下载当前剧集文件的字幕
• 条目目录下的比如Sp类型的目录，自动新建并匹配为对应类型的剧集
• 条目目录下的比如CD类型的目录，自动查询对应条目并拉取并进行资源的绑定

设计

• 整个方案以本体为主，插件辅助为基调，插件可以通过传入
• 以单个条目为一个后台任务，将操作分解成批量后台任务执行
• 对应待导入的目录，需要先判断是否为条目目录，否则则跳过
• 所有的元数据网站都没有结果的，则带上信息并返回异常，让对应的后台任务失败
• 目录名将中括号内的转换成条目标签，然后根据去掉所有中括号的名称作为关键词搜索

条目目录特征

• 目录名有中括号或小括号
• 目录内部的目录均无中括号，文件名可能包含中括号或小括号

[chivehao]

目标

• 单个目录绑定：根据目录名找到对应的条目信息并创建，将对应的文件绑定到对应的条目，剧集文件绑定到剧集正文，SP如OP, ED这些创建对应的剧集进行绑定。
• 批量绑定接口：提供一个目录，扫描目录下的所有子目录，依次将子目录作为入参调用上方的单个目录绑定接口

自动化工作流

工作流需要可以扩展，可以随时往中间增加一步或者减少一步，并给插件提供钩子。
设计工作流任务，展示任务状态，比如进行到哪一步了，是否成功，失败的话原因是什么。
类似事务的失败回滚机制？

1. 目录名去掉中括号，中括号的内容创建对应的附件标签绑定到附件。
2. 根据目录纯净的名称，获取条目的信息，比如从番组计划查询，或者通过AI查询番组计划ID
3. 根据三方平台的条目ID快速拉取创建条目
4. 将目录中括号的内容，创建程对应的条目标签绑定条目
5. 获取目录下的子文件和对应的SPs目录下的文件
6. 单个文件的处理：先获取纯净文件名，去掉文件名的中括号，如果全是中括号，则判断哪个是文件名进行保留，其它的中括号创建成附件的标签绑定到这个附件上
7. 视频文件和剧集的绑定：根据序号绑定条目对应的剧集，如果找不到对应的剧集，则创建对应的剧集并进行附件和剧集的绑定。

[chivehao]

相关：

• feat: v1.1.13 dev #846