7.4 KiB
番剧管理设置
WebUI 配置
{width=700}{class=ab-shadow-card}
- 启用：启用番剧管理器。关闭后，重命名与整理相关设置不会生效。
- 重命名方式：
pn：保留更多发布标题信息，使用种子标题 S0XE0X风格。advance：使用官方标题与标准季集格式。none：不重命名文件。template：按自定义模板命名，见下文模板重命名。pn、advance、template由内置插件「重命名」（rename）提供，默认启用；在 设置 → 插件 中停用它后，所有番剧按none处理。其它插件也可以提供重命名方式，启用后出现在下拉框中。
- 番剧补全：检测当季缺失集数并尝试补全下载。
- 添加组标签：为下载器中的任务添加字幕组相关标签。
- 删除坏种：移除下载器中状态异常的种子。
- 修订版冲突处理：更高修订版的种子指向已有剧集时，选择「保留现有文件」或「替换为更高修订版」。启用替换后，仅在更高修订版成功就位后删除旧种子及其数据。
- 记录未匹配种子：把当前没有匹配到规则的种子记录为“未匹配种子”。关闭后，后续新增规则可以立即接住 RSS 中仍存在的旧条目，但这些旧条目会在每轮 RSS 刷新时重新尝试匹配。
- 关于文件路径
- 关于重命名
config.json 配置选项
配置节：bangumi_manage
| 参数 | 说明 | 类型 | WebUI 选项 | 默认值 |
|---|---|---|---|---|
enable |
启用番剧管理器 | 布尔值 | 启用 | true |
eps_complete |
启用剧集补全 | 布尔值 | 番剧补全 | false |
group_tag |
添加字幕组标签 | 布尔值 | 添加组标签 | false |
remove_bad_torrent |
删除错误种子 | 布尔值 | 删除坏种 | false |
track_orphans |
记录未匹配种子 | 布尔值 | 记录未匹配种子 | true |
重命名方式与版本冲突策略是 Provider 选择，保存在 plugins.slots：rename_strategy（重命名方式，默认 pn）与 conflict_policy（hold / replace，默认 hold）。3.3 的 bangumi_manage.rename_method 与 revision_conflict_policy 在升级到 4.0 后第一次启动时自动迁移。完整说明见 插件设置。
模板重命名
选择 template 后，文件名由内置插件 rename 的模板生成。在 设置 → 插件 → 重命名 中修改「文件名模板」，默认值为：
::: v-pre
{{ title }} S{{ season|pad(2) }}E{{ episode|pad(2) }}
默认模板对普通剧集与 pn 的结果相同；剧场版 pn 不加 SxxExx，默认模板会加。模板使用 Jinja2 语法（沙箱模式），可用变量：
| 变量 | 含义 | 示例 |
|---|---|---|
title |
从文件名解析出的标题 | 葬送的芙莉莲 |
bangumi_name |
番剧文件夹名 | 葬送的芙莉莲 (2023) |
season |
季度（取自 Season 文件夹，已含季度偏移） | 1 |
episode |
集数（已含集数偏移，半集保留小数） | 5、12.5 |
episode_type |
episode / movie / special |
episode |
group |
字幕组，可能为空 | ANi |
kind |
media（正片）或 subtitle（字幕） |
media |
language |
字幕语言，正片为空 | zh |
pad(n) 过滤器把数字的整数部分补零到 n 位，小数保留：{{ episode|pad(3) }} 得到 005，{{ 12.5|pad(2) }} 得到 12.5。
- 模板只生成文件名主体，扩展名自动追加；字幕追加
.语言.扩展名，如.zh.ass。 - 保存时会用示例文件试渲染一次：语法错误、使用不存在的变量或渲染结果不合法的模板直接被拒绝。
- 运行时某个文件渲染失败、结果为空或含
/、\：该文件保留原名并发送「文件未重命名」通知，种子不打ab:renamed标签，修正模板后下一轮自动重试。不会退回pn。
示例：[{{ group }}] {{ bangumi_name }} - {{ episode|pad(2) }} → [ANi] 葬送的芙莉莲 (2023) - 05.mkv
:::
::: warning
更换重命名方式（包括修改模板）只影响之后整理的种子；已整理完成（带 ab:renamed 标签）的种子不会被重新命名。
:::
硬链接到媒体库
内置插件「硬链接到媒体库」（hardlink）默认停用，在 设置 → 插件 中启用。种子整理完成后，它把正片与字幕链接到媒体库目录；下载目录保持原样继续做种。
| 选项 | 说明 | 默认值 |
|---|---|---|
source_root |
下载根目录（AB 看到的绝对路径）。媒体库保持与它相同的目录结构 | 无，必填 |
library_root |
媒体库目录（绝对路径），不能位于 source_root 内 |
无，必填 |
path_map |
路径映射列表 [{downloader, from, to}]：把下载器 downloader（实例 id，默认 default）看到的路径前缀 from 换成 AB 看到的路径 to；按最长前缀匹配，未匹配的路径原样使用 |
[] |
cross_device |
硬链接遇到跨文件系统时：copy 复制文件、symlink 创建软链接、skip 跳过并通知 |
copy |
- 媒体库中已有同名文件、但不是本插件创建的：跳过，绝不覆盖，并发送「硬链接未完成」通知。
- 版本升级（新版本种子替换旧种子，文件名不变）后，本插件之前创建的链接会被原子替换为指向新文件的链接。
- 删除种子不会删除媒体库中的链接。
- 本插件放置后被你从媒体库删除的文件不会被重新链接；补链会重建它们。
- 启用前已经下载的文件不会自动处理。启用插件后，设置页出现「硬链接补链」分区，点击 链接已有文件 把下载根目录下已有的正片与字幕补链到媒体库，已链接的文件跳过。该按钮调用
POST /api/v1/plugins/hardlink/backfill。 path_map在插件配置表单中按行编辑（添加一行）。在config/config.json中对应plugins.options.hardlink.path_map，例如[{"downloader": "default", "from": "/downloads", "to": "/media/downloads"}]。
::: tip Docker
硬链接不能跨文件系统。在 Docker 中，请把下载目录与媒体库放在同一块盘上，并以同一个挂载点映射进 AB 容器（例如把 /mnt/media 整体挂载为 /media，下载目录与媒体库都在其下）。两个分别挂载的目录即使在同一块盘上，也会被视为不同的文件系统，此时按 cross_device 处理（默认复制，占用双倍空间）。下载器运行在另一个容器里、看到的路径与 AB 不同时，用 path_map 映射。
:::
媒体库刷新
内置插件「媒体库刷新」（media-server-refresh）在种子整理完成后请求 Jellyfin、Emby 或 Plex 刷新媒体库。在 设置 → 插件 → 媒体库刷新 中选择服务器类型，填写服务器地址与 API Key（Plex 为 X-Plex-Token）后生效；未填写时不做任何事。收到事件后等待「延迟」秒（默认 30），期间整理完成的种子合并为一次刷新；刷新请求发出后到达的事件会再排一次刷新。启用「硬链接到媒体库」时，文件放入媒体库后会再刷新一次，跨盘复制慢于延迟时新剧集也能出现。