AutoBangumi 番剧管理（bangumi_manage）配置详解：重命名方式、剧集补全与种子治理

后端前端音视频【免费下载链接】Auto_BangumiAutoBangumi - 全自动追番工具项目地址https://gitcode.com/gh_mirrors/au/Auto_Bangumi点击查看免费下载本文以 AutoBangumi 的「番剧管理」模块为核心系统讲解 WebUI 与config.json中bangumi_manage配置节的每一项开关与参数四种重命名方式、剧集补全、组标签、坏种清理与未匹配种子记录并结合仓库源码说明每个选项背后的实际调用链与默认行为。读完本文你将能够按自己的媒体库习惯Plex / Jellyfin / 纯做种目录配置出最合适的整理策略并理解关闭某个开关后系统具体会发生什么。番剧管理器从“追番”到“整理”的核心枢纽AutoBangumi 的核心链路是「RSS 订阅 → 下载器qBittorrent 等→ 番剧整理」三段式流水线。番剧管理器Bangumi Manage承担的是最后一段它周期性地检查下载器中已完成的种子按用户配置对文件进行重命名、剧集偏移修正、整季补全和异常种子清理最终把下载器里混乱的发布标题整理成规范的媒体库结构。管理器是否启用直接决定了整个整理循环是否运行。在 checker.py 中check_renamer()仅凭一行判断决定结果if settings.bangumi_manage.enable: return True也就是说关闭「启用」开关后重命名与整理相关设置全部不会生效下载器中的文件会以原始种子名保留。这一点与文档描述完全一致。WebUI 配置选项逐一详解WebUI 的「番剧管理」设置页即上图中的 manager 设置界面提供了 6 个选项下面逐一说明其语义与源码层面的行为。启用布尔开关对应配置节中的enable默认值为true。如上文所述它控制Checker.check_renamer()的返回值进而决定整理循环是否启动。关闭后重命名、剧集补全等能力全部停用适合只做“下载不动文件”的场景。重命名方式rename_method这是番剧管理器最核心的选项共四种取值默认pn取值文档语义实际输出格式来自 renamer.pypn保留更多发布标题信息{title} S{season}E{episode}{suffix}例如[Fansub] 某动画 S01E01.mkv其中title取自种子/文件自身的发布标题advance使用官方标题与标准季集格式{bangumi_name} S{season}E{episode}{suffix}使用番剧官方标题与保存目录文件夹名一致normal较保守的番剧标题与集数命名从当前仓库源码看normal已被标记为弃用logger.warning(Normal rename method is deprecated.)实际行为是直接返回原路径、不做重命名与none等价none不重命名文件返回原始媒体路径文件保持种子原名需要特别说明的是pn与advance的差异前者文件名保留发布组的标题风格后者统一采用官方标题更适合需要与 TMDB 等元数据服务严格对齐的媒体库。季season编号来自保存目录的文件夹名如Season 01集数则遵循两位补零格式1→01对于总集篇等半集如 12.5源码会保留小数以避免覆盖同季的整数集。此外重命名还覆盖电影/剧场版场景gen_movie_path电影类文件采用Title (Year).ext风格不使用SxxExx编号字幕文件则通过subtitle_pn/subtitle_advance方法在剧集名后追加语言后缀。番剧补全eps_complete布尔开关默认false。开启后管理器会检测当季缺失的集数并尝试补全下载。源码实现位于 collector.py 的eps_complete()它查询所有未完成的番剧记录对eps_collect标记为 False 的番剧调用SeasonCollector.collect_season()通过搜索器或 RSS 链接批量获取整季种子并加入下载器。该函数由 loops.py 在每轮收集循环中按条件触发if settings.bangumi_manage.eps_complete: await eps_complete()添加组标签group_tag布尔开关默认false。开启后下载器中任务的名字会带上字幕组标签。源码实现位于 path.py 的rule_name()RSS 规则名由{官方标题} S{季}变为[{字幕组}] {官方标题} S{季}。注意源码注释特别强调组标签只影响 qBittorrent RSS 规则名从不写进重命名后的文件名——已有做种媒体库的文件名必须保持稳定否则升级后会触发整库批量重命名破坏 Plex/Jellyfin 索引与硬链接。删除坏种remove_bad_torrent布尔开关默认false。开启后当某个种子的媒体路径无法被解析器识别解析失败时管理器会直接调用下载器删除该种子。源码中出现在 renamer.py 的单文件处理与 同文件 L299-L300 的路径解析失败时若开关开启则执行client.delete_torrent(hasheshash)清理异常任务。记录未匹配种子track_orphans布尔开关默认true。开启时把当前没有匹配到任何规则的种子记录为「未匹配种子」orphan入库关闭后这些条目不写入数据库但会在每轮 RSS 刷新时被重新在内存中匹配因此后续新增规则可以立即“接住”RSS 源中仍存在的旧条目。源码依据在 engine.pyif not settings.bangumi_manage.track_orphans: # 不记录未匹配种子它们每轮会被 check_new 重新看到并在内存中 # 重新匹配廉价后补规则能立即接住仍在源里的旧集 to_persist [t for t in to_persist if t.bangumi_id is not None]简言之开启适合希望保留完整“未匹配”历史记录的场景关闭则牺牲历史记录换取后补规则的即时生效与更小的数据库体积。config.json配置节bangumi_manage完整参数表config.json中对应的配置节为bangumi_manage。下表在原文档基础上补充了当前仓库源码中实际存在的默认值与附加参数字段模型定义见 models/config.py默认值见 conf/const.py参数说明类型WebUI 选项默认值enable启用番剧管理器布尔值启用trueeps_complete启用剧集补全布尔值番剧补全falserename_method重命名方式pn/advance/normal/none字符串重命名方式pngroup_tag添加字幕组标签布尔值添加组标签falseremove_bad_torrent删除错误种子布尔值删除坏种falsetrack_orphans记录未匹配种子布尔值记录未匹配种子truerevision_conflict_policy高版本发布替换旧版本冲突策略hold/replace字符串进阶hold其中revision_conflict_policy是原文档表格之外、但同属bangumi_manage配置节的参数当同一个番剧同一集的“高版本”发布V2/V3 等压制版本指向已被占用的规范路径时hold表示保留现有文件、记录冲突replace表示通过带租约的替换流程staging → promote → 删除旧任务安全升级到新版本。该替换流程要求新旧任务均为单文件种子且确认为严格版本升级判定逻辑见 revision_policy.py。实际使用时将以上参数写入config/config.json的bangumi_manage节即可例如{ bangumi_manage: { enable: true, eps_complete: true, rename_method: advance, group_tag: true, remove_bad_torrent: false, track_orphans: true, revision_conflict_policy: hold } }环境变量覆盖Docker 部署使用 Docker 部署时bangumi_manage的配置同样可以通过环境变量覆盖映射关系定义在 conf/const.py环境变量对应参数取值说明AB_RENAMEenabletrue/1/t视为开启AB_METHODrename_method字符串转为小写AB_GROUP_TAGgroup_tagtrue/1/t视为开启AB_EP_COMPLETEeps_completetrue/1/t视为开启AB_REMOVE_BAD_BTremove_bad_torrenttrue/1/t视为开启AB_REVISION_CONFLICT_POLICYrevision_conflict_policyhold/replace源码级原理重命名循环与ab:renamed标记为了让读者对「重命名方式」有更深的理解这里补充一个源码层面的关键机制。重命名主入口是Renamer.rename()renamer.py其大致流程为从下载器拉取待处理任务已完成且未打标批量查询每个任务的番剧偏移量episode_offset/season_offset/episode_type查询顺序为 qB hash → 标签中的ab:id→ 标题匹配 → 保存路径匹配按媒体文件数量分流单文件走_process_single_torrent多文件走rename_collection后者完成后会把任务归入BangumiCollection分类字幕文件紧随其后重命名重命名成功的任务会被打上ab:renamed标签_mark_renamed作为“顶层媒体文件已全部就位”的终态标记供 filebot、hlink 等外部脚本过滤已处理任务每次重命名操作都会在rename_operation表中留下带状态机retry/running/conflict/done等的记录失败操作在 5 分钟冷却后自动重试。这套机制解释了为什么rename_method选择pn或advance后重启或升级不会触发整库批量重命名已完成任务都有ab:renamed标签做幂等标记已做种媒体库的文件名保持稳定。相关配置与 FAQ 指引番剧管理的效果与下载路径设置紧密相关保存路径决定了重命名时从文件夹名解析出的季号相关说明见 FAQ 首页 中关于下载路径与文件重命名的章节。另外番剧管理还与其他配置节协同工作RSS 订阅配置决定哪些番剧进入下载队列是番剧管理器处理的对象来源下载器配置保存路径、下载器类型等直接参与保存路径生成与任务归类通知配置重命名成功与冲突事件会通过通知中心推送。综上AutoBangumi 的番剧管理模块以bangumi_manage配置节为总控覆盖了从“下载完成”到“媒体库就绪”的全过程。理解每个开关在源码中的实际作用点就能针对自己的媒体库形态是否使用 Plex/Jellyfin、是否保留做种、是否接受自动替换旧版本做出最合适的取舍。赞分享后端前端音视频【免费下载链接】Auto_BangumiAutoBangumi - 全自动追番工具项目地址https://gitcode.com/gh_mirrors/au/Auto_Bangumi点击查看免费下载相关推荐AutoBangumi 番剧管理配置详解重命名方式、番剧补全与未匹配种子管理AutoBangumi 番剧管理配置详解重命名方式、番剧补全与未匹配种子管理 AutoBangumi全自动追番工具的番剧管理Bangumi Manage后端前端音视频AutoBangumi 番剧整理与重命名管理器Bangumi Manager完全配置指南AutoBangumi 番剧整理与重命名管理器Bangumi Manager完全配置指南 本文以 AutoBangumi 官方英文文档 docs/en/co后端前端音视频AutoBangumi 文件重命名机制全解析三种重命名方式、收藏整理与剧集偏移实战AutoBangumi 文件重命名机制全解析三种重命名方式、收藏整理与剧集偏移实战 AutoBangumiAB作为全自动追番工具其文件重命名模块负责把下后端前端音视频创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考