Dokumentatsioon

Paigaldamine

Paigalda dragoman oma brauseri poest ja see uueneb sealt edaspidi ise.

Chrome Web Store Windows, Mac ja Linux Microsoft Edge Add-ons Windows, Mac ja Linux

Chrome, Edge, Helium ja teised Chromiumi brauserid

Paigalda väljalase käsitsi

Iga väljalase on ka GitHubis – zip-failid Chromiumi-põhistele brauseritele ja Firefoxile ning kogu lähtekood. Käsitsi laaditud versioonid ei uuenda end ise.

1 Laadi uusimast väljalaskest alla Chrome'i zip-fail ja paki see lahti.
2 Ava helium://extensions või teistes brauserites chrome://extensions ja lülita sisse Arendaja režiim.
3 Vali Laadi lahtipakitud ja vali lahtipakitud kaust.

Ava uusim väljalase

Kinnita dragoman tööriistaribale, et see oleks ühe klõpsu kaugusel.

Androidi Chrome ei toeta laiendusi. Androidis kasuta Firefoxi.

Ava mis tahes veebisait, klõpsa dragomani ikoonil, vali keel ja seejärel Tõlgi leht. Sama teeb klaviatuuril Alt+Shift+T või Macis Option+Shift+T. Mustandid ilmuvad punktiirse kuldse allajoonega, mis kaob, kui mudel iga lõigu viimistleb.

AltShiftT / ⌥⇧T Tõlgi leht või näita originaali

Kuidas tõlgitud leht välja näeb

Mustand sinu seadmes: Mochi on praegu edutatud peatoimetajaks.
Viimistleb sinu valitud mudel: Vahepeal on Mochi peatoimetajaks edutatud.
Originaal on ühe osutuse kaugusel: Hoia kursorit mis tahes lõigul, et näha, mis seal varem kirjas oli. Üks klõps märgil või Alt+Shift+T taastab kogu lehe.

Telefonis või tahvelarvutis ava dragoman brauseri laienduste menüüst.

Võrdlus brauseri tõlkijaga

Chrome, Edge, Safari ja Firefox oskavad lehti ise tõlkida ning kiireks pilguheiduks sellest sageli piisab. dragoman on mõeldud siis, kui tahad lehte päriselt lugeda: see tabab nii tähenduse kui ka sõnastuse ning sina otsustad, kes teksti näeb.

See loeb kogu lehte

Sisseehitatud tõlkijad käivad lehe läbi väikeste tükkidena, igaüks eraldi, nii et sama sõna võib paari rea kaugusel tulla välja kahel eri moel. dragoman näitab sinu AI-mudelile lehe pealkirja, alapealkirju ja korduvaid fraase, nii et nimi, silt või termin jääb algusest lõpuni ühesuguseks.

Tükkhaaval

Περίοδος: Term
Περίοδος: Period
Περίοδος: Tenure
Περίοδος: Term

Kogu lehte silmas pidades

Περίοδος: Term
Περίοδος: Term
Περίοδος: Term
Περίοδος: Term

Näide: üks kreekakeelne silt, mis kordub infokastis, tõlgituna inglise keelde.

Sina otsustad, kuhu tekst läheb

Kui Chrome või Edge lehte tõlgib, saadab see teksti Google'ile või Microsoftile. dragoman teeb mustandi sinu seadmes ja saadab sinu valitud teenusepakkujale sinu enda võtmega ainult selle, mida loed. Jäta kõik seadmesse ja lehe tekst ei lahku üldse.

Kuhu lehe tekst liigub

Chrome Google Edge Microsoft

dragoman Sinu seade Sinu AI-teenuse pakkuja ainult see, mida loed, kui lisad mudeli

Tõlkija valid sina: Chrome tõlgib lehti Google Translate'iga ja Edge Microsoft Translatoriga. dragoman kasutab sinu valitud AI-mudelit, olgu see Claude, Gemini, ChatGPT taga olevad mudelid või sinu enda arvutis töötav mudel. Tänapäeva AI-mudelid saavad üldiselt paremini hakkama idioomide, tooni ja sõnadega, mille tähendus sõltub lausest.
Originaal on alati käepärast: Hoia kursorit mis tahes lõigu kohal või puuduta seda telefonis, et lugeda, mis seal enne oli, ilma kogu lehte tagasi vahetamata.

