Skip to content

README_RU.md

Latest commit

 

History

History
236 lines (181 loc) · 26.4 KB

README_RU.md

File metadata and controls

236 lines (181 loc) · 26.4 KB
Raw

Spinning fox animation

BallonsTranslator

Еще один инструмент для компьютерного перевода комиксов/манги на основе глубокого обучения.

简体中文 | English | Русский | 日本語 | Español | Français | pt-BR | 한국어 | Indonesia | Tiếng Việt

Telegram Forum   |   QQ Группа: 719881337

Особенности

Important

Если вы публично делитесь переведенным результатом, и опытный переводчик-человек не участвовал в тщательном переводе или проверке, пожалуйста, отметьте его как машинный перевод в заметном месте. Если на нормальном русском. Если вы не способны сделать минимальную проверку качества, перед публикацией, или вы не умеете в тайп, то укажите в описании к загражуемой манге, что это "машинный" перевод. Большинство русских сервисов тупо забанит вам аккаунт после попытки залива "машинного" перевода. Уделите хоть каплю внимания редактуре.

  • Полностью автоматизированный перевод

    • Поддерживает автоматическое обнаружение текста, распознавание, удаление и перевод. Общая производительность зависит от этих модулей.
    • Верстка основана на оценке форматирования оригинального текста.
    • Хорошо работает с мангой и комиксами.
    • Улучшенная верстка манга->английский, английский->китайский (на основе выделения областей баллонов).

  • Редактирование изображений

    • Поддерживает редактирование масок и ретушь (что-то вроде инструмента точечного восстановления в Photoshop)
    • Адаптирован для изображений с экстремальным соотношением сторон, таких как веб-комиксы

  • Редактирование текста

  • Контекстный LLM-перевод и глоссарии

    История переводов

    • Установите LLM Context в +history, чтобы показать LLMTranslator примеры с завершённых предыдущих страниц. Это помогает сохранить единообразие имён, терминов и тона. Продолжение и выбранные диапазоны также могут использовать подходящие более ранние страницы.
    • Token budget определяет объём предыдущего переведённого текста, отдавая приоритет новым страницам. Для текущей страницы, инструкций, глоссария и ответа нужно дополнительное место. Значение по умолчанию — 4096.
    • Больший бюджет даёт больше контекста сюжета и реже удаляет старые страницы, но отправляет больше текста и может работать медленнее. Локальным моделям также может потребоваться значительно больше RAM/VRAM. Значение 4096 по умолчанию намеренно консервативно; популярные провайдеры с большим контекстным окном, такие как DeepSeek, часто допускают более высокий лимит. Разумный верхний предел — около 70% окна модели (90000 для 128K).
    • Бюджет истории также влияет на кэширование промптов. Пока история растёт в пределах бюджета, последовательные запросы сохраняют одинаковое начало, которое такие провайдеры, как OpenAI и DeepSeek, могут повторно использовать по сниженной цене входных токенов и иногда с меньшей задержкой. Когда бюджет вынуждает удалить старые страницы, это начало меняется и повторное использование кэша сбрасывается. Больший бюджет уменьшает число сбросов, но отправляет больше истории, поэтому не гарантирует меньшую общую стоимость.

    В таблице ниже приведена приблизительная оценка для страниц манги при использовании DeepSeek, где кэшированные входные токены стоят 10% от цены обычных входных токенов. Фактический результат зависит от проекта, модели и провайдера.

    Token budget Оценка сохраняемой истории (страницы) Оценка общей стоимости относительно режима без истории
    2048 3–4 1.65×
    4096 6–9 1.79×
    8192 12–19 2.10×
    16384 23–38 2.66×

    Переиспользуемые глоссарии

    • Укажите Glossary File в окне запуска. Поддерживаются UTF-8-файлы .json, .txt и .tsv; они доступны только для чтения и могут использоваться в разных проектах.

    • Matching отправляет только термины, встречающиеся на соответствующей странице. All отправляет все записи и может заметно увеличить расход токенов.

    • Поддерживаемые форматы:

      # Формат Sakura
исходный_термин->перевод # необязательное примечание

# Текст с разделением табуляцией
исходный_термин<TAB>перевод<TAB>необязательное примечание

      [
  {"src": "исходный термин", "dst": "перевод", "info": "необязательное примечание"}
]

    • Сопоставление выполняется буквально и без учёта регистра. Конфликтующие записи, неверный формат, неподдерживаемое расширение или отсутствующий файл останавливают перевод до отправки запроса LLM.

    • Контекст предыдущих страниц и глоссарий используются только LLMTranslator; другие переводчики игнорируют эти настройки.

