Перайсці да змесціва

Дакументацыя

Усё, што трэба, каб усталяваць dragoman, падключыць мадэль і падтрымліваць працу.

Усталяванне

Усталюйце dragoman з крамы свайго браўзера, і ён будзе абнаўляцца адтуль сам.

Chrome, Edge, Helium і іншыя браўзеры на Chromium
Усталяваць выпуск уручную

Кожны выпуск ёсць і на GitHub: zip-архівы для браўзераў на Chromium і Firefox, а таксама поўны зыходны код. Зборкі, усталяваныя ўручную, не абнаўляюцца самі.

  1. 1 Спампуйце zip для Chrome з апошняга выпуску і распакуйце яго.
  2. 2 Адкрыйце helium://extensions (або chrome://extensions у іншых браўзерах) і ўключыце «Рэжым распрацоўшчыка».
  3. 3 Націсніце «Загрузіць распакаванае» і выберыце распакаваную папку.
Адкрыць апошні выпуск

Замацуйце dragoman на панэлі інструментаў, каб ён быў пад рукой.

Chrome для Android не падтрымлівае пашырэнні. На Android карыстайцеся Firefox.

Перакладзіце першую старонку

Адкрыйце любы сайт, націсніце значок dragoman, выберыце мову і націсніце «Перакласці старонку». Alt+Shift+T (або Option+Shift+T на Mac) робіць тое ж з клавіятуры. Чарнавікі маюць пункцірнае залатое падкрэсліванне, якое знікае, калі мадэль удакладняе абзац.

AltShiftT / ⌥⇧T Перакласці старонку або паказаць арыгінал

Як выглядае перакладзеная старонка

Чарнавік на вашай прыладзе
Мочы ў цяперашні час павышаны да рэдактара ў галоўных.
Удакладненне выбранай мадэллю
З таго часу Мочы павысілі да галоўнага рэдактара.
Арыгінал — пад курсорам
Навядзіце курсор на любы абзац, каб убачыць, што там было. Адзін клік па значку або Alt+Shift+T вяртае ўсю старонку.

На тэлефоне ці планшэце адкрыйце dragoman з меню пашырэнняў браўзера.

У параўнанні з перакладчыкам браўзера

Chrome, Edge, Safari і Firefox умеюць перакладаць старонкі самі, і каб хутка зірнуць, гэтага часта дастаткова. dragoman — для тых выпадкаў, калі старонку хочацца сапраўды прачытаць: ён перадае і сэнс, і словы, а вы вырашаеце, хто ўбачыць тэкст.

Ён чытае ўсю старонку

Убудаваныя перакладчыкі апрацоўваюць старонку дробнымі кавалкамі, кожны асобна, таму адно і тое ж слова праз некалькі радкоў можа перакласціся па-рознаму. dragoman паказвае вашай ШІ-мадэлі назву старонкі, яе загалоўкі і фразы, што паўтараюцца, таму імя, надпіс ці тэрмін маюць адзін пераклад ад пачатку да канца.

Па кавалачку

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Period
Περίοδος
1928–1932
Tenure
Περίοδος
1933
Term

З усёй старонкай перад вачыма

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Прыклад: адзін грэчаскі подпіс, што паўтараецца ў інфаблоку, перакладзены на англійскую.

Вы вырашаеце, куды ідзе тэкст

Калі Chrome ці Edge перакладае старонку, ён адпраўляе тэкст у Google ці Microsoft. dragoman робіць чарнавік на вашай прыладзе, а потым адпраўляе выбранаму пастаўшчыку толькі тое, што вы чытаеце, з вашым уласным ключом. Пакіньце ўсё на прыладзе — і ніводнае слова старонкі нікуды не пойдзе.

Куды ідзе тэкст старонкі

Chrome Google Edge Microsoft dragoman Ваша прылада Ваш ШІ-правайдар толькі тое, што вы чытаеце, калі дадалі мадэль
Перакладчыка выбіраеце вы
Chrome перакладае старонкі праз Google Translate, а Edge — праз Microsoft Translator. dragoman працуе з выбранай вамі ШІ-мадэллю: Claude, Gemini, мадэлямі ChatGPT або той, што працуе на вашым камп’ютары. Сучасныя ШІ-мадэлі звычайна лепш спраўляюцца з ідыёмамі, тонам і словамі, сэнс якіх залежыць ад сказа.
Арыгінал заўсёды побач
Навядзіце курсор на любы абзац або націсніце на яго на тэлефоне, каб прачытаць, што там было, не вяртаючы ўсю старонку назад.

