You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
🎯 מה OmniRoute פותר - 30 נקודות כאב אמיתיות ומקרי שימוש
כל מפתח המשתמש בכלי בינה מלאכותית מתמודד עם הבעיות הללו מדי יום. OmniRoute נבנתה כדי לפתור את כולן - החל מחריפות עלויות ועד לחסימות אזוריות, מזרימות OAuth שבורות ועד פעולות פרוטוקול וצפייה ארגונית.
💸 1. "אני משלם עבור מנוי יקר אבל עדיין מופרע על ידי גבולות"
מפתחים משלמים $20-200 לחודש עבור Claude Pro, Codex Pro או GitHub Copilot. אפילו בתשלום, למכסה יש תקרה - 5 שעות שימוש, מגבלות שבועיות או מגבלות תעריף לדקה. סשן קידוד באמצע, הספק מפסיק להגיב והמפתח מאבד זרימה ופרודוקטיביות.
איך OmniRoute פותר את זה:
Smart 4-Tier Fallback - אם מכסת המנויים נגמרת, מפנה אוטומטית למפתח API → זול → חינם עם אפס התערבות ידנית
מעקב מכסות בזמן אמת - מציג צריכת אסימונים בזמן אמת עם ספירה לאחור מאפס (5 שעות, יומי, שבועי)
תמיכה בריבוי חשבונות - מספר חשבונות לכל ספק עם סבב אוטומטי - כאשר אחד אוזל, עובר לאחר
שילובים מותאמים אישית - שרשראות ניתנות להתאמה אישית עם 6 אסטרטגיות איזון (מילוי ראשון, סיבוב סיבובי, P2C, אקראי, הכי פחות בשימוש, אופטימיזציה לעלות)
Codex Business Quotas - ניטור מכסות סביבת עבודה עסקית/צוותית ישירות בלוח המחוונים
🔌 2. "אני צריך להשתמש במספר ספקים אבל לכל אחד יש API אחר"
OpenAI משתמש בפורמט אחד, קלוד (אנתרופיק) משתמש בפורמט אחר, תאומים בנוסח אחר. אם מפתח רוצה לבחון דגמים מספקים שונים או לחלוף ביניהם, הוא צריך להגדיר מחדש SDK, לשנות נקודות קצה, להתמודד עם פורמטים לא תואמים. לספקים מותאמים אישית (FriendLI, NIM) יש נקודות קצה לא סטנדרטיות במודל.
איך OmniRoute פותר את זה:
נקודת קצה מאוחדת - http://localhost:20128/v1 יחיד משמש כ-proxy עבור כל 36+ הספקים
תרגום פורמט — אוטומטי ושקוף: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
חיטוי תגובה - מסיר שדות לא סטנדרטיים (x_groq, usage_breakdown, service_tier) שמפרקים את OpenAI SDK v1.83+
נורמליזציה של תפקידים — ממירה developer → system עבור ספקים שאינם OpenAI; system → user עבור GLM/ERNIE
Think Tag Extraction — מחלץ בלוקים <think> מדגמים כמו DeepSeek R1 לתוך reasoning_content הסטנדרטי
stream ברירת המחדל היא false - מתיישר עם מפרט OpenAI, הימנעות SSE בלתי צפוי ב- Python/Rust/Go SDK
🌐 3. "ספק הבינה המלאכותית שלי חוסם את האזור/המדינה שלי"
ספקים כמו OpenAI/Codex חוסמים גישה מאזורים גיאוגרפיים מסוימים. משתמשים מקבלים שגיאות כמו unsupported_country_region_territory במהלך חיבורי OAuth ו-API. זה מתסכל במיוחד עבור מפתחים ממדינות מתפתחות.
איך OmniRoute פותר את זה:
תצורת פרוקסי בשלוש רמות - פרוקסי ניתן להגדרה ב-3 רמות: גלובלית (כל התעבורה), לכל ספק (ספק אחד בלבד), ולכל חיבור/מפתח
תגי פרוקסי מקודדים בצבע - אינדיקטורים חזותיים: 🟢 פרוקסי גלובלי, 🟡 פרוקסי ספק, 🔵 פרוקסי חיבור, תמיד מציג את ה-IP
החלפת אסימונים של OAuth באמצעות פרוקסי - זרימת OAuth עוברת גם דרך ה-proxy, ופותרת את unsupported_country_region_territory
בדיקות חיבור באמצעות פרוקסי - בדיקות חיבור משתמשות בפרוקסי המוגדר (לא עוד מעקף ישיר)
תמיכה SOCKS5 — תמיכה מלאה ב-Proxy SOCKS5 לניתוב יוצא
זיוף טביעות אצבע TLS - טביעת אצבע TLS דמוית דפדפן באמצעות wreq-js כדי לעקוף את זיהוי הבוטים
🆓 4. "אני רוצה להשתמש ב-AI לקידוד אבל אין לי כסף"
לא כולם יכולים לשלם 20-200 $ לחודש עבור מנויי AI. סטודנטים, מפתחים ממדינות מתפתחות, חובבים ופרילנסרים צריכים גישה לדגמים איכותיים בעלות אפסית.
איך OmniRoute פותר את זה:
ספקי שכבת חינם מובנית - תמיכה מקורית עבור 100% ספקים בחינם: iFlow (8 דגמים ללא הגבלה), Qwen (3 דגמים ללא הגבלה), Kiro (קלוד בחינם), Gemini CLI (180K/חודש חינם)
שילובים בחינם בלבד — שרשרת gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus = $0 לחודש עם אפס זמן השבתה
קרדיטים חינם של NVIDIA NIM - 1000 זיכויים חינם משולבים
אסטרטגיית אופטימיזציה לעלות — אסטרטגיית ניתוב שבוחרת אוטומטית את הספק הזמין הזול ביותר
🔒 5. "אני צריך להגן על שער הבינה המלאכותית שלי מגישה לא מורשית"
בעת חשיפת שער AI לרשת (LAN, VPS, Docker), כל מי שיש לו את הכתובת יכול לצרוך את האסימונים/מכסה של המפתח. ללא הגנה, ממשקי API חשופים לשימוש לרעה, הזרקה מהירה וניצול לרעה.
איך OmniRoute פותר את זה:
ניהול מפתחות API - יצירה, סיבוב והיקף לכל ספק עם דף /dashboard/api-manager ייעודי
הרשאות ברמת הדגם - הגבל מפתחות API לדגמים ספציפיים (openai/*, דפוסי תווים כלליים), עם החלפת מצב אפשר הכל/הגבל
הגנה על נקודות קצה של API - דרוש מפתח עבור /v1/models וחסום ספקים ספציפיים מהרישום
Auth Guard + CSRF Protection — כל מסלולי לוח המחוונים מוגנים באמצעות תוכנת ביניים withAuth + אסימוני CSRF
** מגביל קצב** - הגבלת קצב לפי IP עם חלונות הניתנים להגדרה
סינון IP — רשימת הרשאות/רשימת חסימות לבקרת גישה
משמר הזרקה מהירה - חיטוי נגד דפוסי הנחיה זדוניים
הצפנת AES-256-GCM - אישורים מוצפנים בזמן מנוחה
🛑 6. "הספק שלי נפל ואיבדתי את זרימת הקידוד"
ספקי בינה מלאכותית עלולים להפוך לבלתי יציבים, להחזיר שגיאות 5xx או לפגוע במגבלות קצב זמניות. אם מפתח תלוי בספק יחיד, הם מופרעים. ללא מפסקים, נסיונות חוזרים ונשנים עלולים לקרוס את האפליקציה.
איך OmniRoute פותר את זה:
מפסק מעגלים לכל ספק - פתיחה/סגירה אוטומטית עם ספים ניתנים להגדרה והתקררות (סגור/פתוח/חצי פתוח)
גיבוי אקספוננציאלי - עיכובים מתקדמים בניסיון חוזר
עדר נגד רעמים - הגנה על מוטקס + סמפור מפני סופות ניסיונות חוזרות במקביל
שרשראות משולבות Fallback - אם הספק הראשי נכשל, נופל אוטומטית בשרשרת ללא התערבות
לוח מחוונים לבריאות - ניטור זמן פעולה, מצבי מפסק זרם, נעילות, סטטיסטיקות מטמון, זמן אחזור p50/p95/p99
🔧 7. "הגדרת כל כלי בינה מלאכותית היא מייגעת וחוזרת על עצמה"
מפתחים משתמשים ב-Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... כל כלי צריך תצורה שונה (נקודת קצה, מפתח, מודל API). הגדרה מחדש בעת החלפת ספקים או דגמים היא בזבוז זמן.
איך OmniRoute פותר את זה:
לוח המחוונים של CLI Tools - דף ייעודי עם הגדרה בלחיצה אחת עבור Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline
GitHub Copilot Config Generator — מייצר chatLanguageModels.json עבור קוד VS עם בחירת דגמים בכמות גדולה
אשף ההטמעה — הגדרה מודרכת בת 4 שלבים למשתמשים ראשונים
נקודת קצה אחת, כל הדגמים - הגדר את http://localhost:20128/v1 פעם אחת, גש ל-36+ ספקים
🔑 8. "ניהול אסימוני OAuth ממספר ספקים זה גיהנום"
Claude Code, Codex, Gemini CLI, Copilot - כולם משתמשים ב-OAuth 2.0 עם אסימונים שפג תוקפם. מפתחים צריכים לבצע אימות מחדש כל הזמן, להתמודד עם client_secret is missing, redirect_uri_mismatch וכשלים בשרתים מרוחקים. OAuth ב-LAN/VPS בעייתי במיוחד.
OAuth 2.0 (PKCE) מובנה - זרימה אוטומטית עבור Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, iFlow
** OAuth מרובה חשבונות** - מספר חשבונות לכל ספק באמצעות חילוץ אסימון JWT/ID
OAuth LAN/תיקון מרחוק - זיהוי IP פרטי עבור redirect_uri + מצב כתובת URL ידני עבור שרתים מרוחקים
OAuth Behind Nginx - משתמש ב-window.location.origin עבור תאימות פרוקסי הפוכה
מדריך OAuth מרחוק - מדריך שלב אחר שלב לאישורי Google Cloud ב-VPS/Docker
📊 9. "אני לא יודע כמה אני מוציא או איפה"
מפתחים משתמשים במספר ספקים בתשלום אך אין להם ראייה אחידה של הוצאות. לכל ספק יש לוח מחוונים משלו לחיוב, אבל אין תצוגה מאוחדת. עלויות בלתי צפויות עלולות להיערם.
איך OmniRoute פותר את זה:
לוח מחוונים של ניתוח עלויות - מעקב אחר עלויות לפי אסימון וניהול תקציב לכל ספק
מגבלות תקציב לכל שכבה - תקרת הוצאה לכל שכבה שמפעילה נפילה אוטומטית
תצורת תמחור לפי דגם — מחירים הניתנים להגדרה לכל דגם
סטטיסטיקת שימוש לכל מפתח API - ספירת בקשות וחותמת זמן אחרונה בשימוש לכל מפתח
לוח המחוונים של אנליטיקס - כרטיסי סטטיסטיקה, טבלת שימוש במודל, טבלת ספקים עם אחוזי הצלחה והשהייה
🐛 10. "אני לא יכול לאבחן שגיאות ובעיות בשיחות AI"
כאשר שיחה נכשלת, ה-dev לא יודע אם זו הייתה מגבלת תעריף, אסימון שפג תוקפו, פורמט שגוי או שגיאת ספק. יומנים מפוצלים על פני מסופים שונים. ללא צפייה, איתור באגים הוא ניסוי וטעייה.
איך OmniRoute פותר את זה:
לוח מחוונים של יומנים מאוחדים - 4 כרטיסיות: יומני בקשות, יומני פרוקסי, יומני ביקורת, מסוף
מציג יומן מסוף - מציג בזמן אמת בסגנון טרמינל עם רמות מקודדות צבע, גלילה אוטומטית, חיפוש, סינון
SQLite Proxy Logs - יומנים מתמשכים ששורדים אתחול מחדש של השרת
מגרש משחקים לתרגום - 4 מצבי ניפוי באגים: מגרש משחקים (תרגום פורמט), בודק צ'אט (הלוך ושוב), ספסל בדיקה (אצווה), צג חי (בזמן אמת)
רישום מבוסס קבצים עם סיבוב - מיירט המסוף לוכד הכל ליומן JSON עם סיבוב מבוסס גודל
🏗️ 11. "פריסה ותחזוקה של השער מורכבת"
התקנה, הגדרה ותחזוקה של פרוקסי בינה מלאכותית בסביבות שונות (מקומי, VPS, Docker, ענן) היא עתירת עבודה. בעיות כמו נתיבים מקודדים קשיחים, EACCES על ספריות, התנגשויות יציאות ובנייה בין פלטפורמות מוסיפות חיכוך.
Docker Compose Profiles — base (ללא כלי CLI) ו-cli (עם קוד קלוד, Codex, OpenClaw)
אפליקציית Electron Desktop — אפליקציה מקורית עבור Windows/macOS/Linux עם מגש מערכת, הפעלה אוטומטית, מצב לא מקוון
מצב יציאות מפוצלות - API ולוח מחוונים ביציאות נפרדות עבור תרחישים מתקדמים (פרוקסי הפוך, רשת קונטיינר)
Cloud Sync - הגדרת סנכרון בין מכשירים באמצעות Cloudflare Workers
גיבויי DB - גיבוי, שחזור, ייצוא וייבוא אוטומטי של כל ההגדרות
🌍 12. "הממשק הוא באנגלית בלבד והצוות שלי לא מדבר אנגלית"
צוותים במדינות שאינן דוברות אנגלית, במיוחד באמריקה הלטינית, אסיה ואירופה, נאבקים עם ממשקים באנגלית בלבד. מחסומי שפה מפחיתים את האימוץ ומגדילים את שגיאות התצורה.
Combo: "always-on"
1. cc/claude-opus-4-6
2. cx/gpt-5.2-codex
3. glm/glm-4.7
4. minimax/MiniMax-M2.1
5. if/kimi-k2-thinking
Outcome: deep fallback depth for deadline-critical workloads
Playbook D: סוכן מבצע עם MCP + A2A
1) Start MCP transport (`omniroute --mcp`) for tool-driven operations
2) Run A2A tasks via `message/send` and `message/stream`
3) Observe via /dashboard/mcp and /dashboard/a2a
4) Control incidents with resilience profile + task cancellation
⚡ התחלה מהירה
1. התקן ברחבי העולם:
npm install -g omniroute
omniroute
🎉 לוח המחוונים נפתח ב-http://localhost:20128
פקודה
תיאור
omniroute
התחל שרת (יציאת ברירת מחדל 20128)
omniroute --port 3000
השתמש ביציאה מותאמת אישית
omniroute --no-open
אל תפתח אוטומטית את הדפדפן
omniroute --help
הצג עזרה
2. חבר ספק חינמי:
לוח מחוונים ← ספקים ← התחבר קוד קלוד או אנטי כבידה ← התחברות OAuth ← בוצע!
3. השתמש בכלי ה-CLI שלך:
Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
Endpoint: http://localhost:20128/v1
API Key: [copy from dashboard]
Model: if/kimi-k2-thinking
זהו זה! התחל לקודד עם דגמי AI בחינם.
אלטרנטיבה - הפעל מהמקור:
cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
🐳 דוקר
OmniRoute זמין כתמונת Docker ציבורית ב-Docker Hub.
🌐 Offline Mode — Works fully offline with bundled server
npm run electron:dev # Development mode
npm run electron:build # Current platform
npm run electron:build:win # Windows (.exe)
npm run electron:build:mac # macOS (.dmg)
npm run electron:build:linux # Linux (.AppImage)
פלט מובנה — json_schema → responseMimeType/responseSchema של Gemini
👥 תמיכה בריבוי חשבונות
הוסף מספר חשבונות לכל ספק
ניתוב סבב אוטומטי או מבוסס עדיפות
חזרה לחשבון הבא כאשר אחד מגיע למכסה
🔄 רענון אסימון אוטומטי
אסימוני OAuth מתרעננים אוטומטית לפני פקיעת התוקף
אין צורך באימות מחדש ידני
חוויה חלקה בכל הספקים
🎨 שילובים מותאמים אישית
צור שילובי דגמים ללא הגבלה
6 אסטרטגיות: מילוי ראשון, עגול, כוח משתי בחירות, אקראי, פחות בשימוש, אופטימיזציית עלות
שתף שילובים בין מכשירים עם Cloud Sync
🏥 לוח מחוונים לבריאות
מצב מערכת (זמן פעילות, גרסה, שימוש בזיכרון)
מצבי מפסק לכל ספק (סגור/פתוח/חצי פתוח)
מצב מגבלת תעריף ונעילה אקטיבית
סטטיסטיקת מטמון חתימה
טלמטריית אחזור (p50/p95/p99) + מטמון פקודות
אפס מצב בריאותי בלחיצה אחת
🔧 מגרש משחקים למתרגמים
OmniRoute כולל מגרש משחקי מתרגמים מובנה רב עוצמה עם 4 מצבים לניפוי באגים, בדיקה וניטור תרגומי API:
מצב
תיאור
💻 מגרש משחקים
תרגום פורמט ישיר - הדבק כל גוף בקשת API וראה באופן מיידי כיצד OmniRoute מתרגם אותו בין פורמטים של ספקים (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). כולל תבניות לדוגמה וזיהוי אוטומטי של פורמטים.
💬 בודק צ'אט
שלח בקשות צ'אט אמיתיות דרך OmniRoute וראה את המסלול המלא הלוך ושוב: הקלט שלך, הבקשה המתורגמת, תגובת הספק והתגובה המתורגמת חזרה. לא יסולא בפז עבור אימות ניתוב משולב.
🧪 ספסל מבחן
מצב בדיקת אצווה - הגדירו מקרי בדיקה מרובים עם תשומות ותפוקות צפויות שונות, הפעל את כולם בבת אחת והשווה תוצאות בין ספקים ודגמים.
📱 צג חי
ניטור בקשות בזמן אמת - צפה בבקשות נכנסות כשהן זורמות דרך OmniRoute, ראה תרגומי פורמטים המתרחשים בשידור חי וזיהוי בעיות באופן מיידי.
גישה: לוח מחוונים ← מתרגם (סרגל צד)
💾 סנכרון ענן
סנכרון ספקים, שילובים והגדרות בין מכשירים
סנכרון רקע אוטומטי
אחסון מוצפן מאובטח
🧪 הערכות (הערכות)
OmniRoute כולל מסגרת הערכה מובנית לבדיקת איכות תגובת LLM מול סט מוזהב. גש אליו דרך Analytics → Evals בלוח המחוונים.
סט מוזהב מובנה
ה-"OmniRoute Golden Set" הנטען מראש מכיל 10 מקרי בדיקה המכסים:
שמור על ערכי NEXT_PUBLIC_* מיושרים עם ערכי צד השרת
הכניסה הראשונה לא עובדת
בדוק את INITIAL_PASSWORD ב-.env
אם לא מוגדרת, סיסמת החלפה היא 123456
ללא יומני בקשות
הגדר ENABLE_REQUEST_LOGS=true ב-.env
בדיקת חיבור מראה "לא חוקי" עבור ספקים תואמי OpenAI
ספקים רבים אינם חושפים נקודת קצה /models
OmniRoute v1.0.6+ כולל אימות חוזר באמצעות השלמת צ'אט
ודא שכתובת האתר הבסיסית כוללת את הסיומת /v1
🔐 OAuth
⚠️ חשוב עבור שימוש ב-OmniRoute עם מרחוק VPS/Docker/שרת
האם אפשר לעשות אנטי כבידה / CLI מזל תאומים על שירותים מרוחקים?
שימוש ב-Antigravity ו-Gemini CLI בשימוש ב-Google OAuth 2.0 עבור אוטנטיקה. O Google exige que a redirect_uri usada no fluxo OAuth seja exatamente uma das URIs pré-cadastradas no Google Cloud Console do aplicativo.
As credenciais OAuth embutidas no OmniRoute estão cadastradas apenas para localhost. Quando você acessa o OmniRoute em um servidor remoto (לדוגמה: https://omniroute.meuservidor.com), o Google rejeita a autenticação com:
Error 400: redirect_uri_mismatch
פתרון: הגדר את התצורה של OAuth
קרא בדיוק את OAuth 2.0 Client ID ללא Google Cloud Console com a URI do seu service.
תודה מיוחדת ל**9router** מאת decolua - הפרויקט המקורי שהיווה השראה למזלג הזה. OmniRoute בונה על הבסיס המדהים הזה עם תכונות נוספות, ממשקי API רב-מודאליים ושכתוב מלא של TypeScript.
תודה מיוחדת ל**CLIProxyAPI** - היישום המקורי של Go שימש השראה ליציאת JavaScript הזו.