Vés al contingut

Documentació

Tot el que necessites per instal·lar dragoman, connectar un model i mantenir-lo en marxa.

Instal·lació

Instal·la dragoman des de la botiga del teu navegador i s'actualitzarà automàticament des d'allà.

Chrome, Edge, Helium i altres navegadors Chromium
Instal·la una versió manualment

Cada versió també és a GitHub, amb fitxers zip per a navegadors Chromium i Firefox, i tot el codi font. Les versions carregades a mà no s'actualitzen soles.

  1. 1 Baixa el zip de Chrome de la darrera versió i descomprimeix-lo.
  2. 2 Obre helium://extensions, o chrome://extensions en altres navegadors, i activa el Mode de desenvolupador.
  3. 3 Tria Carrega l'extensió sense empaquetar i selecciona la carpeta descomprimida.
Obre la darrera versió

Fixa dragoman a la barra d'eines per tenir-lo a un clic.

Chrome per a Android no admet extensions. A Android, fes servir Firefox.

Tradueix la teva primera pàgina

Obre qualsevol lloc web, fes clic a la icona de dragoman, tria un idioma i selecciona Tradueix la pàgina. Alt+Shift+T, o Option+Shift+T en un Mac, fa el mateix des del teclat. Els esborranys apareixen amb un subratllat daurat de punts, que desapareix a mesura que el model refina cada paràgraf.

AltShiftT / ⌥⇧T Tradueix la pàgina o mostra l'original

Com es llegeix una pàgina traduïda

Esborrany al teu dispositiu
Mochi és actualment promoguda a editora en cap.
Refinat pel model que triïs
Des d'aleshores, la Mochi ha estat ascendida a directora.
L'original, a un pas del cursor
Posa el punter sobre qualsevol paràgraf per llegir què hi deia abans. Un clic a la insígnia, o Alt+Shift+T, restaura tota la pàgina.

Al mòbil o la tauleta, obre dragoman des del menú d'extensions del navegador.

Comparat amb el traductor del navegador

Chrome, Edge, Safari i Firefox poden traduir pàgines pel seu compte, i per fer-hi un cop d'ull sovint n'hi ha prou. dragoman és per quan vols llegir de debò una pàgina: n'encerta el sentit i les paraules, i tu decideixes qui veu el text.

Llegeix tota la pàgina

Els traductors integrats recorren la pàgina a trossets, cadascun pel seu compte, i una mateixa paraula pot sortir de dues maneres amb poques línies de diferència. dragoman mostra al teu model d'IA el títol de la pàgina, els encapçalaments i les frases que es repeteixen, perquè un nom, una etiqueta o un terme mantingui una sola traducció de dalt a baix.

Tros a tros

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

Amb tota la pàgina a la vista

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Un exemple: una mateixa etiqueta grega, repetida al llarg d'una fitxa, traduïda a l'anglès.

Tu decideixes on va el text

Quan Chrome o Edge tradueixen una pàgina, envien el text a Google o Microsoft. dragoman fa l'esborrany al dispositiu i després només envia el que llegeixes al proveïdor que has triat, amb la teva pròpia clau. Si ho mantens al dispositiu, no surt cap text de la pàgina.

On va el text de la pàgina

Chrome Google Edge Microsoft dragoman El teu dispositiu El teu proveïdor d'IA només el que llegeixes, si afegeixes un model
Tu tries el traductor
Chrome tradueix les pàgines amb Google Translate, i Edge amb Microsoft Translator. dragoman funciona amb el model d'IA que triïs: Claude, Gemini, els models de ChatGPT o un que funcioni al teu ordinador. Els models d'IA actuals solen entendre millor les expressions, el to i les paraules que depenen de la frase.
L'original sempre a mà
Passa el cursor per sobre d'un paràgraf, o toca'l al mòbil, per llegir què deia abans, sense tornar tota la pàgina a l'original.

