# Anime4K WebExtension

[中文](./README.md) | [English](./README.en.md) | [日本語](./README.ja.md) | Русский

[![Edge Store Users](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fmicrosoftedge.microsoft.com%2Faddons%2Fgetproductdetailsbycrxid%2Fffopffngebibpmeodlhhkdlaejnmdlam&query=%24.activeInstallCount&style=flat-square&label=%D0%9F%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D0%B8%20Edge)](https://microsoftedge.microsoft.com/addons/detail/anime4k-webextension/ffopffngebibpmeodlhhkdlaejnmdlam) [![Chrome Web Store Users](https://img.shields.io/chrome-web-store/users/hpmbccepehpoanjpjkamfdpdkbmfmhek?style=flat-square&label=%D0%9F%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D0%B8%20Chrome)](https://chromewebstore.google.com/detail/anime4k-webextension/hpmbccepehpoanjpjkamfdpdkbmfmhek) [![Mozilla Add-on Users](https://img.shields.io/amo/users/anime4k-webextension?style=flat-square&label=%D0%9F%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D0%B8%20Firefox)](https://addons.mozilla.org/firefox/addon/anime4k-webextension/) [![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/chenmozhijin/Anime4K-WebExtension/total?style=flat-square&label=%D0%97%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B8%20%D1%81%20GitHub)](https://github.com/chenmozhijin/Anime4K-WebExtension/releases/latest)

Значительно улучшите качество изображения аниме-видео с помощью алгоритма супер-разрешения Anime4K в реальном времени, обеспечивая более четкое и резкое визуальное восприятие кадр за кадром!

## Возможности

- 🚀 **WebGPU Супер-разрешение в реальном времени:** Использование передовой технологии WebGPU для обеспечения низкой задержки и высокой производительности масштабирования видео прямо в браузере.
- ⚡ **Несколько уровней производительности:** Предоставляет четыре предустановленных режима: Быстро/Сбалансированно/Качество/Ультра, а также поддерживает пользовательские режимы для гибкого баланса между улучшением качества изображения и нагрузкой на оборудование.
- 📊 **Оценка производительности оборудования:** Встроенный тест производительности GPU порекомендует наиболее подходящий уровень супер-разрешения для вашего оборудования.
- 📏 **Гибкий контроль разрешения:** Поддержка масштабирования в 2x/4x/8x раз, а также возможность фиксировать целевое разрешение, например, 2K/4K, для удовлетворения различных потребностей просмотра.
- ✨ **Улучшение в один клик:** Фиолетовая кнопка «✨ Улучшить» автоматически появляется в видеоплеере, позволяя мгновенно улучшить качество изображения.
- 🛡️ **Широкая совместимость:** Поддержка Shadow DOM, iframe и кросс-доменных источников видео, преодолевая технические ограничения и охватывая подавляющее большинство видеосайтов.
- 📋 **Механизм включения по требованию:** Поддержка точной стратегии белого списка, работающей только на указанных сайтах, чтобы избежать траты ресурсов и помех на странице.
- 🌈 **Современный дизайн UI:** Следование рекомендациям Material Design, адаптация к Светлой/Тёмной/Системной темам для комфортного визуального восприятия.
- 🌐 **Поддержка интернационализации:** Поддержка нескольких языков, включая китайский, английский, японский и русский, для пользователей по всему миру.

> [!WARNING]
> Это расширение не работает на тех сайтах (например, Netflix), где присутствует DRM или Encrypted Media Extensions (EME) защита.

## Руководство пользователя

### Установка расширения

#### Из магазина приложений (рекомендуется)

- [![GitHub Release](https://img.shields.io/github/v/release/chenmozhijin/Anime4K-WebExtension?style=flat-square&label=%D0%9F%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BD%D1%8F%D1%8F%20%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D1%8F)](https://github.com/chenmozhijin/Anime4K-WebExtension/releases/latest)
- [![Edge Store Version](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fmicrosoftedge.microsoft.com%2Faddons%2Fgetproductdetailsbycrxid%2Fffopffngebibpmeodlhhkdlaejnmdlam&query=%24.version&style=flat-square&label=%D0%9C%D0%B0%D0%B3%D0%B0%D0%B7%D0%B8%D0%BD%20Edge)](https://microsoftedge.microsoft.com/addons/detail/anime4k-webextension/ffopffngebibpmeodlhhkdlaejnmdlam)
- [![Chrome Web Store Version](https://img.shields.io/chrome-web-store/v/hpmbccepehpoanjpjkamfdpdkbmfmhek?style=flat-square&label=%D0%9C%D0%B0%D0%B3%D0%B0%D0%B7%D0%B8%D0%BD%20Chrome)](https://chromewebstore.google.com/detail/anime4k-webextension/hpmbccepehpoanjpjkamfdpdkbmfmhek)
- [![Mozilla Add-on Version](https://img.shields.io/amo/v/anime4k-webextension?style=flat-square&label=%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F%20Firefox)](https://addons.mozilla.org/firefox/addon/anime4k-webextension/)

> [!NOTE]
>
> 1. Нажмите на значки выше, чтобы перейти на страницу магазина.
> 2. Из-за процесса проверки версия в магазине может быть не самой последней. Для получения последней версии используйте готовый пакет или соберите из исходного кода.

#### Использование готового пакета

1. Откройте [GitHub Releases](https://github.com/chenmozhijin/Anime4K-WebExtension/releases/latest)
2. В пункте "Assets" нажмите на `anime4k-webextension.zip`
3. Распакуйте загруженный архив в любое удобное место
4. Установите распакованный архив расширения:
   - Chrome: Откройте страницу расширений (`chrome://extensions`) → включите "Режим разработчика" → "Загрузить распакованное расширение" → выберите папку с распакованным архивом
   - Edge: Откройте страницу расширений (`edge://extensions`) → включите "Режим разработчика" → "Загрузить распакованное" → выберите папку с распакованным архивом

#### Установка из исходного кода

1. Клонируйте этот репозиторий (`git clone https://github.com/chenmozhijin/Anime4K-WebExtension`)
2. Введите `npm install` для установки зависимостей
3. Введите `npm run build` для сборки расширения
4. Установите собранное вами расширение:
   - Chrome: Откройте страницу расширений (`chrome://extensions`) → включите "Режим разработчика" → "Загрузить распакованное расширение" → выберите папку `dist` в директории проекта
   - Edge: Откройте страницу расширений (`edge://extensions`) → включите "Режим разработчика" → "Загрузить распакованное" → выберите папку `dist` в директории проекта

### I. Первоначальная настройка (Onboarding)

После установки расширения автоматически откроется страница настройки. Для достижения наилучшего результата следуйте инструкциям:

1.  **Тест производительности GPU**: Расширение запустит короткий тест (Цель: 1080p -> 4K 24fps) для оценки производительности вашей видеокарты.
2.  **Рекомендуемый уровень**: На основе результатов расширение автоматически порекомендует подходящий уровень производительности (Performance Tier):
    *   🚀 **Быстро**: Для встроенной графики или старых устройств, приоритет плавности.
    *   ⚖️ **Сбалансированно**: Баланс качества и производительности, подходит для большинства средних устройств.
    *   🎨 **Качество**: Лучшая детализация, подходит для дискретных видеокарт.
    *   🔬 **Ультра**: Максимальное качество, требуется мощная видеокарта.
3.  **Применить**: Вы можете принять рекомендацию или выбрать другой уровень вручную.

### II. Повседневное использование

1.  **Включение улучшения**: Воспроизведите видео на поддерживаемом сайте. Слева появится фиолетовая кнопка **«✨ Улучшить»**.
2.  **Переключение**: Нажмите кнопку для включения. Статус кнопки изменится с «⏳ Загрузка...» на «❌ Остановить».
3.  **Автоскрытие**: Кнопка скрывается автоматически, когда курсор убирается с видео.

### III. Настройки во всплывающей панели

Нажмите значок расширения Anime4K на панели инструментов браузера:

*   **Уровень производительности (Performance Tier)**: Быстрое переключение между 4 предустановками.
    *   *Примечание: Если выбран «Пользовательский режим» (Custom Mode), этот параметр недоступен, так как режим определяется комбинацией шейдеров.*
*   **Режим улучшения (Enhancement Mode)**:
    *   **Встроенные (Built-in)**: Классические пресеты Anime4K (Mode A, B, C).
    *   **Пользовательские (Custom)**: Созданные или импортированные вами режимы.
*   **Разрешение (Resolution)**: Целевое разрешение (x2 или фиксированное 1080p/4K).
*   **Белый список (Whitelist)**:
    *   Быстрое добавление текущей страницы/домена.
    *   Глобальное включение/отключение.

### IV. Расширенные настройки

Нажмите кнопку **«Настройки»** (Settings) внизу панели:

#### 1. Общие настройки (General)
*   **Внешний вид**: Светлая/Темная тема.
*   **Совместимость**: Включите **«Режим совместимости Cross-Origin»**, если видео не улучшается из-за политик безопасности браузера.

#### 2. Настройки производительности (Performance)
*   **Тест GPU**: Перезапуск теста производительности.
*   **Текущий уровень**: Просмотр активной конфигурации.

#### 3. Режимы улучшения (Enhancement Modes)
*   **Редактор**: Создание новых режимов.
*   **Сортировка**: Перетаскивание шейдеров или режимов.
*   **Обмен**: Импорт/Экспорт конфигураций (JSON).

#### 4. Управление белым списком (Whitelist)
*   **Правила**: Просмотр, редактирование и удаление правил.
*   **Подстановочные знаки**: Поддержка `*` (например, `*.bilibili.com/*`).

## Благодарности

- [bloc97/Anime4K](https://github.com/bloc97/Anime4K)
- [Anime4K-WebGPU](https://github.com/Anime4KWebBoost/Anime4K-WebGPU)