Kalo te përmbajtja

Dokumentacioni

Gjithçka që të duhet për të instaluar dragoman, për të lidhur një model dhe për ta mbajtur në punë.

Instalimi

Instalo dragoman nga dyqani i shfletuesit tënd dhe ai do të përditësohet vetë prej andej.

Chrome, Edge, Helium dhe shfletues të tjerë Chromium
Instalo një version me dorë

Çdo version gjendet edhe në GitHub, me skedarë zip për shfletuesit Chromium dhe Firefox, si dhe kodin burimor të plotë. Versionet e ngarkuara me dorë nuk përditësohen vetë.

  1. 1 Shkarko zip-in për Chrome nga versioni më i fundit dhe çngjeshe.
  2. 2 Hap helium://extensions, ose chrome://extensions në shfletues të tjerë, dhe aktivizo Modalitetin e zhvilluesit.
  3. 3 Zgjidh Ngarko të shpaketuarin dhe përzgjidh dosjen e çngjeshur.
Hap versionin më të fundit

Fikso dragoman në shiritin e veglave, që të jetë një klikim larg.

Chrome për Android nuk i mbështet shtesat. Në Android, përdor Firefox.

Përkthe faqen tënde të parë

Hap çdo sajt, kliko ikonën e dragoman, zgjidh një gjuhë dhe zgjidh Përkthe faqen. Alt+Shift+T, ose Option+Shift+T në Mac, bën të njëjtën gjë nga tastiera. Përkthimet paraprake shfaqen me një nënvizim të artë me pika, që zhduket ndërsa modeli yt përmirëson çdo paragraf.

AltShiftT / ⌥⇧T Përkthe faqen ose shfaq origjinalin

Si duket një faqe e përkthyer

Përkthyer paraprakisht në pajisjen tënde
Mochi është aktualisht promovuar në redaktor në shef.
Përmirësuar nga modeli që zgjedh
Që atëherë, Mochi është ngritur në detyrë si kryeredaktore.
Origjinali është një lëvizje miu larg
Mbaj treguesin mbi çdo paragraf për të lexuar çfarë thoshte më parë. Një klikim te distinktivi, ose Alt+Shift+T, e rikthen gjithë faqen.

Në telefon ose tablet, hap dragoman nga menyja e shtesave të shfletuesit.

Krahasuar me përkthyesin e shfletuesit

Chrome, Edge, Safari dhe Firefox mund t'i përkthejnë faqet vetë, dhe për një vështrim të shpejtë kjo shpesh mjafton. dragoman është për kur do ta lexosh vërtet një faqe: e kap saktë kuptimin dhe fjalët, dhe ti vendos kush e sheh tekstin.

E lexon gjithë faqen

Përkthyesit e integruar e përpunojnë faqen në copa të vogla, secilën më vete, ndaj e njëjta fjalë mund të dalë ndryshe me pak rreshta largësi. dragoman i tregon modelit tënd IA titullin e faqes, titujt e seksioneve dhe frazat që përsëriten, që një emër, etiketë apo term të ruajë të njëjtin përkthim nga fillimi në fund.

Copë-copë

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

Me gjithë faqen para syve

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Një ilustrim: një etiketë greke, e përsëritur përgjatë një kutie informacioni, e përkthyer në anglisht.

Ti vendos ku shkon teksti

Kur Chrome ose Edge përkthen një faqe, e dërgon tekstin te Google ose Microsoft. dragoman përkthen paraprakisht në pajisjen tënde, pastaj dërgon vetëm atë që po lexon te ofruesi që zgjodhe, me çelësin tënd. Mbaje në pajisje dhe asnjë tekst i faqes nuk largohet fare.

Ku shkon teksti i faqes

Chrome Google Edge Microsoft dragoman Pajisja jote Ofruesi yt i IA-së vetëm ajo që lexon, nëse shton një model
Ti zgjedh përkthyesin
Chrome i përkthen faqet me Google Translate, ndërsa Edge me Microsoft Translator. dragoman punon me modelin IA që zgjedh ti, qoftë Claude, Gemini, modelet pas ChatGPT apo një model që punon në kompjuterin tënd. Modelet e sotme IA zakonisht ia dalin më mirë me shprehjet idiomatike, tonin dhe fjalët kuptimi i të cilave varet nga fjalia.
Origjinali mbetet pranë
Kalo miun mbi çdo paragraf, ose prekje në telefon, për të lexuar çfarë thoshte më parë, pa e kthyer gjithë faqen mbrapsht.

Përkthyesi i shfletuesit tënd është i integruar, falas dhe nuk kërkon konfigurim. Përkthimet paraprake të dragoman në pajisje janë gjithashtu falas, ndërsa përmirësimi kushton vetëm aq sa të faturon ofruesi për tekstin që lexon, zakonisht shumë pak me një model të vogël. Përkthyesi i vetë Firefox përdor Bergamot, të njëjtin motor me të cilin dragoman përkthen paraprakisht në Firefox, ndaj atje ndryshimin e bëjnë kalimi me IA dhe konteksti i faqes.

