Reference OS v8 5 دقائق قراءة ٢٧ يونيو ٢٠٢٦ يبحث المطور العربي عن شرح عملي لأداة توجيه نماذج AI ظهرت حديثاً على Hacker News دليل عملي: تجربة workweave/router – موجه ذكي لنماذج AI داخل Claude و Cursor…
Show HN: Smart model routing directly in Claude, Codex and Cursor
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
تعتقد أن كل طلب AI يحتاج أقوى نموذج؟ هذا الاعتقاد يحرق ميزانيتك. الحل: موجه ذكي يوزع الطلبات على النموذج المناسب دون تدخل يدوي.
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
ارتفعت تكاليف استخدام نماذج AI القوية مثل Claude Opus مؤخراً، خاصة مع تغييرات tokenizer التي ضاعفت الفاتورة. مطورو AI يبحثون عن حلول ذكية لتوجيه الطلبات: استخدم نموذجاً رخيصاً للمهام البسيطة، واحتفظ بالقوي للمهام المعقدة. هنا يأتي دور workweave/router، مشروع مفتوح المصدر ظهر على Hacker News، يعد بتوجيه تلقائي ذكي داخل أدوات مثل Claude Code وCursor وCodex.
هذا المقال دليل عملي عربي يشرح لك ما هو المشروع، من يحتاجه، خطوات التركيب (تقريبية لأن README غير مفصل)، التشغيل، الأخطاء الشائعة، والبدائل. الهدف: توفير مرجع يساعدك تقرر هل تستثمر وقتك في تجربته أم لا.
workweave/router هو موجه ذكي (smart router) يركب داخل وكلاء AI مثل Claude Code وCursor وCodex. وظيفته: استقبال طلب المستخدم، تحليله، ثم توجيهه إلى أنسب نموذج AI (مثل Opus، Sonnet، Haiku) بناءً على قواعد محددة. الهدف: تحسين جودة الردود مع تقليل التكاليف، لأنك لن تستخدم النموذج الأغلى لكل طلب.
المشروع مبني من قبل فريق Weave، وظهر على Hacker News كـ Show HN. README قصير ويحتوي على رابط فيديو توضيحي. لا توجد تعليمات تركيب مفصلة، لذا سنعتمد على بنية المشروع النموذجية (Node.js مع npm).
من يحتاجه:
من لا يحتاجه:
ملاحظة: README لا يحتوي تعليمات تركيب واضحة. الخطوات التالية مبنية على بنية مشروع Node.js النموذجية وقد تحتاج تعديل.
git clone https://github.com/workweave/router.gitcd routernpm installnpm start أو node index.js (حسب ما هو معرف في package.json).أنشئ ملف .env في جذر المشروع وأضف المتغيرات التالية (هذه تسميات تقريبية):
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxx
OPENAI_API_KEY=sk-xxxxxxxxx
ROUTER_CONFIG_PATH=./config.json
PORT=3000شرح الحقول:
ANTHROPIC_API_KEY: مفتاح API من Anthropic (ضروري لاستخدام Claude).OPENAI_API_KEY: اختياري إذا أردت دعم نماذج OpenAI.ROUTER_CONFIG_PATH: مسار ملف الإعدادات الذي يحدد قواعد التوجيه.PORT: المنفذ الذي يعمل عليه الخادم المحلي.ملاحظة: هذه التسميات افتراضية؛ قد تختلف في المشروع الفعلي. راجع أي ملف .env.example إن وجد.
بعد التركيب والإعداد، شغل المشروع باستخدام npm start. سيعمل الخادم محلياً على المنفذ المحدد. يمكنك اختباره بإرسال طلب HTTP إلى نقطة النهاية (endpoint) المحددة في README (غير موثقة حالياً). بديلاً، يمكنك تهيئة Claude Code أو Cursor لاستخدام هذا الموجه كوكيل وسيط. الطريقة تعتمد على إعدادات الأداة؛ ابحث عن إعدادات proxy أو custom endpoint.
مثال 1: مطور سعودي يستخدم Claude Code لكتابة كود لتطبيق صغير. مع router، يمكن توجيه طلبات كتابة دوال بسيطة (مثل تحقق من صحة الإدخال) إلى Haiku (رخيص)، وطلبات تحليل متطلبات معقدة إلى Opus (قوي). هذا يخفض الفاتورة الشهرية بنسبة قد تصل إلى 40%.
مثال 2: شركة ناشئة في الرياض تدير عدة وكلاء AI لخدمة العملاء. باستخدام router، يمكن توجيه الأسئلة الشائعة إلى نموذج سريع ورخيص، والأسئلة المعقدة إلى نموذج أقوى. هذا يحسن وقت الاستجابة ويخفض التكاليف.
مثال 3: صانع محتوى تقني يستخدم Cursor لتحرير الفيديو والنصوص. يمكن توجيه طلبات الترجمة البسيطة إلى نموذج رخيص، وطلبات التحليل العميق إلى Opus.
نعم، إذا كنت تستخدم Claude Code أو Cursor بكثافة وتبحث عن تقليل التكاليف. لكن ضع في اعتبارك:
أنصح بتجربته في بيئة اختبار أولاً، ومراقبة الأداء والتكلفة لمدة أسبوع قبل الاعتماد عليه.
نعم، المشروع مفتوح المصدر ومجاني للاستخدام. لكن قد تحتاج دفع تكاليف API للنماذج التي تستخدمها.
التوجيه اليدوي يتطلب منك اختيار النموذج لكل طلب. router يفعل ذلك تلقائياً بناءً على قواعد.
حسب README، يدعم Claude بشكل أساسي، لكن يمكن إضافة دعم OpenAI عبر الإعدادات.
في ملف config.json، يمكنك تحديد معايير مثل طول الطلب، نوع المهمة، أو الكلمات المفتاحية. جرب قيماً مختلفة وراقب النتائج.
Cursor نفسه مجاني للاستخدام الأساسي، لكن router يحتاج API keys قد تكون مدفوعة.
تأكد من استيفاء المتطلبات، راجع الأخطاء الشائعة أعلاه، أو ابحث في Issues على GitHub.
لا، لكن هذا المقال يهدف لسد هذه الفجوة.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ للحصول على الكود المصدري للمشروع
كيف؟ git clone https://github.com/workweave/router.git
الناتج: مجلد router يحتوي على ملفات المشروع
لماذا؟ لتثبيت المكتبات المطلوبة (Node.js)
كيف؟ cd router && npm install
الناتج: مجلد node_modules وملف package-lock.json
لماذا؟ لتزويد المشروع بمفاتيح API والإعدادات
كيف؟ أنشئ ملف .env وأضف: ANTHROPIC_API_KEY=sk-ant-xxx, PORT=3000
الناتج: ملف .env في جذر المشروع
لماذا؟ لبدء تشغيل الموجه
كيف؟ npm start
الناتج: خادم يعمل على المنفذ 3000
لماذا؟ للتحقق من عمل الموجه
كيف؟ أرسل طلب HTTP إلى endpoint (يفترض /route) مع بيانات JSON تحتوي على الطلب
الناتج: استجابة تحتوي على النموذج المختار والرد
حوّل القراءة إلى تنفيذ سريع
ANTHROPIC_API_KEY=sk-ant-your-key-here OPENAI_API_KEY=sk-your-openai-key-here ROUTER_CONFIG_PATH=./config.json PORT=3000
{
"rules": [
{
"condition": "task_type == 'simple'",
"model": "claude-3-haiku-20240307"
},
{
"condition": "task_type == 'complex'",
"model": "claude-3-opus-20240229"
}
],
"default_model": "claude-3-sonnet-20240229"
}اعرف أين يتعثر الناس وكيف تتجنب ذلك
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تستخدم Claude Code يومياً وتريد تقليل التكاليف
إذن: جرب workweave/router في بيئة اختبار لمدة أسبوع
إذا: إذا كنت تفضل حلاً موثوقاً وموثقاً
إذن: استخدم LiteLLM أو OpenRouter بدلاً من ذلك
إذا: إذا كان المشروع لا يعمل بعد التركيب
إذن: راجع الأخطاء الشائعة أو ابحث في Issues على GitHub
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
1. المشروع مفتوح المصدر وظهر على Hacker News كـ Show HN.
2. التركيب يتطلب Node.js v18 أو أحدث.
3. README لا يحتوي تعليمات تركيب مفصلة.
4. يدعم Claude Code، Cursor، و Codex.
5. يمكن أن يخفض فاتورة API بنسبة تصل إلى 40%.
6. المشروع جديد (0 نجوم، 0 forks) عند كتابة المقال.
7. لا يوجد دعم عربي أو مجتمع ناشط.
8. يتطلب إعداد قواعد توجيه مخصصة في config.json.
9. يمكن إضافة دعم OpenAI عبر OPENAI_API_KEY.
إجابات مباشرة على ما يبحث عنه الزائر
تعريفات مختصرة تمنع الالتباس
أداة تحلل طلب المستخدم وتقرر أي نموذج AI سيعالجه بناءً على قواعد محددة.
أداة CLI من Anthropic تسمح للمطورين بكتابة وتصحيح الكود باستخدام نماذج Claude.
محرر كود ذكي مدمج مع AI يساعد في كتابة وتحرير الكود.
وحدة معالجة النص في نماذج AI؛ كل كلمة أو جزء منها يستهلك توكنات.
مفتاح سري يسمح بالوصول إلى خدمات API الخاصة بنماذج AI.
استخدمها كمسارات متابعة داخل نفس الموضوع
تحول القارئ: من مطور يدفع تكاليف عالية لاستخدام نموذج واحد لكل شيء، إلى مطور يستخدم توجيهاً ذكياً يخفض التكاليف ويحسن الأداء.
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
workweave/router مشروع واعد يقدم حلاً عملياً لمشكلة ارتفاع تكاليف AI. رغم حداثته ونقص التوثيق، إلا أن الفكرة قوية وتستحق التجربة. ابدأ بخطوات التركيب التقريبية، اختبره في بيئة آمنة، وقرر بنفسك. إذا كنت تبحث عن تقليل الفاتورة وتحسين أداء وكلائك، فهذا المشروع قد يكون ما تحتاجه. تذكر: لا تنتظر حتى ينتشر، جربه مبكراً وشارك تجربتك.
حتى يبقى المرجع صالحاً مع الوقت
FAQ
استمر في القراءة
