ШІ перекладає BDO · контроль лишається у вас
bdo-ua-ai-localization · набір інструментів для перекладу рядків Black Desert українською. Відкриєте проєкт у OpenCode і скажете звичайною мовою, що перекласти; диригент сам веде пʼятьох субагентів на локальних моделях і детерміновані перевірки між ними.
- Безкоштовно й відкрито Код під MIT, репозиторій публічний
- Локальні моделі GGUF через Ollama · платне лише за бажанням
- Перевірки до запису Розмітка, identity і русизми · механічно
Чому якість не залежить від чесності моделі
Пʼять вузьких субагентів
Worker перекладає пачку, QA дає вердикт на кожен рядок, repair виправляє лише названі дефекти, terminology веде глосарій, smoke перевіряє маршрутизацію. Жодному інструментів не дозволені · це умова коректності схеми.
Механічні перевірки якості
Перед записом кожен рядок проходить перевірку identity, розмітки, placeholders, меж довжини, словника русизмів і латинських гомогліфів у кирилиці. Гарантії тримає код, а не інструкція в промпті.
Половина пачки · без моделі
Памʼять перекладів і глосарій закривають частину рядків ще до виклику LLM: точний збіг оригіналу береться з уже перекладених рядків безкоштовно й миттєво.
Формат прибитий схемою
Відповідь субагента тримає JSON-схема: вона не може загубити, здублювати чи вигадати ідентифікатор рядка, а плагін-гард відхиляє запит до витрати токенів, якщо маршрут неправильний.
Платне · лише за згодою
За замовчуванням працюють локальні моделі. Платний маршрут вмикається явним `paid` у профілі й ніколи не активується приховано; policy не пропускає прихованого платного fallback.
Прозорість за замовчуванням
`./bdo audit` читає базу OpenCode й показує реальні провайдера, модель, токени та виклики кожної сесії. Самозвіт моделі джерелом правди не рахується · диригент уже помилявся.
Уся робота · у чаті OpenCode
Показати на весь екран
Локальні · безкоштовні хмарні · платні за бажанням
Локальні · дефолт
GGUF-моделі через Ollama живуть на вашій машині. Для 35B-A3B потрібно близько 22 ГБ вільної памʼяті; після завантаження прогони безкоштовні.
Безкоштовні хмарні
MiMo V2.5 Free, Big Pickle, Muse Spark · перевірені на фактичних прогонах власника. Безплатний маршрут задається профілем `./bdo profile`.
Платні · за бажанням
Рекомендовано GPT-5.6 Luna з reasoning effort low або medium · найкращий баланс для диригента. Диригент не перекладає, тому сильніша модель йому не потрібна.
Перелік моделей · рекомендації за фактичними прогонами, а не гарантія доступності: провайдер може змінювати назви й ліміти. Актуальний список завжди в README репозиторію.
Чотири кроки до першої пачки
Встановіть набір
Клонуйте репозиторій, створіть .env із ключем Agent API сайту, виконайте ./bdo models --apply, щоб оголосити модель провайдеру OpenCode.
Перевірте середовище
./bdo gate full проходить усі детерміновані перевірки без жодного токена. Останній доказ · @translation-smoke у чаті: один рядок відповіді означає, що маршрутизація жива.
Скажіть, що перекласти
«Переклади весь активний патч» або «переклади 15 рядків». Диригент сам порахує пачки по 15 рядків, покличе субагентів і запише результат через Agent API.
Отримайте результат
Кожен рядок пройшов QA, repair і серверні гейки перед записом. ./bdo audit покаже, що субагенти робили насправді.
Як це працює · на скрінах
Знімки з репозиторію тулкіта. Гайд поповнюється разом із README · гортайте слайдер, під кожним пояснення.
Показати на весь екран
Диригента кличуть звичайною мовою: «переклади весь активний патч».
Показати на весь екран
Фактична модель залежить від TRANSLATE_MODEL_PROFILE і може відрізнятися.
Вимоги до середовища
OpenCode
OpenCode · безкоштовний агентний чат, у якому живуть диригент, плагін і всі субагенти. Без нього тулкіт не працює: саме в його чаті ви звичайною мовою просите перекласти патч.
Модель диригента потрібна середнього рівня: диригент не перекладає · він читає вироки перевірок і веде субагентів. Платна GPT-5.6 Luna з effort low або medium · перевірений баланс, але підійде й безкоштовна.
Ollama
Субагенти перекладають на локальних GGUF-моделях через Ollama. Рекомендована модель: qwen3.6:35b-a3b-mtp-q4_K_M · сторінка в бібліотеці Ollama. Для неї потрібно близько 22 ГБ вільної памʼяті.
MLX-моделі не підходять: їхній runner мовчки ігнорує обмеження формату, і перевірки пачки перестають діяти.
Agent API key
Ключ видає адмін проєкту на сторінці вашого користувача · самостійно згенерувати його не можна. Що ключ уміє · теж вирішує адмін: дозволи шарів запису, ліміт запитів і денну квоту рядків.
Квота скидається о київській півночі; поновити її поза графіком може лише адмін. Запитати ключ і дізнатися квоту можна в Telegram проєкту.
Bash, PHP CLI 8.3+, jq, curl, ShellCheck, Node
Це звичайні консольні інструменти, і ставити їх вручну не треба. Відкрийте склонований репозиторій у OpenCode й вставте готовий промпт нижче: агент сам перевірить систему, встановить усе необхідне й пройде перевірки тулкіта одним запитом.
Налаштувати рантайм можна самостійно агентом або звернутися по допомогу до адміна проєкту · він може так само підготувати й покращити середовище, зокрема для Windows.
Промпт · Linux і macOS
Прочитай README цього репозиторію і підготуй середовище для перекладу: перевір та встанови PHP CLI 8.3+, jq, curl, ShellCheck і Node, переконайся, що Ollama встановлена й модель qwen3.6:35b-a3b-mtp-q4_K_M завантажена, виконай кроки розділу «Встановлення» і заверши командою ./bdo gate full. Повідомляй про кожен крок.
через WSL2
На Windows тулкіт працює через WSL2 · тим самим Bash/PHP flow, без окремої копії на PowerShell. Використовуйте промпт для WSL2 нижче.
Windows-шлях ще тестується: баги можливі, виправлення вносяться в міру виявлення. Якщо щось не працює · напишіть адміну, це допоможе швидше це виправити.
Промпт · Windows (WSL2)
Прочитай README і docs/WINDOWS_WSL2.md цього репозиторію та підготуй середовище в WSL2: встанови необхідні пакети (PHP CLI 8.3+, jq, curl, ShellCheck, Node), Ollama з моделлю qwen3.6:35b-a3b-mtp-q4_K_M, виконай кроки встановлення і заверши перевіркою ./bdo gate full. Повідомляй про кожен крок.
Наскільки проєкт відкритий і прозорий? ›
Код опублікований під ліцензією MIT, репозиторій публічний. Ключі живуть лише в локальному .env, який Git ігнорує; pre-commit хук перевіряє застейджений вміст на типові патерни секретів.
Повний процес перекладу задокументований крок за кроком, виміри, інциденти та рішення власника ведуться відкрито в docs/FLOW_STATE.md. Прямий curl до API заборонений: штатний шлях один, і його видно.
Подивіться, як ШІ перекладає під вашим контролем
Тулкіт безкоштовний, код відкритий, а запис перекладів іде через офіційний Agent API цього сайту · тими самими шлюзами, що й ручна робота перекладачів.