Перакладчык браўзера ўбудаваны, бясплатны і не патрабуе наладкі. Лакальныя чарнавікі dragoman таксама бясплатныя, а ўдакладненне каштуе толькі тое, што бярэ ваш пастаўшчык за прачытаны тэкст, — з невялікай мадэллю звычайна вельмі мала. Уласны перакладчык Firefox працуе на Bergamot, тым жа рухавіку, якім dragoman робіць чарнавікі ў Firefox, таму там розніца — у праходзе ШІ і ўліку кантэксту старонкі.

Як гэта працуе
Два этапы
Мадэль браўзера на прыладзе робіць чарнавік у фоне, а дзе яе няма, дапамагае Bergamot, скампіляваны ў WebAssembly. Потым абзацы на экране і крыху ніжэй невялікімі порцыямі ідуць да вашай мадэлі, і кожны ўдакладнены абзац замяняе свой чарнавік.
Кантэкст старонкі
Кожны запыт змяшчае назву старонкі, структуру яе загалоўкаў, фразы, што паўтараюцца на старонцы, з тэкстам вакол іх першага з’яўлення, і ўсе ўжо замацаваныя пераклады. Мадэль вяртае выбраныя тэрміны, і наступныя запыты іх трымаюцца.
Разметка
Спасылкі, вылучэнні і іншыя ўбудаваныя элементы перадаюцца як нумараваныя запаўняльнікі, таму макет і спасылкі вяртаюцца непашкоджанымі.
Толькі тое, што вы чытаеце
Удакладненне ідзе за бачнай часткай экрана, таму за доўгую старонку вы плаціце толькі за тое, што прагарнулі. Гатовыя пераклады захоўваюцца на прыладзе і выкарыстоўваюцца зноў, калі вы вернецеся.
Без пасярэднікаў
Запыты ідуць проста з вашага браўзера да пастаўшчыка з вашым ключом. Сервера dragoman няма, а ўвесь код адкрыты.

Пераклад на прыладзе

Кожная старонка пачынаецца на вашай прыладзе. dragoman робіць чарнавік з дапамогай мадэлі, убудаванай у Chrome і Edge, і мадэлі Apple у Safari. Яны працуюць на вашым камп’ютары, у адрозненне ад уласнага перакладу старонак у браўзерах, які ідзе праз інтэрнэт. Усюды астатняе, а таксама для моў, якіх яны не падтрымліваюць, чарнавік робіць у браўзеры Bergamot — адкрыты рухавік Firefox Translations. Ні акаўнт, ні ключ для гэтага не патрэбныя. Сам па сабе ён дае хуткі і прыватны пераклад. З ШІ-мадэллю гэтыя чарнавікі становяцца першым варыянтам, які ваша мадэль шліфуе.

Адна загрузка на кожную пару моў

  • англійская → турэцкая 15 МБ
  • англійская → нямецкая 26 МБ
  • французская → англійская 26 МБ
  • японская → англійская 49 МБ

французская → англійская → нямецкая

52 МБ

Няма прамой мадэлі паміж дзвюма мовамі? dragoman перакладае праз англійскую і загружае абедзве паловы.

Памеры загрузак паводле рэестра мадэляў Mozilla.
Мовы
Больш за 50 моў з англійскай і на англійскую. Паміж дзвюма іншымі мовамі dragoman перакладае праз англійскую. У спісе моў тым, што пазначаны Толькі ШІ, патрэбна ШІ-мадэль.
Першае выкарыстанне
Chrome і Edge спампоўваюць моўныя пакеты, калі яны ўпершыню спатрэбяцца, а Safari выкарыстоўвае мовы, спампаваныя для перакладу Apple на вашай прыладзе. Моўныя пары Bergamot адзін раз спампоўваюцца з Mozilla, звычайна 15–50 МБ, і застаюцца ў браўзеры. Пасля гэтага ўсё працуе без інтэрнэту.
Чарнавікі і ўдакладненне
Чарнавікі хуткія і даволі літаральныя — якраз каб зразумець сэнс. Ваша мадэль перапісвае іх, бачачы ўсю старонку, таму тэкст гучыць натуральна, а імёны і тэрміны застаюцца аднолькавымі.
Выбар за вамі
Каб пакінуць старонку на прыладзе нават з наладжанай мадэллю, уключыце Толькі на гэтай прыладзе ва ўсплывальным акне. Каб прапусціць чарнавікі і пачакаць на мадэль, выключыце Спачатку чарнавік на гэтай прыладзе у наладах.

Bergamot вырас з даследчага праекта, які фінансаваў Еўрапейскі саюз, а Mozilla навучае і публікуе моўныя мадэлі, з якімі ён працуе. Пра Bergamot

Дадайце ШІ-мадэль

Адкрыйце «Налады» з усплывальнага акна, выберыце пастаўшчыка і выканайце тры крокі. dragoman правярае ключ адразу пасля ўстаўкі і загадзя выбірае хуткую недарагую мадэль, якую можна змяніць у любы час.

