დოკუმენტაცია

ინსტალაცია

დააინსტალირეთ dragoman თქვენი ბრაუზერის მაღაზიიდან და ის იქიდანვე განახლდება ავტომატურად.

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

Chrome, Edge, Helium და სხვა Chromium ბრაუზერები

გამოშვების ხელით ინსტალაცია

ყველა გამოშვება GitHub-ზეც არის: zip ფაილები Chromium-ის ბრაუზერებისა და Firefox-ისთვის, ასევე სრული საწყისი კოდი. ხელით ჩატვირთული ვერსიები თავად არ ახლდება.

1 ჩამოტვირთეთ Chrome-ის zip ფაილი უახლესი ვერსიიდან და გახსენით არქივი.
2 გახსენით helium://extensions, სხვა ბრაუზერებში კი chrome://extensions, და ჩართეთ დეველოპერის რეჟიმი.
3 აირჩიეთ „გაუხსნელის ჩატვირთვა“ და მიუთითეთ გახსნილი საქაღალდე.

უახლესი ვერსიის გახსნა

მიამაგრეთ dragoman ხელსაწყოთა ზოლზე, რომ ერთ დაწკაპუნებაში იყოს.

Android-ის Chrome გაფართოებებს არ უჭერს მხარს. Android-ზე გამოიყენეთ Firefox.

გახსენით ნებისმიერი საიტი, დააწკაპუნეთ dragoman-ის ხატულაზე, აირჩიეთ ენა და დააჭირეთ „გვერდის თარგმნას“. იგივეს აკეთებს Alt+Shift+T, ან Mac-ზე Option+Shift+T. მონახაზები ოქროსფერი წერტილოვანი ხაზგასმით ჩნდება, რომელიც ქრება, როცა მოდელი თითოეულ აბზაცს დახვეწს.

AltShiftT / ⌥⇧T გვერდის თარგმნა ან ორიგინალის ჩვენება

როგორ იკითხება ნათარგმნი გვერდი

მონახაზი თქვენს მოწყობილობაზე: მოჩი ამჟამად არის დაწინაურებული მთავარ რედაქტორად.
დახვეწა თქვენ მიერ არჩეული მოდელით: მოჩი მას შემდეგ მთავარ რედაქტორადაც კი დააწინაურეს.
ორიგინალი სულ ახლოსაა: მიიტანეთ მაჩვენებელი ნებისმიერ აბზაცზე და ნახავთ, რა ეწერა მანამდე. ნიშანზე ერთი დაწკაპუნება ან Alt+Shift+T მთელ გვერდს აბრუნებს.

ტელეფონსა ან პლანშეტზე dragoman ბრაუზერის გაფართოებების მენიუდან გახსენით.

შედარება ბრაუზერის მთარგმნელთან

Chrome-ს, Edge-ს, Safari-სა და Firefox-ს გვერდების თარგმნა თავადაც შეუძლიათ და სწრაფად გადასახედად ეს ხშირად საკმარისია. dragoman მაშინაა საჭირო, როცა გვერდის ნამდვილად წაკითხვა გსურთ: ის აზრსაც ზუსტად გადმოსცემს და ფორმულირებასაც, ტექსტს კი მხოლოდ ის ხედავს, ვისაც თქვენ გადაწყვეტთ.

ის მთელ გვერდს კითხულობს

ჩაშენებული მთარგმნელები გვერდს პატარა ნაწილებად, თითოეულს ცალ-ცალკე თარგმნიან, ამიტომ ერთი და იგივე სიტყვა რამდენიმე სტრიქონში შეიძლება ორნაირად ითარგმნოს. dragoman თქვენს AI მოდელს უჩვენებს გვერდის სათაურს, ქვესათაურებს და განმეორებად ფრაზებს, ასე რომ სახელი, წარწერა თუ ტერმინი თავიდან ბოლომდე ერთნაირად ითარგმნება.

ნაწილ-ნაწილ

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

მთელი გვერდის გათვალისწინებით

Περίοδος: Term
Περίοδος: Term
Περίοδος: Term
Περίοδος: 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-ით დახვეწა და გვერდის კონტექსტი ქმნის.

როგორ მუშაობს