Установка

На Windows

Способ А (Автоматическая настройка локального окружения в один клик, требуется PowerShell): Скрипт установит BallonsTranslator в каталог, из которого вы его запустите:

irm https://raw.githubusercontent.com/dmMaze/BallonsTranslator/dev/scripts/install.ps1 | iex

Или выполните следующую команду в классической командной строке (cmd.exe):

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/dmMaze/BallonsTranslator/dev/scripts/install.ps1 | iex"

Способ Б (Загрузка готовой портативной сборки): Скачайте Ballonstranslator_win_minium.zip со страницы GitHub Releases, распакуйте его и запустите launch_win.bat.

Эти способы не поддерживают Windows 7; пользователям Windows 7 необходимо вручную установить Python 3.8 и запускать приложение из исходного кода.

Если появляются ошибки, связанные с msvcp140.dll, c10.dll или [WinError 1114], установите или обновите Microsoft Visual C++ Redistributable x64 (Visual Studio 2015-2022; официальное руководство).

macOS / Linux

Скрипт установит BallonsTranslator в каталог, из которого вы его запустите:

curl -fLO https://raw.githubusercontent.com/dmMaze/BallonsTranslator/dev/scripts/install.sh && chmod +x install.sh && ./install.sh

Если curl недоступен, вы можете использовать wget -O .... Программа запустится автоматически после установки; для последующих запусков используйте cd BallonsTranslator && ./launch.sh.

При запуске приложение проверяет основные зависимости. Когда вы выбираете модуль, которому нужны дополнительные библиотеки, приложение предложит установить отсутствующие опциональные зависимости (автоустановку также можно включить в настройках).

Использование

Рекомендуется запускать программу в терминале на случай, если она аварийно завершится и не оставит никакой информации, см. следующий gif.

  • При первом запуске приложения, пожалуйста, выберите переводчик и установите исходный и целевой языки, нажав на значок настроек.
  • Откройте папку, содержащую изображения комикса (манги/маньхуа/манхвы), которые нуждаются в переводе, нажав на значок папки.
  • Нажмите кнопку Run и дождитесь завершения процесса.

Форматы шрифта, такие как размер и цвет, определяются программой автоматически в этом процессе. Вы можете предопределить эти форматы, изменив соответствующие опции с "decide by program" на "use global setting" в панели конфигурации->Typesetting. (глобальные настройки - это те форматы, которые отображаются на правой панели форматирования шрифта, когда вы не редактируете ни один текстовый блок на сцене)

Редактирование изображений

Инструмент ретуши

Режим редактирования изображения, инструмент ретуши

Инструмент прямоугольника

Инструмент прямоугольника

Чтобы 'стереть' нежелательные результаты ретуши, используйте инструмент ретуши или инструмент прямоугольника с нажатой правой кнопкой мыши.
Результат зависит от того, насколько точно алгоритм ("метод 1" и "метод 2" на gif) извлекает маску текста. Он может работать хуже на сложном тексте и фоне.

Редактирование текста

Режим редактирования текста

Пакетное форматирование текста и автоматическая компоновка

OCR и перевод выбранной области

Горячие клавиши

  • A/D или pageUp/Down для перелистывания страниц
  • Ctrl+Z, Ctrl+Shift+Z для отмены/повтора большинства операций. (обратите внимание, что стек отмены будет очищен после перелистывания страницы)
  • T для режима редактирования текста (или кнопка "T" на нижней панели инструментов).
  • W для активации режима создания текстового блока, затем перетащите мышь по холсту с нажатой правой кнопкой, чтобы добавить новый текстовый блок. (см. gif редактирования текста)
  • P для режима редактирования изображения.
  • В режиме редактирования изображения используйте ползунок в правом нижнем углу для управления прозрачностью исходного изображения.
  • Отключите или включите любые автоматические модули через строку заголовка->run, запуск со всеми отключенными модулями пересоздаст и перерисует весь текст в соответствии с соответствующими настройками.
  • Установите параметры автоматических модулей на панели конфигурации.
  • Ctrl++/Ctrl+- (Также Ctrl+Shift+=) для изменения размера изображения.
  • Ctrl+G/Ctrl+F для глобального поиска/поиска на текущей странице.
  • 0-9 для настройки прозрачности текстового слоя
  • Для редактирования текста: жирный - Ctrl+B, подчеркнутый - Ctrl+U, курсив - Ctrl+I
  • Установите тень текста и прозрачность на панели стиля текста -> Effect.
  • Alt+Стрелки или Alt+WASD (pageDown или pageUp в режиме редактирования текста) для переключения между текстовыми блоками.

