コマンド ab-plugin

ab-plugin は autobangumi-sdk の wheel と一緒にインストールされます。依存は ab_sdk だけで、AutoBangumi 本体のインストールは不要です。

uv tool install ./autobangumi_sdk-0.6.0-py3-none-any.whl
# プロジェクト内の場合：uv add ./autobangumi_sdk-0.6.0-py3-none-any.whl

wheel は 4.0 beta / 正式版の GitHub Release の添付ファイルです。PyPI には公開しません。SDK の入手 を参照してください。コントラクトテストには pytest が必要です。new が作る pyproject.toml には dev 依存グループに pytest が入っています。自分で作ったプロジェクトでは uv add --dev pytest（または autobangumi-sdk[test] をインストール）を使います。

new

ab-plugin new <id> [--kind rename|notifier|search] [--dir .]

<id>/ ディレクトリを作成します。

<id>/
├── plugin.toml
├── <id のアンダースコア形>/__init__.py   # プラグインのコード
├── tests/test_contract.py                # ab_sdk.testing のスイートを継承
├── pyproject.toml                        # 開発専用。パッケージには含まれません
└── README.md

id に使えるのは小文字、数字、ハイフンだけです。ディレクトリが既にあると実行を拒否します。ダウンローダーのひな形はありません。ダウンローダーには実際のバックエンドが必要で、そのままコントラクトを通るひな形には意味がないためです。

生成される pyproject.toml は autobangumi-sdk に依存します。このパッケージは PyPI にないため、uv run pytest の前にプラグインディレクトリで一度 uv add <wheel のパス> を実行します。uv はこの依存にローカルの wheel を使うようになります。

validate

ab-plugin validate [path]

マニフェストのフィールド、sdk の範囲に現在の SDK が含まれるか、エントリモジュールの有無、フロントエンドのエントリファイルの有無を検証します。ネイティブ拡張（.so / .pyd / .dylib / .dll）を含むディレクトリは拒否します。問題があると終了コードは 1 です。

pack

ab-plugin pack [path] [-o dist]

検証してから dist/<id>-<バージョン>.zip を作成します。内容は zip のルートに置かれ、署名付きカタログのパッケージと同じ構成です。tests/、pyproject.toml、uv.lock、dist/、.venv、.git、node_modules、各種キャッシュ、.pyc は除外されます。ファイルの順序とタイムスタンプは固定なので、同じ内容からは同じ sha256 が得られます。

dev

ab-plugin dev [path] [--config-dir config]

• 検証してから、プラグインディレクトリを <config-dir>/plugins/local/<id> にシンボリックリンクします。
• --config-dir の既定値はカレントディレクトリの config です。プラグインディレクトリで実行する場合は、AB の設定ディレクトリ（ソースから実行する場合は backend/src/config）を指定します。
• シンボリックリンクはプラグインディレクトリの絶対パスを指します。AB が同じパスでそこを開ける必要があります（ソースから実行する AB など）。AB を Docker で動かす場合は、プラグインディレクトリをコンテナの config/plugins/local/<id>/ にコピーまたはマウントし、設定 → プラグイン で「未署名プラグインを許可」をオンにしてから有効にします。
• ホストの設定ファイル（config_dev.json、なければ config.json）に plugins.dev_mode、plugins.allow_unsigned、plugins.enabled.<id> を書き込みます。
• 設定ファイルがないと実行を拒否します。先に AutoBangumi を一度起動してください。
• 動作中の AB は設定ファイルを再読み込みしません。一度再起動してください。以後、dev_mode が 1 秒ごとにローカルプラグインのディレクトリを確認し、ファイルが変わるとそのプラグインをリロードします。読み込みに失敗したプラグインも監視されるので、ソースを直すと自動で復旧します。
• dev_mode が監視するのはローカルディレクトリだけです。pip パッケージは監視しません。新しく現れたプラグインディレクトリは、次の設定変更か再起動まで検出されません。

開発ループ

ab-plugin new my-notify --kind notifier
cd my-notify
uv add ../autobangumi_sdk-0.6.0-py3-none-any.whl   # 一度だけ
uv run pytest            # コントラクトテスト
ab-plugin dev . --config-dir /path/to/autobangumi/config   # リンクしてホットリロードを有効化。AB を一度再起動
# コードを変更 → AB が自動でリロード → WebUI で確認
ab-plugin pack .