ორი ეტაპი: მონახაზს ფონურ რეჟიმში ბრაუზერის ჩაშენებული მოდელი ქმნის, ხოლო სადაც ის არ არის, WebAssembly-ში კომპილირებული Bergamot ავსებს. შემდეგ ეკრანზე არსებული და მომდევნო აბზაცები მცირე პარტიებით თქვენს მოდელს ეგზავნება და თითოეული დახვეწილი აბზაცი თავის მონახაზს ცვლის.
გვერდის კონტექსტი: ყოველ მოთხოვნას ახლავს გვერდის სათაური, ქვესათაურების მონახაზი, გვერდზე განმეორებადი ფრაზები მათი პირველი გამოჩენის გარემომცველ ტექსტთან ერთად და აქამდე შეთანხმებული ყველა თარგმანი. მოდელი აბრუნებს მის მიერ არჩეულ ტერმინებს და შემდგომი მოთხოვნები მათ იცავს.
მარკირება: ბმულები, გამოყოფა და სხვა ხაზშიდა ელემენტები დანომრილი ჩანაცვლებებით გადაიცემა, ამიტომ განლაგება და ბმულები უცვლელად ბრუნდება.
მხოლოდ ის, რასაც კითხულობთ: დახვეწა ხილულ არეს მიჰყვება, ამიტომ გრძელ გვერდზე მხოლოდ გადაფურცლული ნაწილის ფასს იხდით. დასრულებული თარგმანები თქვენს მოწყობილობაზე ინახება და დაბრუნებისას ხელახლა გამოიყენება.
შუამავლის გარეშე: მოთხოვნები თქვენი ბრაუზერიდან პირდაპირ თქვენს პროვაიდერთან მიდის თქვენი გასაღებით. dragoman-ის სერვერი არ არსებობს და კოდის ყოველი სტრიქონი საჯაროა.

თარგმნა მოწყობილობაზე

ყოველი გვერდი თქვენს მოწყობილობაზე იწყება. dragoman მონახაზს Chrome-სა და Edge-ში ჩაშენებული მოდელით ქმნის, Safari-ში კი Apple-ისით. ისინი თქვენს კომპიუტერზე მუშაობს, ბრაუზერების საკუთარი გვერდის თარგმნისგან განსხვავებით, რომელიც ინტერნეტით მიმდინარეობს. სხვა ყველგან და იმ ენებისთვის, რომლებსაც ისინი არ ფარავს, მონახაზს ბრაუზერშივე ქმნის Bergamot, ღია ძრავა, რომელიც Firefox Translations-ს ამუშავებს. არც ანგარიშია საჭირო, არც გასაღები. დამოუკიდებლად ის სწრაფ და პირად თარგმანს გაძლევთ. AI მოდელთან ერთად კი ეს მონახაზები პირველ ვარიანტად იქცევა, რომელსაც თქვენი მოდელი ხვეწს.

ერთჯერადი ჩამოტვირთვა თითო ენათა წყვილზე

ინგლისური → თურქული 15 მეგაბაიტი
ინგლისური → გერმანული 26 მეგაბაიტი
ფრანგული → ინგლისური 26 მეგაბაიტი
იაპონური → ინგლისური 49 მეგაბაიტი

ფრანგული → ინგლისური → გერმანული

52 მეგაბაიტი

ორ ენას შორის პირდაპირი მოდელი არ არის? 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-ში იპოვით: „პარამეტრები“, შემდეგ „სამუშაო სივრცეები“.

ლოკალური მოდელის გამოყენება

დააყენეთ Ollama, ჩამოტვირთეთ მოდელი, მაგალითად gemma3, და გაუშვით OLLAMA_ORIGINS-ის მითითებით, რომ გაფართოების მოთხოვნები მიიღოს:

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

LM Studio-ში ჩატვირთეთ მოდელი, სერვერის პარამეტრებში ჩართეთ CORS და გაუშვით ლოკალური სერვერი. dragoman მას localhost:1234-ზე იპოვის.

რა ღირს

dragoman უფასოა. დახვეწა თქვენი გასაღებით ხდება, ამიტომ პროვაიდერი ანგარიშს პირდაპირ თქვენ გიგზავნით. თარგმნისთვის, როგორც წესი, მცირე და სწრაფი მოდელებიც საკმარისია. პარამეტრების „მოხმარების“ ჩანართი ყოველთვიურად ითვლის ტოკენებს თითოეული მოდელისთვის, ხოლო „თითოეული გვერდის ღირებულების ჩვენება“ მიმდინარე გვერდის ღირებულებას ნიშნაკის გვერდით აჩვენებს.

14-დან 4 აბზაცი დაიხვეწა

დახვეწილი
მონახაზი
ჯერ არა

გადახვევისას წინ მდებარე აბზაცები სწრაფ მონახაზს იღებს, ეკრანზე არსებული კი იხვეწება. გვერდის დანარჩენი ნაწილი არაფერი ჯდება, სანამ იქამდე არ მიხვალთ.

კონფიდენციალურობა

რა ტოვებს თქვენს კომპიუტერს: ეკრანზე არსებული და მომდევნო აბზაცები, ასევე ნებისმიერი ტექსტი, რომლის თარგმნასაც თანამგზავრს სთხოვთ — ეგზავნება თქვენ მიერ არჩეულ პროვაიდერს; ხოლო იმ ენებისთვის, რომლებსაც ბრაუზერი თავად ვერ თარგმნის, ერთჯერადად ჩამოიტვირთება მოდელი 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 ენაზე

წაიკითხეთ მონაწილეობის სახელმძღვანელო საწყისი კოდის დათვალიერება