Режим без графического интерфейса (Запуск без GUI)

python launch.py --headless --exec_dirs "[DIR_1],[DIR_2]..."

Обратите внимание, что конфигурация (исходный язык, целевой язык, модель ретуши и т.д.) будет загружена из config/config.json.
Если отрисованный размер шрифта неправильный, укажите логическое DPI вручную через --ldpi , типичные значения - 96 и 72.

Модули автоматизации

Этот проект сильно зависит от manga-image-translator, онлайн-сервис и обучение моделей недешевы, пожалуйста, рассмотрите возможность пожертвования проекту:

Sugoi translator создан mingshiba.

Обнаружение текста

  • Поддерживает обнаружение английского и японского текста, код обучения и подробности можно найти в comic-text-detector

  • Поддерживает использование обнаружения текста из Starriver Cloud (Tuanzi Manga OCR). Необходимо заполнить имя пользователя и пароль, автоматический вход будет выполняться при каждом запуске программы.

OCR

  • Все модели mit* взяты из manga-image-translator, поддерживают распознавание английского, японского и корейского языков и извлечение цвета текста.
  • manga_ocr от kha-white, распознавание текста для японского языка, с основным фокусом на японской манге.
  • Поддерживает использование OCR из Starriver Cloud (Tuanzi Manga OCR). Необходимо заполнить имя пользователя и пароль, автоматический вход будет выполняться при каждом запуске программы.
    • Текущая реализация использует OCR для каждого текстового блока отдельно, что приводит к более медленной скорости и не дает значительного улучшения точности. Это не рекомендуется. При необходимости используйте вместо этого Tuanzi Detector.
    • При использовании Tuanzi Detector для обнаружения текста рекомендуется установить OCR в none_ocr для прямого чтения текста, экономя время и уменьшая количество запросов.
    • Для подробных инструкций см. Инструкции по использованию Tuanzi OCR: (только на китайском и бразильском португальском)

Ретушь

Переводчики

Доступные переводчики: Google, DeepL, ChatGPT, Sugoi, Caiyun, Baidu. Papago и Yandex.

  • Google закрыл сервис перевода в Китае, пожалуйста, установите соответствующий 'url' в панели конфигурации на *.com.
  • Caiyun, ChatGPT, Yandex, Baidu и DeepL переводчики требуют токен или API-ключ.
  • DeepL & Sugoi переводчик (и его преобразование CT2 Translation) благодаря Snowad14.
  • Sugoi переводит с японского на английский полностью оффлайн. Скачайте оффлайн модель, переместите "sugoi_translator" в BallonsTranslator/ballontranslator/data/models.
  • Sakura-13B-Galgame, отметьте low vram mode в панели конфигурации, если вы запускаете его локально на одном устройстве и столкнулись с сбоем из-за нехватки vram (включено по умолчанию).
  • DeepLX: Пожалуйста, обратитесь к Vercel или deeplx
  • Добавлена библиотека Translators которая поддерживает доступ к некоторым сервисам переводчиков без api ключей. О поддерживаемых сервисах можете узнать тут.

Для других хороших оффлайн английских переводчиков, пожалуйста, обратитесь к этой ветке обсуждения.
Чтобы добавить новый переводчик, пожалуйста, обратитесь к how_to_add_new_translator, это просто как создание подкласса BaseClass и реализация двух интерфейсов, затем вы можете использовать его в приложении, вы можете внести свой вклад в проект.

FAQ и прочее

  • Если ваш компьютер имеет GPU NVIDIA или Apple Silicon, программа включит аппаратное ускорение.
  • Добавлена поддержка saladict (Универсальный профессиональный всплывающий словарь и переводчик страниц) в мини-меню при выделении текста. Руководство по установке
  • Ускорение производительности, если у вас есть устройство NVIDIA's CUDA или AMD's ROCm, так как большинство модулей использует PyTorch.
  • Шрифты берутся из системных шрифтов вашей системы.
  • Благодарность bropines за русскую локализацию.
  • Добавлен экспорт в скрипт JSX для Photoshop от bropines.
    Чтобы прочитать инструкции, улучшить код и просто покопаться, чтобы увидеть, как это работает, вы можете перейти в scripts/export to photoshop -> install_manual.md.