ANi资源提供器配置¶

简介¶

ANi Project是一个全自动下载流媒体网站（动画疯、Bilibili等）番剧资源的项目。官方频道：Telegram Channel

由于ANi项目与上游的流媒体平台放送时间完全同步，所以该源能够最及时地跟踪正在放送的番剧更新。

本项目将会同步ANi更新的所有番剧到你的私有库中。由于是内嵌字幕，该项目的视频源不适合用作收藏，我们推荐定期清除旧的下载。

同时支持ANi的直链下载API以及Torrent API。

前提¶

你已经安装好了Kubespider。

如果使用Torrent API，我们强烈推荐在download_provider.yaml中设定qBittorrent的优先级高于Aria2，以使用qBittorrent的相关新特性。

特性¶

自动解析番剧名，识别Season和Episode，并保存为Jellyfin / Emby可直接刮削的文件名格式
[仅限Torrent API]支持qBittorrent的子分类特性，更好地管理剧集结构
支持手动映射Season，以识别类似“石之海篇”、“不灭钻石篇”等非常规Season名，默认识别关键词第*季
[仅限直链API] 支持对集数进行修正，以应对Ani源与TMDB等海外媒体库集号不一致的情况

配置手册¶

你可以通过${HOME}/kubespider/.config/source_provider.yaml配置，配置解释如下：

ani_source_provider:
  type: ani_source_provider
  enable: false
  api_type: http
  rss_link: https://api.ani.rip/ani-download.xml
  rss_link_torrent: https://api.ani.rip/ani-torrent.xml
  blacklist: [ ]
  # HTTP Options
  classification_on_directory: true
  custom_season_mapping:
  season_episode_adjustment:
  # Torrent Options
  download_param:
    tags:
      - ANi
    category: ANi
  use_sub_category: true
  custom_category_mapping:

type：订阅源类型，需为ani_source_provider。
enable：是否开启此provider。
api_type：选择使用的API类型，http使用直链下载，torrent使用种子，默认为http。
rss_link：ANi的API地址，默认已经填好。
rss_link_torrent：ANi的Torrent API地址，默认已经填好。
classification_on_directory：是否按照番剧名分文件夹保存。启用该项有助于Emby/Jellyfin等媒体服务器刮削。
blacklist：黑名单，可以是list或者str，在黑名单中的番剧将不会被下载。黑名单使用纯字符串匹配，不支持正则表达式，为空时默认下载所有番剧。
custom_season_mapping：季映射，通过关键字识别映射Season，格式请参考source_provier.yaml中的注释或者下方的最佳实践。
season_episode_adjustment：集数修正，格式请参考source_provier.yaml中的注释或者下方的最佳实践。
download_param.tags：提交给qBittorrent的tags。
download_param.category：提交给qBittorrent的分类。
use_sub_category：qBittorrent的子分类支持，有助于高效管理番剧内容。
custom_category_mapping：qBittorrent的子分类映射，用于适配用户自己的内容管理模式。

下载好的文件默认保存在$download_base_path/TV/ANi中，可根据该路径合理映射docker volume。

最佳实践¶

直链API¶

ani_source_provider:
  type: ani_source_provider
  enable: true
  api_type: http
  rss_link: https://api.ani.rip/ani-download.xml
  rss_link_torrent: https://api.ani.rip/ani-torrent.xml
  blacklist:
    - 我的英雄學院
    - 16bit 的感動 ANOTHER LAYER
    - 我們的雨色協議
  # HTTP Options
  classification_on_directory: true
  custom_season_mapping:
    千年血戰篇-訣別譚-: 2
    刀匠村篇: 4
  season_episode_adjustment:
    關於我轉生變成史萊姆這檔事:
      2: -24
      3: -48
    咒术回战:
      2: -24

对于直链API，我们的建议是开启classification_on_directory。

ANi下载器默认内置了Season识别并且始终启用，遇到常规的“第二季”、“第五季”等关键词，会自动将文件名转换成SXXEXX的格式。

custom_season_mapping¶

custom_season_mapping按照[str] keyword: [int] season格式填写，在下载剧集时，假设有以下默认保存路径：

