Auto_Bangumi/docs/ja/dev/plugins/points/rename-strategy.md

リネーム方式 (rename_strategy)

ダウンロードが完了すると、AB は設定「リネーム方式」（plugins.slots.rename_strategy）が選ぶ Provider を、トレント内の各本編と字幕に対して呼びます。ホストが持つのは none（元の名前のまま）だけです。pn、advance、template は組み込みプラグイン rename が提供します。プラグインが登録した id は、設定 → 作品管理設定 → リネーム方式の一覧に表示されます。

from ab_sdk import Plugin, points, provider
from ab_sdk.rename import RenameInput, RenameSkipped, pad


class JellyfinStyle:
    def target_name(self, f: RenameInput) -> str:
        language = f".{f.language}" if f.kind == "subtitle" else ""
        if f.episode_type == "movie":
            return f"{f.bangumi_name}{language}{f.suffix}"
        if not f.bangumi_name:
            raise RenameSkipped("作品フォルダ名がありません")
        return f"{f.bangumi_name} - S{pad(f.season)}E{pad(f.episode)}{language}{f.suffix}"


class MyRename(Plugin):
    @provider(points.RENAME_STRATEGY, id="jellyfin-style")
    def jellyfin(self):
        return JellyfinStyle()

RenameInput

凍結されたスナップショットです。

フィールド	説明
kind	media または subtitle（字幕に別の方式はありません。kind で区別します）
media_path	トレント内の元の相対パス
title	ファイル名から解析したタイトル
bangumi_name	保存ディレクトリの作品フォルダ名（映画は Title (Year)）
season、episode	シーズンと話数。episode には話数オフセットが適用済みです
suffix	ドット付きの拡張子。例：.mkv
episode_type	episode、movie、special
language	字幕の言語。例：zh、zh-tw
group	字幕グループ。None の場合があります

title と bangumi_name は、ディスク上に既にあるファイル名やフォルダ名に由来します。それぞれ 1 つのパス要素です。AB は予約文字の除去を行いません。

戻り値とエラー

• トレント内の新しい相対パスを返します。通常はファイル名だけです。拡張子と字幕の言語は、方式自身が付けます。f.media_path を返すとリネームしません。
• pad(n, width=2) はゼロ埋めをし、小数部分を保ちます：pad(9.5) == "09.5"。総集編などの半話は小数部分を保つ必要があります。保たないと、同じシーズンの整数の話を上書きしてしまいます。
• RenameSkipped(理由) を送出すると、そのファイルは元の名前のままになり、トレントに「リネーム済み」タグは付かず、トレントごとに理由付きの rename_skipped 通知が 1 件送られます。問題を直せば、次の周期で自動的に再試行されます。これは入力または設定に問題があることを表し、ブレーカーには数えません。失敗したときに別の命名方式へ切り替えないでください。
• それ以外の例外、空文字列、文字列でない値：ファイルは同様に元の名前のままになり通知が送られます。また、失敗はブレーカーに数えられます。
• target_name は同期呼び出しで、タイムアウトがありません。中でネットワークやディスクの IO を行わないでください。
• 設定で選ばれた id が登録されていない場合（プラグインが無効、またはブレーカー作動中）は、AB がログを 1 行書き、none として動作します。

テスト

from ab_sdk.testing import RenameStrategyContract, create_plugin

class TestStrategy(RenameStrategyContract):
    def create(self):
        plugin, _ = create_plugin(MyRename)
        return plugin.jellyfin()

スイートは次を検査します：空でない相対パス、.. を含まない、拡張子が保たれる、結果が決定的。方式が一部の入力にしか対応しない場合は、samples() を上書きします。

例：examples/plugins/template-rename（独自フィルター付きのテンプレート）。