דילוג לתוכן

תיעוד

כל מה שצריך כדי להתקין את 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 שאינם משויכים לסביבת עבודה צריכים גם מזהה סביבת עבודה. אפשר למצוא אותו ב־Anthropic Console, תחת הגדרות ואז סביבות עבודה.

שימוש במודל מקומי

מתקינים את 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:

extension/
התוסף, שנבנה עם WXT ו-Svelte
site/
האתר הזה, שנבנה עם SvelteKit
brand/
הדרגומנים, הלוגו והעיר
messages/
טקסט הממשק ב-85 שפות