دليل عملي: تجربة workweave/router – موجه ذكي لنماذج AI داخل Claude و Cursor
Show HN: Smart model routing directly in Claude, Codex and Cursor
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو workweave/router؟
- من يحتاجه ومن لا؟
- المميزات الرئيسية
- المتطلبات الأساسية
- خطوات التركيب (تقريبية)
- شرح ملف .env وإعداد API Keys
- كيفية التشغيل والاختبار
- أخطاء شائعة وحلولها
- استخدامات عملية في السوق السعودي
- هل يستحق التجربة؟ (تحليل صريح)
- بدائل مشابهة
- أسئلة شائعة
قبل أن تطبق
الفكرة التي تمنع التسرع
تعتقد أن كل طلب AI يحتاج أقوى نموذج؟ هذا الاعتقاد يحرق ميزانيتك. الحل: موجه ذكي يوزع الطلبات على النموذج المناسب دون تدخل يدوي.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل تستخدم Claude Code أو Cursor يومياً لأكثر من 50 طلباً؟
- هل تدفع فاتورة API شهرية تتجاوز 100 دولار؟
- هل تفضل تقليل التكاليف على حساب بعض الدقة في المهام البسيطة؟
- هل لديك خبرة في إعداد Node.js وملفات .env؟
- هل أنت مستعد لتجربة مشروع جديد (0 نجوم) مع احتمالية أخطاء؟
- هل تحتاج توجيه تلقائي دون تدخل يدوي؟
- هل تبحث عن بديل مفتوح المصدر لـ OpenRouter أو LiteLLM؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
ارتفعت تكاليف استخدام نماذج AI القوية مثل Claude Opus مؤخراً، خاصة مع تغييرات tokenizer التي ضاعفت الفاتورة. مطورو AI يبحثون عن حلول ذكية لتوجيه الطلبات: استخدم نموذجاً رخيصاً للمهام البسيطة، واحتفظ بالقوي للمهام المعقدة. هنا يأتي دور workweave/router، مشروع مفتوح المصدر ظهر على Hacker News، يعد بتوجيه تلقائي ذكي داخل أدوات مثل Claude Code وCursor وCodex.
هذا المقال دليل عملي عربي يشرح لك ما هو المشروع، من يحتاجه، خطوات التركيب (تقريبية لأن README غير مفصل)، التشغيل، الأخطاء الشائعة، والبدائل. الهدف: توفير مرجع يساعدك تقرر هل تستثمر وقتك في تجربته أم لا.
ما هو workweave/router؟
workweave/router هو موجه ذكي (smart router) يركب داخل وكلاء AI مثل Claude Code وCursor وCodex. وظيفته: استقبال طلب المستخدم، تحليله، ثم توجيهه إلى أنسب نموذج AI (مثل Opus، Sonnet، Haiku) بناءً على قواعد محددة. الهدف: تحسين جودة الردود مع تقليل التكاليف، لأنك لن تستخدم النموذج الأغلى لكل طلب.
المشروع مبني من قبل فريق Weave، وظهر على Hacker News كـ Show HN. README قصير ويحتوي على رابط فيديو توضيحي. لا توجد تعليمات تركيب مفصلة، لذا سنعتمد على بنية المشروع النموذجية (Node.js مع npm).
من يحتاجه ومن لا؟
من يحتاجه:
- مطور عربي يستخدم Claude Code أو Cursor بشكل يومي ويريد تقليل فاتورة API.
- صاحب مشروع صغير يدير عدة وكلاء AI ويحتاج موازنة بين التكلفة والجودة.
- مهتم بأدوات AI مفتوحة المصدر ويبحث عن تحسين أداء سير العمل.
من لا يحتاجه:
- مستخدم عادي لا يبرمج أو لا يستخدم وكلاء AI.
- مطور يستخدم نموذجاً واحداً فقط ولا يهتم بالتكلفة.
- من يبحث عن حل جاهز بدون تخصيص (المشروع يتطلب إعداد قواعد).
المميزات الرئيسية
- توجيه تلقائي للطلبات إلى النموذج المناسب.
- تقليل التكاليف باستخدام نماذج رخيصة للمهام البسيطة.
- يدعم Claude Code، Cursor، Codex (حسب الإعداد).
- مفتوح المصدر (رخصة غير محددة حالياً).
- خفيف وسهل التركيب (Node.js).
المتطلبات الأساسية
- Node.js (v18 أو أحدث).
- npm أو yarn.
- مفاتيح API من Anthropic (Claude) و/أو OpenAI (إذا أردت دعم نماذج أخرى).
- حساب على GitHub لاستنساخ المشروع.
- أداة CLI مثل Claude Code أو Cursor مثبتة.
خطوات التركيب (تقريبية)
ملاحظة: README لا يحتوي تعليمات تركيب واضحة. الخطوات التالية مبنية على بنية مشروع Node.js النموذجية وقد تحتاج تعديل.
- استنساخ المستودع:
git clone https://github.com/workweave/router.git - الدخول إلى المجلد:
cd router - تثبيت الاعتماديات:
npm install - إعداد ملف .env (انظر القسم التالي).
- تشغيل المشروع:
npm startأوnode index.js(حسب ما هو معرف في package.json).
شرح ملف .env وإعداد API Keys
أنشئ ملف .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 بكثافة وتبحث عن تقليل التكاليف. لكن ضع في اعتبارك:
- المشروع جديد (0 نجوم، 0 forks) ولم يختبر بشكل واسع.
- README غير مفصل، لذا توقع بعض التخمين في التركيب.
- لا يوجد دعم عربي أو مجتمع ناشط.
- قد لا يعمل مع جميع الإصدارات.
أنصح بتجربته في بيئة اختبار أولاً، ومراقبة الأداء والتكلفة لمدة أسبوع قبل الاعتماد عليه.
بدائل مشابهة
أسئلة شائعة
هل workweave/router مجاني؟
نعم، المشروع مفتوح المصدر ومجاني للاستخدام. لكن قد تحتاج دفع تكاليف API للنماذج التي تستخدمها.
ما الفرق بينه وبين التوجيه اليدوي؟
التوجيه اليدوي يتطلب منك اختيار النموذج لكل طلب. router يفعل ذلك تلقائياً بناءً على قواعد.
هل يدعم نماذج غير Claude؟
حسب README، يدعم Claude بشكل أساسي، لكن يمكن إضافة دعم OpenAI عبر الإعدادات.
كيف أضبط thresholds للتوجيه الأفضل؟
في ملف config.json، يمكنك تحديد معايير مثل طول الطلب، نوع المهمة، أو الكلمات المفتاحية. جرب قيماً مختلفة وراقب النتائج.
هل يمكن استخدامه مع Cursor مجاناً؟
Cursor نفسه مجاني للاستخدام الأساسي، لكن router يحتاج API keys قد تكون مدفوعة.
ماذا لو لم يعمل المشروع؟
تأكد من استيفاء المتطلبات، راجع الأخطاء الشائعة أعلاه، أو ابحث في Issues على GitHub.
هل هناك دعم عربي؟
لا، لكن هذا المقال يهدف لسد هذه الفجوة.
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
استنساخ المستودع
لماذا؟ للحصول على الكود المصدري للمشروع
كيف؟ git clone https://github.com/workweave/router.git
الناتج: مجلد router يحتوي على ملفات المشروع
تثبيت الاعتماديات
لماذا؟ لتثبيت المكتبات المطلوبة (Node.js)
كيف؟ cd router && npm install
الناتج: مجلد node_modules وملف package-lock.json
إعداد ملف .env
لماذا؟ لتزويد المشروع بمفاتيح 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
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: استنساخ المشروع وتثبيت الاعتماديات
- اليوم 2: إعداد ملف .env و config.json
- اليوم 3: تشغيل الخادم واختبار endpoint
- اليوم 4: ربط router مع Claude Code (إعدادات proxy)
- اليوم 5: اختبار 10 طلبات متنوعة ومراقبة التوجيه
- اليوم 6: تحليل التكاليف والأداء
- اليوم 7: اتخاذ قرار الاعتماد أو البحث عن بديل
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
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.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يدفع تكاليف عالية لاستخدام نموذج واحد لكل شيء، إلى مطور يستخدم توجيهاً ذكياً يخفض التكاليف ويحسن الأداء.
- إدارة التكاليف في السحابة (Cloud Cost Management)
- تحسين أداء وكلاء AI
- أتمتة سير العمل باستخدام AI
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
workweave/router مشروع واعد يقدم حلاً عملياً لمشكلة ارتفاع تكاليف AI. رغم حداثته ونقص التوثيق، إلا أن الفكرة قوية وتستحق التجربة. ابدأ بخطوات التركيب التقريبية، اختبره في بيئة آمنة، وقرر بنفسك. إذا كنت تبحث عن تقليل الفاتورة وتحسين أداء وكلائك، فهذا المشروع قد يكون ما تحتاجه. تذكر: لا تنتظر حتى ينتشر، جربه مبكراً وشارك تجربتك.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحقق من تحديثات GitHub أسبوعياً (commits, issues, pull requests)
- راجع README كل شهر لظهور تعليمات تركيب رسمية
- اختبر التوافق مع إصدارات Claude Code و Cursor الجديدة
- تابع مناقشات Hacker News للمشروع
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