ANi/BLEACH 死神 千年血战篇-诀别谭-/[ANi] BLEACH 死神 千年血战篇-诀别谭- - 18 [1080P][Baha][WEB-DL][AAC AVC][CHT].mp4

经过自定义季映射后，会保存为：

ANi/BLEACH 死神 千年血战篇-诀别谭-/[ANi] BLEACH 死神 - S02E18 [1080P][Baha][WEB-DL][AAC AVC][CHT].mp4

文件子目录不会变，因为Jellyfin / Emby支持不同Season的TV分开存放在不同目录下，会自动合并。

custom_season_mapping会自动剔除文件名中的关键词，然后在集数前加上对应的Season。

season_episode_adjustment¶

ANi部分番剧在多季的情况下命名格式可能与Emby / Jellyfin不同。例如，有些番剧在第2季之后沿袭第一季的集数继续增加，而对应的番剧在TMDB则是以S02E01从头开始，这样会导致Emby / Jellyfin无法识别到剧集信息。

season_episode_adjustment按照以下格式填写：

Title:
  [int] Season: [int] Offset

以上面写到的最佳实践为例，在ANi下载器检测到《關於我轉生變成史萊姆這檔事》的第3季时，会自动将集数减去48，假设有以下默认保存路径：

ANi/關於我轉生變成史萊姆這檔事 第三季/[ANi] 關於我轉生變成史萊姆這檔事 第三季 - 49 [1080P][Baha][WEB-DL][AAC AVC][CHT].mp4

经过剧集调整后，会保存为：

ANi/關於我轉生變成史萊姆這檔事 第三季/[ANi] 關於我轉生變成史萊姆這檔事 - S03E01 [1080P][Baha][WEB-DL][AAC AVC][CHT].mp4

Torrent API¶

ani_source_provider:
  type: ani_source_provider
  enable: true
  api_type: http
  rss_link: https://api.ani.rip/ani-download.xml
  rss_link_torrent: https://api.ani.rip/ani-torrent.xml
  blacklist:
    - 我的英雄學院
    - 16bit 的感動 ANOTHER LAYER
    - 我們的雨色協議
  # Torrent Options
  download_param:
    tags:
      - ANi
    category: ANi
  use_sub_category: true
  custom_category_mapping:
    '神覺者候補選拔試驗篇': '肌肉魔法使-MASHLE-/Season 02'
    '魔術士歐菲 流浪之旅 聖域篇': '魔术士欧菲流浪之旅/Season 04'

对于Torrent API，我们强烈建议开启use_sub_category参数，并且在qBittorrent的设置-下载中勾选“启用子分类”：

与直链API不同，qBittorrent无法在创建下载任务的时候更改文件名，也代表无法进行剧集调整，因此启用use_sub_category后会将文件整理成Jellyfin推荐的TV Shows目录结构，将所有第N季的剧集划分到番剧的Season N子目录下：

注意：

qBittorrent版本 < 5.0.0时，新建一个不存在的子分类，保存路径会在"默认保存路径"下

在版本 >= 5.0.0 后，新建不存在的子分类，保存路径则会跟随母分类

详情可参考qBittorrent Github PR 19957

custom_category_mapping¶

作用与直链API的custom_season_mapping基本一致，将文件标题映射为自己规定的分类名，此处不再赘述。

启用配置¶

默认配置已经能够运行，将enable改为true后直接重启Kubespider即可。

docker restart kubespider

因为KubeSpider默认的更新机制是每3600秒（1小时），我们推荐在整点后若干分钟启动Kubespider，每次更新时能够恰好抓到最新的番剧信息，或者手动将docker容器中/kubespider/core/period_server.py中line 17：

class PeriodServer:
    def __init__(self, source_providers) -> None:
        self.state_config = YamlFileConfigReader(Config.STATE.config_path())
        self.period_seconds = 3600
        self.source_providers = source_providers
        self.queue = queue.Queue()

self.period_seconds调整为1800或更低。但是请注意，过短的刷新间隔可能导致资源占用的增加。