El traductor del navegador ve integrat, és gratuït i no cal configurar-lo. Els esborranys locals de dragoman també són gratuïts, i el refinament només costa el que el teu proveïdor cobra pel text que llegeixes, normalment molt poc amb un model petit. El traductor de Firefox fa servir Bergamot, el mateix motor amb què dragoman fa els esborranys a Firefox, així que allà la diferència és la passada d'IA i el context de la pàgina.

Com funciona per dins
Dues passades
El model del navegador fa l'esborrany en segon pla, i Bergamot, compilat a WebAssembly, cobreix els buits on no n'hi ha. Després, els paràgrafs en pantalla i els següents van al teu model en petits lots, i cada paràgraf refinat substitueix el seu esborrany.
Context de la pàgina
Cada petició inclou el títol de la pàgina, un esquema dels encapçalaments, les frases que s'hi repeteixen amb el text que les envolta la primera vegada i totes les traduccions fixades fins ara. El model retorna els termes que ha triat, i les peticions següents els respecten.
Marcatge
Els enllaços, l'èmfasi i altres elements en línia viatgen com a marcadors numerats, perquè el disseny i els enllaços tornin intactes.
Només el que llegeixes
El refinament segueix la part visible, així que una pàgina llarga només costa el tros que recorres. Les traduccions acabades es desen al dispositiu i es reutilitzen quan hi tornes.
Sense intermediaris
Les peticions van directament del navegador al teu proveïdor amb la teva clau. No hi ha cap servidor de dragoman, i tot el codi és públic.

Traducció al dispositiu

Cada pàgina comença al teu dispositiu. dragoman fa l'esborrany amb el model integrat a Chrome i Edge, i amb el d'Apple a Safari. Funcionen a l'ordinador, a diferència de la traducció de pàgines dels navegadors, que va en línia. A tot arreu més, i per als idiomes que no cobreixen, Bergamot, el motor obert de Firefox Translations, fa l'esborrany dins del navegador. Res d'això necessita compte ni clau. Tot sol, et dona una traducció ràpida i privada. Amb un model d'IA, aquests esborranys són una primera versió que el model poleix.

Una sola descàrrega per parell d'idiomes

  • anglès → turc 15 MB
  • anglès → alemany 26 MB
  • francès → anglès 26 MB
  • japonès → anglès 49 MB

francès → anglès → alemany

52 MB

No hi ha cap model directe entre dos idiomes? dragoman passa per l'anglès i baixa les dues meitats.

Mides de descàrrega segons el registre de models de Mozilla.
Idiomes
Més de 50 idiomes, des de l'anglès i cap a l'anglès. Entre dos altres idiomes, dragoman passa per l'anglès. A la llista d'idiomes, els marcats amb Només IA necessiten un model d'IA.
Primer ús
Chrome i Edge baixen els paquets d'idioma el primer cop que els necessites, i Safari fa servir els idiomes baixats per a la traducció d'Apple al dispositiu. Els parells d'idiomes de Bergamot es baixen de Mozilla una sola vegada, normalment entre 15 i 50 MB, i es queden al navegador. A partir d'aquí, tot funciona sense connexió.
Esborranys i refinament
Els esborranys són ràpids i força literals, prou bons per captar la idea. El teu model els reescriu tenint en compte tota la pàgina, perquè el text soni natural i els noms i termes es mantinguin coherents.
Tu tries
Per mantenir una pàgina al teu dispositiu encara que tinguis un model configurat, activa Només en aquest dispositiu a la finestra emergent. Per ometre els esborranys i esperar el teu model, desactiva Fes primer un esborrany en aquest dispositiu a Configuració.

Bergamot va néixer d'un projecte de recerca finançat per la Unió Europea, i Mozilla entrena i publica els models d'idioma que fa servir. Quant a Bergamot

Afegeix un model d'IA

Obre la Configuració des de la finestra emergent, tria un proveïdor i segueix els tres passos. dragoman comprova la clau tan bon punt l'enganxes i preselecciona un model ràpid i econòmic, que pots canviar quan vulguis.