Si funksionon
Dy kalime
Modeli në pajisje i shfletuesit tënd përkthen paraprakisht në sfond, ndërsa Bergamot, i kompiluar në WebAssembly, plotëson aty ku ai mungon. Paragrafët në ekran dhe ata pak më poshtë shkojnë pastaj te modeli yt në grupe të vogla dhe çdo paragraf i përmirësuar zë vendin e versionit paraprak.
Konteksti i faqes
Çdo kërkesë mbart titullin e faqes, një skicë të titujve, frazat që përsëriten në faqe me tekstin rreth shfaqjes së tyre të parë, si dhe çdo përkthim të vendosur deri tani. Modeli kthen termat që zgjodhi dhe kërkesat e mëvonshme u përmbahen atyre.
Markup-i
Lidhjet, theksimet dhe elementet e tjera brenda tekstit udhëtojnë si vendmbajtës të numëruar, ndaj faqosja dhe lidhjet kthehen të paprekura.
Vetëm ajo që lexon
Përmirësimi ndjek pjesën e dukshme të ekranit, ndaj një faqe e gjatë kushton vetëm pjesën që shfleton. Përkthimet e përfunduara ruhen në pajisjen tënde dhe ripërdoren kur kthehesh.
Pa ndërmjetës
Kërkesat shkojnë drejt nga shfletuesi yt te ofruesi, me çelësin tënd. Nuk ka server të dragoman, dhe çdo rresht kodi është publik.

Përkthimi në pajisje

Çdo faqe nis në pajisjen tënde. dragoman përkthen paraprakisht me modelin në pajisje të integruar në Chrome dhe Edge, si dhe me atë të Apple në Safari. Këta punojnë në kompjuterin tënd, ndryshe nga përkthimi i faqeve i vetë shfletuesve, që kalon në internet. Kudo tjetër, dhe për çdo gjuhë që ata nuk mbulojnë, Bergamot, motori i hapur pas Firefox Translations, përkthen brenda shfletuesit tënd. Asgjë nga këto nuk kërkon llogari apo çelës. Më vete, merr një përkthim të shpejtë dhe privat. Me një model IA, këto përkthime bëhen një version i parë që modeli yt e lëmon.

Shkarkim një herë për çdo çift gjuhësh

  • anglisht → turqisht 15 MB
  • anglisht → gjermanisht 26 MB
  • frëngjisht → anglisht 26 MB
  • japonisht → anglisht 49 MB

frëngjisht → anglisht → gjermanisht

52 MB

Nuk ka model të drejtpërdrejtë mes dy gjuhëve? dragoman kalon përmes anglishtes dhe shkarkon të dyja gjysmat.

Madhësitë e shkarkimit sipas regjistrit të modeleve të Mozilla.
Gjuhët
Mbi 50 gjuhë, nga dhe drejt anglishtes. Mes dy gjuhëve të tjera, dragoman kalon përmes anglishtes. Në listën e gjuhëve, ato të shënuara me Vetëm IA kanë nevojë për një model IA.
Përdorimi i parë
Chrome dhe Edge i shkarkojnë paketat e gjuhëve herën e parë që të duhen, ndërsa Safari përdor gjuhët e shkarkuara për përkthimin e Apple në pajisjen tënde. Çiftet gjuhësore të Bergamot shkarkohen një herë nga Mozilla, zakonisht 15 deri në 50 MB, dhe mbeten në shfletuesin tënd. Pas kësaj, gjithçka punon edhe pa internet.
Draftet dhe përmirësimi
Draftet janë të shpejta dhe mjaft fjalë për fjalë, të mira për të kapur thelbin. Modeli yt i rishkruan duke pasur parasysh gjithë faqen, ndaj teksti lexohet natyrshëm dhe emrat e termat mbeten të njëtrajtshëm.
Zgjedhja jote
Për ta mbajtur një faqe në pajisjen tënde edhe kur ke konfiguruar një model, aktivizo Vetëm në këtë pajisje te dritarja e shpejtë. Për të anashkaluar përkthimet paraprake dhe për të pritur modelin tënd, çaktivizo Përkthe paraprakisht në këtë pajisje te Cilësimet.

Bergamot lindi nga një projekt kërkimor i financuar nga Bashkimi Evropian, dhe Mozilla trajnon e publikon modelet gjuhësore që ai përdor. Rreth Bergamot

Shto një model IA

Hap Cilësimet nga dritarja, zgjidh një ofrues dhe ndiq tre hapat. dragoman e kontrollon çelësin sapo ta ngjitësh dhe parazgjedh një model të shpejtë e të lirë, të cilin mund ta ndryshosh kurdo.