Brauseri tõlkija on sisseehitatud, tasuta ega vaja seadistamist. Ka dragomani seadmesisesed mustandid on tasuta ja viimistlus maksab vaid nii palju, kui teenusepakkuja loetud teksti eest küsib – väikese mudeliga tavaliselt väga vähe. Firefoxi enda tõlkija kasutab Bergamoti, sama mootorit, millega dragoman Firefoxis mustandeid teeb, nii et seal on erinevuseks AI-viimistlus ja lehe kontekst.

Kapoti all

Kaks käiku: Sinu brauseri seadmesisene mudel teeb mustandi taustal ning kus seda pole, aitab WebAssemblyks kompileeritud Bergamot. Seejärel lähevad ekraanil olevad ja kohe järgnevad lõigud väikeste kogumitena sinu mudelile ning iga viimistletud lõik asendab oma mustandi.
Lehe kontekst: Iga päring sisaldab lehe pealkirja, alapealkirjade liigendust, lehel korduvaid fraase koos nende esmakordse esinemise ümbrusega ning kõiki seni kokku lepitud tõlkeid. Mudel tagastab valitud terminid ja hilisemad päringud peavad neist kinni.
Märgistus: Lingid, rõhutused ja muud tekstisisesed elemendid liiguvad nummerdatud kohatäidetena, nii et paigutus ja lingid jäävad terveks.
Ainult see, mida loed: Viimistlus järgib vaatevälja, nii et pika lehe puhul maksad ainult läbi keritud osa eest. Valmis tõlked salvestatakse sinu seadmesse ja neid kasutatakse uuesti, kui tagasi tuled.
Vahendajateta: Päringud lähevad sinu võtmega otse brauserist teenusepakkujale. dragomanil pole serverit ja kogu kood on avalik.

Seadmesisene tõlge

Iga leht algab sinu seadmes. dragoman teeb mustandi Chrome'i ja Edge'i sisseehitatud seadmesisese mudeliga ning Safaris Apple'i omaga. Need töötavad sinu arvutis, erinevalt brauserite enda lehetõlkest, mis käib veebi kaudu. Mujal ja keelte puhul, mida need ei toeta, teeb mustandi sinu brauseris Bergamot, avatud mootor Firefox Translations taga. Ükski neist ei vaja kontot ega võtit. Üksi annab see kiire ja privaatse tõlke. AI-mudeliga saab neist mustanditest esimene versioon, mida sinu mudel lihvib.

Ühekordne allalaadimine iga keelepaari kohta

inglise → türgi 15 MB
inglise → saksa 26 MB
prantsuse → inglise 26 MB
jaapani → inglise 49 MB

prantsuse → inglise → saksa

52 MB

Kahe keele vahel pole otsemudelit? dragoman tõlgib inglise keele kaudu ja laadib alla mõlemad pooled.

Allalaadimiste suurused Mozilla mudeliregistri järgi.

Keeled: Üle 50 keele, inglise keelest ja inglise keelde. Kahe muu keele vahel tõlgib dragoman inglise keele kaudu. Keelte loendis vajavad märgisega Ainult AI keeled AI-mudelit.
Esimene kasutus: Chrome ja Edge laadivad keelepaketid alla siis, kui neid esimest korda vajad, ning Safari kasutab Apple'i tõlke jaoks sinu seadmesse laaditud keeli. Bergamoti keelepaarid laaditakse üks kord alla Mozillalt, tavaliselt 15–50 MB, ja need jäävad sinu brauserisse. Pärast seda töötab kõik ka võrguühenduseta.
Mustandid ja viimistlus: Mustandid on kiired ja üsna sõnasõnalised – sisust arusaamiseks piisab. Sinu mudel kirjutab need ümber, nähes kogu lehte, nii et tekst kõlab loomulikult ning nimed ja terminid püsivad ühtsed.
Sinu valik: Kui soovid lehte oma seadmes hoida ka siis, kui mudel on seadistatud, lülita hüpikaknas sisse Ainult selles seadmes. Kui tahad mustandid vahele jätta ja oma mudelit oodata, lülita seadetes välja Tee mustand kõigepealt selles seadmes.

Bergamot sündis Euroopa Liidu rahastatud uurimisprojektist ning Mozilla treenib ja avaldab selle keelemudeleid. Bergamotist lähemalt

Lisa AI-mudel

Ava hüpikaknast Seaded, vali teenusepakkuja ja järgi kolme sammu. dragoman kontrollib võtit kohe pärast kleepimist ja valib eelnevalt kiire ning soodsa mudeli, mida saad igal ajal muuta.

Kasutatavad teenusepakkujad