Proveïdors que pots fer servir

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Qualsevol servidor compatible amb OpenAI

OpenRouter pot crear-te una clau. Tria Connecta amb OpenRouter i aprova la sol·licitud.

Les claus d'Anthropic que no estan vinculades a un espai de treball també necessiten un ID d'espai de treball. El trobaràs a l'Anthropic Console, a Settings i després Workspaces.

Fes servir un model local

Instal·la Ollama, baixa un model com gemma3 i inicia'l amb OLLAMA_ORIGINS definit perquè accepti sol·licituds de l'extensió:

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

A LM Studio, carrega un model, activa CORS a la configuració del servidor i inicia el servidor local. dragoman el troba a localhost:1234.

Quant costa

dragoman és gratuït. El refinament funciona amb la teva pròpia clau, així que el proveïdor et factura directament. Per traduir, sol n'hi ha prou amb models petits i ràpids. La pestanya Ús de la Configuració compta els tokens per model cada mes, i si actives Mostra el cost de cada pàgina, veuràs el cost de la pàgina actual al costat de la insígnia.

4 de 14 paràgrafs refinats

  • Refinat
  • Esborrany
  • Encara no

Mentre et desplaces, els paràgrafs que vénen tot seguit reben un esborrany ràpid i els que tens a la pantalla es refinen. La resta de la pàgina no costa res fins que hi arribes.

Privadesa

El que surt de l'ordinador: els paràgrafs en pantalla i els que venen just després, i qualsevol text que demanis traduir al teu acompanyant, enviats al proveïdor que has triat, i, per als idiomes que el navegador no pot traduir tot sol, una baixada única d'un model de Mozilla. La clau només s'envia al seu proveïdor. dragoman no té servidor, ni comptes, ni analítiques.

Llegeix la política de privadesa completa

Resolució de problemes

La finestra emergent diu que la pàgina no es pot traduir

Les pàgines del navegador, com la configuració, la pàgina d'extensions i les botigues web, no permeten que les extensions les modifiquin. Obre un lloc web normal.

El motor local no té cap model per a aquest parell

Els traductors locals cobreixen els idiomes més parlats. A Safari, en pots afegir més a Idiomes de traducció, dins de la configuració d'Idioma i regió del dispositiu. Per a la resta, afegeix un model d'IA i dragoman traduirà directament amb ell.

El navegador també s'ofereix a traduir la pàgina

dragoman demana al navegador que no intervingui a les pàgines que podria traduir. Si ho has desactivat, activa Aparta el traductor del navegador a Configuració, a Idiomes. Si el navegador ja ha traduït una pàgina, tria Fes servir dragoman per tornar-la a carregar en l'original.

Un model local no es connecta

Comprova que el servidor s'estigui executant i que l'adreça de la Configuració coincideixi. Ollama necessita OLLAMA_ORIGINS i LM Studio necessita CORS activat.

dragoman no pot llegir la pàgina

Safari i Firefox et deixen triar quins llocs web pot llegir una extensió. Obre dragoman i tria Permet-ho a tots els llocs web.

Firefox no refina amb el meu model

Firefox pregunta abans que una extensió enviï el text de la pàgina enlloc. Obre Configuració i tria Permet l'enviament del text de la pàgina sota el teu model.

Compila des del codi font

dragoman és de codi obert amb llicència MIT. Per compilar-lo, necessites Node 24 i pnpm.

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

Cada navegador té la seva compilació. Executa això des d'extension/:

Navegadors Chromium pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Després compila safari/dragoman.xcodeproj a Xcode.

El repositori és un espai de treball de pnpm:

extension/
L'extensió, feta amb WXT i Svelte
site/
Aquest lloc web, fet amb SvelteKit
brand/
Els dragomans, el logotip i la ciutat
messages/
Textos de la interfície en 85 idiomes