Прескокни до содржината

Документација

Сè што ви треба за да го инсталирате 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 му ги покажува на вашиот AI модел насловот на страницата, поднасловите и фразите што се повторуваат, за име, ознака или поим да го задржат истиот превод од почеток до крај.

Дел по дел

Περίοδος
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 Вашиот уред Вашиот AI-провајдер само она што го читате, ако додадете модел
Вие го избирате преведувачот
Chrome ги преведува страниците со Google Translate, а Edge со Microsoft Translator. dragoman работи со AI-моделот што ќе го изберете, без разлика дали е Claude, Gemini, моделите зад ChatGPT или модел што работи на вашиот компјутер. Денешните AI-модели генерално подобро се снаоѓаат со идиоми, тон и зборови чие значење зависи од реченицата.
Оригиналот е секогаш при рака
Задржете го покажувачот над кој било пасус или допрете го на телефон за да видите што пишувало претходно, без да ја враќате целата страница.

Преведувачот на прелистувачот е вграден, бесплатен и не бара поставување. Нацртите на dragoman на уредот се исто така бесплатни, а дотерувањето чини само онолку колку што вашиот провајдер наплаќа за текстот што го читате, обично многу малку со мал модел. Преведувачот на Firefox работи со Bergamot, истиот мотор со кој dragoman прави нацрти во Firefox, па таму разликата е AI-дотерувањето и контекстот на страницата.

Под хаубата
Два чекора
Моделот на уредот во вашиот прелистувач прави нацрт во позадина, а Bergamot, компајлиран во WebAssembly, ја пополнува празнината каде што нема таков модел. Пасусите на екранот и оние веднаш под нив потоа одат до вашиот модел во мали групи, и секој дотеран пасус го заменува својот нацрт.
Контекст на страницата
Секое барање го носи насловот на страницата, преглед на поднасловите, фразите што се повторуваат со текстот околу нивното прво појавување и секој досега утврден превод. Моделот ги враќа поимите што ги избрал, а следните барања се држат до нив.
Ознаки
Врските, нагласувањата и другите вградени елементи патуваат како нумерирани места, па распоредот и врските се враќаат неоштетени.
Само она што го читате
Дотерувањето го следи видливиот дел, па долга страница чини само колку делот низ кој лизгате. Готовите преводи се зачувуваат на вашиот уред и повторно се користат кога ќе се вратите.
Без посредник
Барањата одат директно од вашиот прелистувач до давателот со ваш клуч. Нема сервер на dragoman, а секој ред од кодот е јавен.

Превод на уредот

Секоја страница почнува на вашиот уред. dragoman прави нацрт со моделот вграден во Chrome и Edge, и со оној на Apple во Safari. Тие работат на вашиот компјутер, за разлика од преведувањето страници на самите прелистувачи, кое оди на интернет. Насекаде на друго место, и за секој јазик што тие не го покриваат, Bergamot, отворениот мотор зад Firefox Translations, прави нацрт во вашиот прелистувач. Ништо од ова не бара сметка или клуч. Само по себе, добивате брз и приватен превод. Со AI-модел, тие нацрти стануваат прв чекор што вашиот модел го дотерува.

Еднократно преземање по пар јазици

  • англиски → турски 15 MB
  • англиски → германски 26 MB
  • француски → англиски 26 MB
  • јапонски → англиски 49 MB

француски → англиски → германски

52 MB

Нема директен модел меѓу два јазика? dragoman минува преку англиски и ги презема двете половини.

Големините на преземањата се според регистарот на модели на Mozilla.
Јазици
Повеќе од 50 јазици, од и на англиски. Меѓу два други јазика, dragoman преведува преку англиски. Во списокот со јазици, оние означени со Само AI бараат AI модел.
Прво користење
Chrome и Edge ги преземаат своите јазични пакети првиот пат кога ќе ви затребаат, а Safari ги користи јазиците преземени за преведувањето на Apple на вашиот уред. Јазичните парови на Bergamot се преземаат еднаш од Mozilla, обично од 15 до 50 MB, и остануваат во прелистувачот. Потоа сè работи и без интернет.
Нацрти и дотерување
Нацртите се брзи и прилично буквални, доволни за да ја сфатите суштината. Вашиот модел ги преработува гледајќи ја целата страница, па текстот звучи природно, а имињата и термините остануваат доследни.
Вашиот избор
За страницата да остане на вашиот уред и кога имате поставено модел, вклучете Само на овој уред во скокачкиот прозорец. За да ги прескокнете нацртите и да почекате на моделот, исклучете Прво нацрт на овој уред во Поставки.

Bergamot произлезе од истражувачки проект финансиран од Европската Унија, а Mozilla ги тренира и објавува јазичните модели што ги користи. За Bergamot

Додајте AI модел

Отворете ги Поставките од скокачкиот прозорец, изберете давател и следете ги трите чекори. dragoman го проверува клучот штом ќе го залепите и однапред избира брз и евтин модел, кој можете да го промените во секое време.

Достапни провајдери

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Секој сервер компатибилен со OpenAI

OpenRouter може сам да ви создаде клуч. Изберете Поврзи се со OpenRouter и одобрете го барањето.

За клучевите на Anthropic што не се врзани за работен простор потребен е и ID на работен простор. Ќе го најдете во Anthropic Console под Settings, па Workspaces.

Користете локален модел

Инсталирајте 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 може да додадете уште под Јазици за превод во поставките Јазик и регион на уредот. За останатите, додајте AI модел и 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 workspace:

extension/
Екстензијата, изградена со WXT и Svelte
site/
Оваа веб-локација, изградена со SvelteKit
brand/
Драгоманите, логото и градот
messages/
Текстови на интерфејсот на 85 јазици