BookTrans CLI
BookTrans переводит книгу целиком за один запуск: разведка, перевод с общим контекстом, правка, сноски и сборка в epub или fb2.
- 55 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Конвейер отправляет текст книги в модель и может потратить много токенов, а чужой файл способен нести инструкции для модели.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/booktransОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Конвейер отправляет текст книги в модель и может потратить много токенов, а чужой файл способен нести инструкции для модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
BookTrans — консольный конвейер, который берет книгу в epub, fb2, html, pdf, md или txt и выдает готовый перевод в epub, fb2, html, md, txt, LaTeX или pdf. Команда `booktrans book.epub --to ru` сначала просматривает книгу: находит голоса рассказчиков, имена, термины и смену сюжета. Затем переводит кусками с общей терминологией и сводкой сюжета, правит текст без оригинала и сверяет его с оригиналом. Сноски добавляются без тихих поправок автора, стихи, ссылки, таблицы и иллюстрации сохраняются, а единицы измерения пересчитываются. Конвейер отбрасывает обрезанные ответы, повторяет запрос или меняет модель, продолжает прерванную работу после повторного запуска и показывает расходы. Работает через Claude Code по умолчанию, а также через Codex, Antigravity или API.
Для кого. Читателям и издателям, которым нужен черновик перевода целой книги или рукописи, и они готовы вычитать результат сами.
Подходит, если
- Нужно перевести роман так, чтобы имена и термины не расходились между главами.
- Книга в fb2 или epub должна вернуться в том же формате с сохраненными сносками и ссылками.
- Перевод длинной серии надо держать в одном стиле, повторно используя решения из прошлых книг.
- Работу прерывали лимиты запросов, и ее надо продолжить без повторных трат.
Не подходит, если
- Требуется работа профессионального переводчика: автор прямо оговаривает, что инструмент его не заменяет.
- Книга защищена DRM: зашифрованные epub программа отклоняет.
- Источник файла вызывает сомнения: в тексте могут скрываться инструкции для модели.
Пример запроса к агенту
Переведи book.epub на русский через booktrans, держи имена героев едиными и верни результат в fb2.Ограничения
Установка командой `uv tool install booktrans` или `pipx install booktrans`, затем проверка `booktrans --check`: она показывает недостающие зависимости и ничего не ставит. Нужны Python 3.9 или новее и настроенный бэкенд модели, то есть консольный агент или API. Это машинный перевод, который может исказить смысл, и проверка результата остается за вами. Вы отвечаете за права на текст и за расходы на запросы. Агент запускается без инструментов, но полной защиты от инъекций в тексте книги нет.
Как отключить. Удалите программу командой `uv tool uninstall booktrans` или `pipx uninstall booktrans`. Рабочие папки `*.work` рядом с книгами удаляются вручную.
Частые вопросы
Какие форматы поддерживаются?
На входе epub, fb2, html, pdf, md и txt. На выходе epub, fb2, html, md, txt, LaTeX и pdf. Формат выбирается расширением флага `-o`.
Что делать при обрыве работы?
Запустите ту же команду заново: конвейер возобновит работу с места остановки и подождет окончания лимитов запросов.
Какие модели можно использовать?
По умолчанию Claude Code, есть профили для Codex и Antigravity (`./bt_agy`), а также доступ через API. Выбор моделей остается за вами.
Как переводить серию книг?
Передайте флаг `--like` для каждой прошлой рабочей папки в порядке чтения: принятые ранее имена имеют приоритет над новыми.
Безопасно ли переводить чужие книги?
Разведка сообщает, если в тексте есть инструкции для модели, и останавливает перевод. Агент работает без оболочки, файлов и сети.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл для перевода целых книг в форматах PDF, DOCX и EPUB на любой язык с помощью параллельных субагентов
Плагин для Claude Code переводит целую книгу в EPUB или TXT на 12 языков и сохраняет двуязычную версию рядом.
Навык для Claude Code и Codex: из одной строки темы собирает электронную книгу в PDF с обложкой, оглавлением и выходными данными.
Конвейер переводит PDF и EPUB учебников в markdown, ищет по ним и пишет заметки Obsidian с цитатами и рисунками из книг.
Два скилла для Claude Code и Codex: агент переводит научные статьи в библиотеке EasyRead и отвечает на заметки на полях
Скилл переводит PDF научной статьи в новый PDF, где каждая страница совпадает с оригиналом, с формулами в LaTeX.
Коротко о README
Объясняет, зачем нужен конвейер, как запустить перевод, какие агенты поддерживаются, что делает каждая стадия, форматы вывода, меры против инъекций и ограничения метода.