Снимки реального расширения на китайском, японском, корейском и английском с оригинальным комиксом проекта. Формы показывают настройку, а не успешное подключение. Здесь используются английские снимки.
Прежде чем начать
NodeLane Comics обрабатывает чтение в вашем браузере; manga-translator-ui (MTU) обрабатывает изображения. Вашему собственному каналу MTU не требуется учетная запись NodeLane и не используются официальные разрешения на перевод. Расходы на оборудование, модели и сторонние API остаются за вами.
Вам потребуется последняя версия расширения для настольного браузера, установленная служба MTU с ее зависимостями, а также имя пользователя и пароль этой службы. В этом руководстве используется http://127.0.0.1:8000 на том же компьютере, что и браузер. Используйте свой фактический порт, если он отличается.
1. Запустите веб-службу MTU.
Расширению требуется веб-служба HTTP. Открытия только окна рабочего стола MTU недостаточно. После установки MTU запустите эту команду в каталоге проекта и продолжайте работу службы. Пропустите эту команду, если вы уже запускаете веб-службу через Docker или другим способом.
В этом примере не включена обработка графического процессора. Добавляйте --use-gpu только после настройки поддерживаемой среды графического процессора, как описано выше. Требования к модели, драйверу и оборудованию зависят от вашей версии MTU.
uv run --no-sync python -m manga_translator web --host 127.0.0.1 --port 80002. Сначала переведите тестовое изображение в MTU.
Откройте http://127.0.0.1:8000 в своем браузере, завершите настройку учетной записи MTU и войдите в систему. Если требуется первоначальная смена пароля, завершите это в MTU перед подключением расширения. Это учетные данные MTU, независимые от вашей учетной записи NodeLane.
Настройте транслятор, модели и все необходимые ключи API на сервере, затем убедитесь, что тестовое изображение создает переведенное изображение. Расширение устанавливает целевой язык и использует настройки сервера по умолчанию для других настроек перевода. Убедитесь, что веб-служба использует предполагаемые значения по умолчанию. Не вводите ключ модели API в поле пароля расширения.
3. Добавьте канал перевода в расширение.

Откройте настройки расширения и найдите Каналы перевода. После успешного подключения расширение сохраняет пароль и токен службы локально на этом компьютере. При повторном подключении с тем же адресом службы и именем пользователя оставьте поле пароля пустым, чтобы использовать сохраненный пароль. Введите его заново, если изменился адрес или имя пользователя, а также если пароль был изменен или стал недействительным. Для старых профилей, в которых сохранен только токен, нужно один раз ввести пароль при первом повторном подключении. Метки ниже описывают соответствующие элементы управления на вашем языке интерфейса. Сохранение пароля и повторное подключение с пустым полем поддерживаются в расширении 0.10.2 и новее; в более ранних версиях пароль нужно вводить при каждом повторном подключении.
- Выберите «Добавить канал перевода» и подтвердите manga-translator-ui в качестве службы. При желании дайте ему узнаваемое имя, например «Мой компьютер».
- Введите http://127.0.0.1:8000 в качестве адреса службы. Используйте корень службы без /auth/login, /translate/with-form/image или пути к странице администрирования.
- Введите имя пользователя и пароль MTU, затем выберите «Подключиться и использовать». Подключение не запрашивает отдельного разрешения для сайта; если доступ ограничен, восстановите доступ ко всем сайтам в настройках расширения и повторите попытку.
- Убедитесь, что на текущем канале отображается новая услуга. Вы можете сохранить несколько профилей услуг, но одновременно будет использоваться только выбранный канал.
4. Прочитайте свою первую переведенную страницу

Импортируйте локальный комикс, откройте EPUB, OPDS или поддерживаемый сайт. Выберите целевой язык и включите перевод. Текущая версия расширения использует перевод как для официального канала, так и для MTU.
Приоритет имеют текущие и ближайшие изображения в ограниченном окне; на одном канале MTU изображения запускаются по одному. Новые комиксы открываются в оригинале, автоперевод по умолчанию выключен. Сравнивайте результаты без потери позиции; читалка и перевод на странице используют выбранный канал.
Если на странице произошел сбой, устраните проблему, о которой сообщили, прежде чем повторять попытку вручную. Закрытие страницы или потеря соединения не доказывают, что MTU прекратил работу. Избегайте повторных отправок, пока служба все еще может быть занята.
Устранение неполадок с подключением, входом в систему и длительным ожиданием
Проверьте сам MTU, прежде чем повторять попытку расширения. Не сообщайте пароли, токены или личные файлы комиксов при сообщении о проблеме.
| Симптом | Что проверить |
|---|---|
| Адрес сервиса не открывается | Убедитесь, что веб-служба запущена и указан правильный порт. 127.0.0.1 означает компьютер, на котором установлен браузер; другому устройству нужен собственный доступный адрес. |
| Страница открывается, но расширение не может подключиться | Проверьте корневой адрес, разрешение на доступ к браузеру и наличие в вашей версии MTU совместимых конечных точек входа в учетную запись и перевода изображений. |
| Требуется неверные учетные данные или первоначальная смена пароля. | Войдите в систему MTU или измените там первоначальный пароль, а затем снова подключитесь. Используйте учетные данные MTU, а не пароль NodeLane или ключ модели API. |
| Предыдущее соединение теперь сообщает об истечении срока входа в систему. | В настройках канала выберите «Переподключиться». Если адрес службы и имя пользователя остались прежними, оставьте поле пароля пустым, чтобы использовать сохраненный пароль. Введите его заново, если изменился адрес или имя пользователя, пароль был изменен или стал недействительным либо в старом профиле сохранен только токен. Расширение не отправляет предыдущий перевод автоматически. Сохранение пароля и повторное подключение с пустым полем поддерживаются в расширении 0.10.2 и новее; в более ранних версиях пароль нужно вводить при каждом повторном подключении. |
| Подключено, но перевод продолжает ждать | Проверьте загрузку моделей, загрузку движка, очереди, баланс API и аппаратные ресурсы. Проверьте ту же конфигурацию в MTU. Подключение только подтверждает вход. |
| Прервано, истекло время ожидания или возвращено что-то кроме изображения | Проверьте задачу MTU, время ожидания прокси-сервера и ответ. Повторите попытку страницы со сбоем вручную после устранения причины. Расширение не восстанавливает результаты автоматически из истории MTU. |
Кэш, использование в автономном режиме и куда отправляются изображения
Результаты локального канала кэшируются в локальном хранилище этого браузера. Очистка кэша или установка нулевого бюджета кэша переведенных изображений и закрытие страниц, на которых все еще есть результаты, могут их удалить. Отсутствующие результаты требуют повторного перевода вручную; расширение не может получить их обратно из MTU.
Изображения отправляются в выбранный сервис MTU. Локальный запуск MTU не гарантирует автономный перевод: онлайн-переводчики, OCR или модели изображений могут отправлять текст или изображения своим поставщикам. Для автономной генерации требуются доступные оригиналы, загруженные модели и конвейер без онлайн-зависимостей.