Ofruesit që mund të përdorësh

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Çdo server i përputhshëm me OpenAI

OpenRouter mund të krijojë një çelës për ty. Zgjidh Lidhu me OpenRouter dhe mirato kërkesën.

Çelësat e Anthropic që nuk lidhen me një hapësirë pune kërkojnë edhe ID-në e hapësirës së punës. E gjen në Anthropic Console te Cilësimet, pastaj Hapësirat e punës.

Përdor një model lokal

Instalo Ollama, shkarko një model si gemma3 dhe nise me OLLAMA_ORIGINS të vendosur, që të pranojë kërkesat nga shtesa:

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

Në LM Studio, ngarko një model, aktivizo CORS te cilësimet e serverit dhe nis serverin lokal. dragoman e gjen te localhost:1234.

Sa kushton

dragoman është falas. Përmirësimi kryhet me çelësin tënd, ndaj ofruesi të faturon drejtpërdrejt. Për përkthim zakonisht mjaftojnë modele të vogla e të shpejta. Skeda Përdorimi te Cilësimet numëron tokenët për çdo model çdo muaj, dhe nëse aktivizon Shfaq koston e çdo faqeje, kostoja e faqes aktuale shfaqet pranë simbolit.

4 nga 14 paragrafë të përmirësuar

  • Përmirësuar
  • Përkthyer paraprakisht
  • Ende jo

Teksa lëviz poshtë, paragrafët që vijnë marrin një përkthim të shpejtë dhe ata në ekran përmirësohen. Pjesa tjetër e faqes nuk kushton asgjë derisa të arrish atje.

Privatësia

Çfarë largohet nga kompjuteri yt: paragrafët në ekran dhe ata pak më poshtë, si dhe çdo tekst që i kërkon shoqëruesit tënd ta përkthejë, të dërguar te ofruesi që zgjodhe, dhe, për gjuhët që shfletuesi yt nuk i përkthen dot vetë, një shkarkim i njëhershëm modeli nga Mozilla. Çelësi yt dërgohet vetëm te ofruesi i tij. dragoman nuk ka server, llogari apo analitika.

Lexo politikën e plotë të privatësisë

Zgjidhja e problemeve

Dritarja thotë se faqja nuk mund të përkthehet

Faqet e shfletuesit, si cilësimet, faqja e shtesave dhe dyqanet e uebit, nuk lejojnë që shtesat t'i ndryshojnë. Hap në vend të tyre një sajt të zakonshëm.

Motori në pajisje nuk ka model për këtë çift

Përkthyesit në pajisje mbulojnë gjuhët më të përdorura. Në Safari, mund të shtosh të tjera te Gjuhët e përkthimit, në cilësimet Gjuha dhe rajoni të pajisjes. Për të tjerat, shto një model IA dhe dragoman përkthen drejtpërdrejt me të.

Edhe shfletuesi më ofron ta përkthejë faqen

dragoman i kërkon shfletuesit të qëndrojë mënjanë në faqet që mund t'i përkthejë. Nëse e ke çaktivizuar këtë, aktivizo Mbaje mënjanë përkthyesin e shfletuesit te Cilësimet, nën Gjuhët. Nëse shfletuesi e ka përkthyer tashmë një faqe, zgjidh Përdor dragoman më mirë për ta ringarkuar në origjinal.

Një model lokal nuk lidhet

Kontrollo që serveri të jetë në punë dhe që adresa e tij te Cilësimet të përputhet. Ollama ka nevojë për OLLAMA_ORIGINS, ndërsa LM Studio kërkon CORS të aktivizuar.

dragoman nuk mund ta lexojë faqen

Safari dhe Firefox të lejojnë të zgjedhësh cilat sajte mund të lexojë një shtesë. Hap dragoman dhe zgjidh Lejo në të gjitha sajtet.

Firefox nuk përmirëson me modelin tim

Firefox pyet përpara se një shtesë të dërgojë tekst faqeje diku. Hap Cilësimet dhe zgjidh Lejo dërgimin e tekstit të faqes poshtë modelit tënd.

Ndërto nga kodi burimor

dragoman është me burim të hapur nën licencën MIT. Për ta ndërtuar, të duhen Node 24 dhe pnpm.

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

Çdo shfletues ka ndërtimin e vet. Ekzekutoji këto nga extension/:

Shfletuesit Chromium pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Pastaj ndërto safari/dragoman.xcodeproj në Xcode.

Depoja është një hapësirë pune pnpm:

extension/
Shtesa, e ndërtuar me WXT dhe Svelte
site/
Ky sajt, i ndërtuar me SvelteKit
brand/
Dragomanët, logoja dhe qyteti
messages/
Tekstet e ndërfaqes në 85 gjuhë