Anthropic
OpenAI
Google Gemini
OpenRouter
Mistral
DeepSeek
Groq
xAI
Ollama
LM Studio
Iga OpenAI-ühilduv server

OpenRouter saab sulle võtme luua. Vali Ühenda OpenRouteriga ja kinnita päring.

Anthropic võtmed, mis pole tööruumiga seotud, vajavad ka tööruumi ID-d. Leiad selle Anthropic Console'is jaotisest Settings, seejärel Workspaces.

Kasuta kohalikku mudelit

Paigalda Ollama, laadi alla mudel, näiteks gemma3, ja käivita see määratud OLLAMA_ORIGINS-iga, et see laienduse päringuid vastu võtaks:

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

Laadi LM Studios mudel, lülita serveri seadetes sisse CORS ja käivita kohalik server. dragoman leiab selle aadressilt localhost:1234.

Mis see maksab

dragoman on tasuta. Viimistlus kasutab sinu enda võtit, nii et teenusepakkuja esitab arve otse sulle. Tõlkimiseks piisab tavaliselt väikestest ja kiiretest mudelitest. Seadete vahekaart Kasutus loeb iga kuu tokeneid mudelite kaupa ning valik „Näita iga lehe hinda“ kuvab praeguse lehe hinna märgi kõrval.

Viimistletud 4 lõiku 14-st

Viimistletud
Mustand
Veel mitte

Kerimise ajal saavad eesootavad lõigud kiire mustandi ja ekraanil olevad viimistletakse. Ülejäänud leht ei maksa midagi enne, kui sinna jõuad.

Privaatsus

Mis sinu arvutist lahkub: ekraanil olevad ja kohe järgnevad lõigud ning tekst, mille tõlkimist kaaslaselt palud – need saadetakse sinu valitud teenusepakkujale – ja keelte puhul, mida brauser ise tõlkida ei oska, ühekordne mudeli allalaadimine Mozillalt. Sinu võti saadetakse alati ainult oma teenusepakkujale. dragomanil pole serverit, kontot ega analüütikat.

Loe kogu privaatsuspoliitikat

Tõrkeotsing

Hüpikaken ütleb, et lehte ei saa tõlkida

Brauseri lehed, nagu seaded, laienduste leht ja veebipoed, ei luba laiendustel neid muuta. Ava selle asemel tavaline veebisait.

Seadmesisesel mootoril pole selle keelepaari jaoks mudelit

Seadmesisesed tõlkijad katavad enim kasutatud keeled. Safaris saad lisada keeli seadme keele- ja piirkonnaseadetes jaotises Tõlkekeeled. Ülejäänud keelte jaoks lisa AI-mudel ja dragoman tõlgib otse sellega.

Ka brauser pakub lehe tõlkimist

dragoman palub brauseril lehtedel, mida see võiks tõlkida, eemale hoida. Kui lülitasid selle välja, lülita seadetes jaotises Keeled sisse „Hoia brauseri tõlkija eemal”. Kui brauser on lehe juba tõlkinud, vali „Kasuta hoopis dragomani”, et laadida leht uuesti originaalkeeles.

Kohalik mudel ei ühendu

Kontrolli, et server töötab ja selle aadress seadetes on õige. Ollama vajab OLLAMA_ORIGINS-i ja LM Studio sisselülitatud CORS-i.

dragoman ei saa lehte lugeda

Safaris ja Firefoxis saad valida, milliseid veebisaite laiendus lugeda tohib. Ava dragoman ja vali „Luba kõigil veebisaitidel”.

Firefox ei viimistle minu mudeliga

Firefox küsib luba, enne kui laiendus lehe teksti kuhugi saadab. Ava Seaded ja vali oma mudeli all „Luba lehe teksti saatmine”.

Ehita lähtekoodist

dragoman on avatud lähtekoodiga MIT litsentsi all. Ehitamiseks on vaja Node 24 ja pnpm-i.

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

Igal brauseril on oma versioon. Käivita need kaustas extension/:

Chromiumi-põhised brauserid pnpm build → .output/chrome-mv3

Firefox pnpm build:firefox → .output/firefox-mv3

Safari pnpm build:safari → .output/safari-mv3 Seejärel ehita Xcode'is safari/dragoman.xcodeproj.

Hoidla on pnpm-i tööruum:

extension/: Laiendus, ehitatud WXT ja Svelte'iga
site/: See veebisait, ehitatud SvelteKitiga
brand/: Dragomanid, logo ja linn
messages/: Liidese tekst 85 keeles

Loe kaasaaitamise juhendit Sirvi lähtekoodi