mirror of https://github.com/EstrellaXD/Auto_Bangumi.git synced 2026-10-28 19:25:55 +08:00

Files

Estrella Pan 124b156b7a fix: 修复 4.0 工具链升级审查问题

- ab-plugin new 与示例插件的 requires-python 改为 >=3.14，与 SDK 0.6.0 一致
- 示例插件 ntfy-notifier / webhook-on-event 改用 httpx2
- openai / anthropic / google-genai 下限改为实际需要的大版本
- 插件 MCP 工具的 input_schema 无效时计入熔断
- 复制 RSS 链接在 HTTP 部署下回退到 execCommand（useClipboard legacy）
- CI 步骤名、PLAYWRIGHT_VERSION、README 徽章与 e2e 指南改为 Python 3.14 / Playwright 1.64.1

2026-10-20 12:12:58 +02:00

3.7 KiB

Raw Permalink Blame History

E2E テストガイド

エンドツーエンドテストは、本番ビルドの AutoBangumi イメージを、ローカルの決定的な上流サービス（モックの RSS、TMDB、プレーヤー、qBittorrent）に対して実行します。テストは公開サービスにアクセスしません。Docker Compose はループバックアドレスにランダムなポートを公開し、サービス同士は内部ネットワークで通信します。

完全な説明（各テストレーン、診断用の成果物、モックシナリオの追加、qBittorrent イメージのダイジェスト更新）はリポジトリの e2e/README.md にあります。このページでは、ローカルで実行する最短の手順だけを示します。

準備

Docker Engine と Compose v2
Python 3.14 と uv
Node.js 20 と pnpm 9.11

uv sync --directory backend --locked --group dev
pnpm --dir webui install --frozen-lockfile
pnpm --dir webui exec playwright install --with-deps chromium webkit firefox

テストイメージのビルド

pnpm --dir webui run build
python3 e2e/scripts/build_test_image.py \
  --version 3.3.999-e2e.1 \
  --image auto-bangumi:e2e \
  --dist webui/dist

ビルドスクリプトは、WebUI のビルド成果物と生成したバージョンモジュールを一時的な Docker コンテキストに置きます。ソースツリーには書き込みません。

実行

実行のたびに新しいプロジェクト名と作業ディレクトリを使います。作業ディレクトリを使い回すとセットアップ状態も使い回すことになり、初回起動のテストが意味を失います。

export LANE=runtime
export AB_E2E_PROJECT="ab-e2e-local-$LANE-$$"
export AB_E2E_WORK_DIR="$(mktemp -d "${TMPDIR:-/tmp}/ab-e2e-$LANE.XXXXXX")"
export AB_E2E_APP_IMAGE=auto-bangumi:e2e

# ランタイムの API とプロセスのテスト
python3 e2e/scripts/stack.py run \
  --profile browser \
  --project-name "$AB_E2E_PROJECT" \
  --work-dir "$AB_E2E_WORK_DIR" \
  -- uv run --directory backend pytest src/test/e2e/runtime -m e2e -q

レーン	`--` の後のコマンド	`--profile`
ランタイム	`uv run --directory backend pytest src/test/e2e/runtime -m e2e -q`	`browser`
Chromium デスクトップ	`pnpm --dir webui run test:e2e:chromium --retries=0`	`browser`
WebKit モバイル	`pnpm --dir webui run test:e2e:webkit --retries=0`	`browser`
実際の qBittorrent とパッケージ済みイメージ	`python3 e2e/scripts/run_downloader_lane.py`	`downloader`

通常の pytest は E2E テストを飛ばします。-m e2e を明示する必要があります。
stack.py run は Compose を片付ける前に診断情報を集め、$AB_E2E_WORK_DIR/artifacts に書き出します。Playwright のスクリーンショットと動画は webui/test-results、HTML レポートは webui/playwright-report にあります。
スタックを止めるには：python3 e2e/scripts/stack.py stop --profile browser --project-name "$AB_E2E_PROJECT" --work-dir "$AB_E2E_WORK_DIR"。

CI

.github/workflows/e2e.yml は PR ごとに、ランタイムのレーン、ブラウザのレーン（Chromium、WebKit モバイル）、実際のダウンローダーのレーンを実行します。e2e-nightly.yml は毎晩 Firefox のレーンを実行し、ブラウザのレーンとダウンローダーのレーンをそれぞれ独立して 2 回実行します。エンドポイントの構造や検証など、より速い契約テストは backend/src/test/test_api_*.py にあります。

3.7 KiB Raw Permalink Blame History Unescape Escape

E2E テストガイド

準備

テストイメージのビルド

実行

CI

3.7 KiB

Raw Permalink Blame History