Даступныя пастаўшчыкі

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Любы сервер, сумяшчальны з OpenAI

OpenRouter можа стварыць ключ за вас. Націсніце «Падключыцца праз OpenRouter» і пацвердзіце запыт.

Для ключоў Anthropic без прывязкі да працоўнай прасторы патрэбны таксама ID прасторы. Яго можна знайсці ў Anthropic Console: «Налады» → «Працоўныя прасторы».

Лакальная мадэль

Усталюйце Ollama, загрузіце мадэль, напрыклад gemma3, і запусціце яго з OLLAMA_ORIGINS, каб ён прымаў запыты ад пашырэння:

OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*,safari-web-extension://*" ollama serve

У LM Studio загрузіце мадэль, уключыце CORS у наладах сервера і запусціце лакальны сервер. dragoman знойдзе яго на localhost:1234.

Колькі гэта каштуе

dragoman бясплатны. Удакладненне працуе на вашым уласным ключы, таму пастаўшчык выстаўляе рахунак вам напрамую. Для перакладу звычайна хапае невялікіх хуткіх мадэляў. Укладка «Выкарыстанне» ў наладах штомесяц лічыць токены па кожнай мадэлі, а калі ўключыць «Паказваць кошт кожнай старонкі», кошт бягучай старонкі з’явіцца побач са значком.

Удакладнена 4 з 14 абзацаў

  • Удакладнена
  • Чарнавік
  • Яшчэ не

Пакуль вы гартаеце, абзацы крыху ніжэй атрымліваюць хуткі чарнавік, а тыя, што на экране, удакладняюцца. Астатняя частка старонкі нічога не каштуе, пакуль вы да яе не дойдзеце.

Прыватнасць

Што пакідае ваш камп’ютар: абзацы на экране і крыху ніжэй, а таксама тэкст, які вы просіце перакласці свайго памочніка, — яны адпраўляюцца выбранаму вамі пастаўшчыку; і для моў, якія браўзер не можа перакласці сам, — аднаразовая загрузка мадэлі з Mozilla. Ваш ключ адпраўляецца толькі яго пастаўшчыку. У dragoman няма ні сервера, ні акаўнта, ні аналітыкі.

Прачытаць палітыку прыватнасці цалкам

Вырашэнне праблем

Акно паведамляе, што старонку нельга перакласці

Старонкі браўзера — налады, старонка пашырэнняў, крамы — не дазваляюць пашырэнням іх змяняць. Адкрыйце звычайны сайт.

Лакальны рухавік не мае мадэлі для гэтай пары

Лакальныя перакладчыкі ахопліваюць найбольш распаўсюджаныя мовы. У Safari можна дадаць іншыя ў раздзеле «Мовы перакладу» ў наладах «Мова і рэгіён» вашай прылады. Для астатніх дадайце ШІ-мадэль, і dragoman будзе перакладаць непасрэдна ёю.

Браўзер таксама прапануе перакласці старонку

dragoman просіць браўзер не ўмешвацца на старонках, якія той мог бы перакласці. Калі вы гэта адключылі, уключыце «Не даваць перакладчыку браўзера ўмешвацца» ў наладах, у раздзеле «Мовы». Калі браўзер ужо пераклаў старонку, выберыце «Выкарыстаць dragoman», каб перазагрузіць яе ў арыгінале.

Лакальная мадэль не падключаецца

Праверце, што сервер працуе і яго адрас у наладах супадае. Ollama патрабуе OLLAMA_ORIGINS, а ў LM Studio трэба ўключыць CORS.

dragoman не можа прачытаць старонку

Safari і Firefox дазваляюць выбраць, якія сайты можа чытаць пашырэнне. Адкрыйце dragoman і выберыце «Дазволіць на ўсіх сайтах».

Firefox не ўдакладняе пераклад маёй мадэллю

Firefox пытаецца, перш чым пашырэнне куды-небудзь адправіць тэкст старонкі. Адкрыйце «Налады» і пад сваёй мадэллю выберыце «Дазволіць адпраўку тэксту старонкі».

Зборка з зыходнага кода

dragoman — праграма з адкрытым кодам пад ліцэнзіяй MIT. Для зборкі патрэбны Node 24 і pnpm.

git clone https://github.com/firatciftci/dragoman.git
cd dragoman
pnpm install
pnpm dev:extension

Для кожнага браўзера свая зборка. Запускайце гэта з extension/:

Браўзеры на Chromium pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Затым збярыце safari/dragoman.xcodeproj у Xcode.

Рэпазіторый — гэта працоўная прастора pnpm:

extension/
Пашырэнне на WXT і Svelte
site/
Гэты сайт на SvelteKit
brand/
Драгаманы, лагатып і горад
messages/
Тэксты інтэрфейсу на 85 мовах