6.0 KiB
プラグイン開発
::: warning プレビュー版 SDK
プラグイン SDK ab_sdk は 4.0 の間は 0.x 版で、互換性のない変更が入る場合があります。4.1 で 1.0 に固定され、以後はセマンティックバージョニングに従います。マニフェストの sdk フィールドで対応する SDK のバージョン範囲を宣言します。互換性のないプラグインは AB が読み込みを拒否します。
:::
プラグインは Python パッケージです（フロントエンドコンポーネントを付けることもできます）。AutoBangumi のプロセス内で動作します。ダウンローダー、通知チャンネル、検索サイト、リネーム方式を追加できます。パイプラインへのフック、イベントの購読、REST ルート、MCP ツール、設定ページの UI も提供できます。
5 分で始める
-
SDK とコマンドラインをインストールします。wheel は 4.0 の各 beta / 正式版の GitHub Releases に添付されます（ファイル名は
autobangumi_sdk-<SDK バージョン>-py3-none-any.whl）。PyPI には公開しません。詳しくは SDK の入手 を参照してください。uv tool install ./autobangumi_sdk-0.6.0-py3-none-any.whl -
ひな形を作ってテストします。ひな形の
pyproject.tomlはautobangumi-sdkに依存しますが、このパッケージは PyPI にありません。先にuv addでダウンロードした wheel を指定します。ab-plugin new my-rename --kind rename # notifier、search も選べます cd my-rename uv add ../autobangumi_sdk-0.6.0-py3-none-any.whl # wheel の実際のパスに置き換えます uv run pytest # ひな形にはコントラクトテストが付いています -
ローカルの AutoBangumi にリンクし、ホットリロードを有効にします。先に AB を一度起動して、設定ディレクトリに設定ファイルを作っておきます。
--config-dirにはこのディレクトリを指定します（ソースから実行する場合はbackend/src/config）。ab-plugin dev . --config-dir /path/to/autobangumi/configAB を一度再起動します。以後は、プラグインのファイルを変更すると自動でリロードされます。
-
パッケージ化します。
ab-plugin pack .でdist/my-rename-0.1.0.zipができます。
ドキュメント一覧
基本
-
SDK の入手：GitHub Release の wheel とプラグイン開発 skill
-
基本概念：
Plugin、ctx、3 種類の拡張宣言、マニフェスト、分離とサーキットブレーカー -
設定フォーム：
config_modelが WebUI のフォームになる仕組み -
イベント：システムイベント、整理イベント、独自イベント
-
フロントエンドスロット：Web Components と
AbHost -
コマンド ab-plugin：
new、validate、pack、dev -
署名と配布：ローカルプラグイン、署名付きカタログ、公開手順
-
組み込みプラグイン：
rename、hardlink、ingest-filters、media-server-refresh
拡張ポイント
| 拡張ポイント | 種類 | 用途 |
|---|---|---|
ダウンローダー downloader |
Provider | 新しいダウンローダーのバックエンド |
通知チャンネル notifier |
Provider | 新しい通知チャンネル |
LLM プロバイダー llm_provider |
Provider | 新しい LLM 解析プロバイダー |
検索サイト search_site |
Provider | 検索ボックスのサイト |
定期タスク scheduled_task |
Provider | 定期的に実行するタスク |
メタデータソース metadata_provider |
Provider | RSS 購読の「パーサー」 |
リネーム方式 rename_strategy |
Provider | ファイル名の生成規則 |
ファイル分類 media_files |
Provider | トレント内のファイルを本編・字幕・無視に分類 |
バージョン競合ポリシー conflict_policy |
Provider | 新旧のトレントが同じファイル名を取り合う場合 |
REST ルート api_router |
Provider | プラグイン独自の HTTP エンドポイント |
MCP ツールとリソース mcp_tool mcp_resource |
Provider | MCP クライアントへの公開 |
トレントフィルター torrent.filter |
filter フック | トレントをダウンロードするか判定 |
解析結果の補正 title.parsed |
transform フック | タイトル解析結果の補正 |
追加リクエストの変更 torrent.adding |
transform フック | 保存パス・カテゴリ・タグの変更 |
HTTP リクエスト http.request |
transform フック | AB の GET リクエストに Cookie などを追加 |
通知メッセージテンプレート message_template |
transform フック | プッシュ文面の書き換え |
プラグインはイベントの購読（@subscribe）と、専用のキーバリューストア・データディレクトリも使えます。