
مهم: Astra-Ares هو تطبيق مرجعي تجريبي. كيخدم بـ Codex CLI مستقل ومصحّح، وموجّه بالأساس للتجارب ولا للمطوّرين اللي باغين يدمجو مجهود الاستدلال التكيّفي فأنظمة الوكلاء ديالهم.
شنو كيدير Astra-Ares
Astra-Ares كيزيد اختيار تكيّفي لمجهود الاستدلال فـ GPT-6 Astra ملي كتكون مهمة Codex خدامة. عوض ما يعيّن مستوى واحد وثابت للاستدلال على المهمة كاملة، كيستعمل مقيّم سميتو Jev باش يختار شحال من استدلال خاص Astra يطبّق فالخطوة الجاية.
Jev كيدرس سياق محدود ديال المهمة، وكيختار مستوى المجهود الجاي، وكيقرّر واش يبقى داك الاختيار مفعّل لجيل واحد، جوج، 5 ولا 10 ديال أجيال النموذج. من بعد Codex كيطبّق الاختيار باستعمال آلية الإعدادات الأصلية ديال Astra قبل ما تكمل الخدمة.
Astra يقدر يبدّل مجهود الاستدلال بلا ما يبطل البادئة الأصلية ديال الطلب اللي كيستعملها الكاش. وبالتالي، Ares كيخلي نفس النموذج والمحادثة والاتصال المباشر بـ OpenAI، وما كيدخلش راسو فمسار الشبكة ديال Astra. القواعد العادية ديال أهلية كاش الطلب والاحتفاظ به كتبقى مطبّقة.
الميزات الرئيسية
- استدلال تكيّفي: Jev كيختار المجهود اللي خاص للجزء الجاي من المهمة، عوض الاعتماد على إعداد واحد وثابت.
- إيجارات متعددة الأجيال: القرار يقدر يبقى مفعّل لجيل واحد، جوج، 5 ولا 10 ديال الأجيال، وهاد الشي كينقص من طلبات المقيّم اللي ما عندهاش ضرورة.
- تطبيق أصلي داخل Codex: الـ CLI المصحّح كيطبّق إعدادات Astra بين الأجيال وكيأكد بنجاح التطبيق.
- سياق محدود للمقيّم: Jev كيتوصل بالمهمة، والتقدّم العمومي، وملخّصات الاستدلال، ومجموعة محدودة من آخر نتائج الأدوات.
- اتصال مباشر بـ Astra: Codex كيبقى كيهضر مباشرة مع OpenAI. Jev كيستعمل مزوّد منفصل ومهيّأ.
- تثبيت معزول: Astra-Ares كيستعمل بروفايل Codex خاص به، وما كيبدّلش الأمر الموجود
codexولا تطبيق Codex المكتبي. - تدبير واضح للأخطاء: Ares ما كيبدّلش المزوّدين بصمت، وما كيستبدلش النماذج، وما كيخترعش قرار ديال المجهود.
قبل ما تثبّت
أول عملية بناء كتحتاج بضع دقايق وحوالي 10 GB ديال المساحة الخاوية. ثبّت المتطلبات التالية:
- Node.js 22 ولا أحدث
- npm
- Git
- curl
- tar
- سلسلة أدوات أصلية لبناء C/C++
- Rust عبر rustup
عملية الإعداد كتثبّت حتى سلسلة أدوات Rust المحددة من طرف مصدر Codex الأصلي. فـ macOS، ثبّت أدوات سطر الأوامر ديال Xcode إلا ما كانوش موجودين:
xcode-select --install
macOS بمعالجات Apple Silicon تبنى وتجرّب محلياً. كاينة مسارات بناء لـ macOS بمعالجات Intel وLinux، ولكن مازال ما تدارش عليها اختبارات القبول. Windows ما مدعومش حيث هاد الدمج كيعتمد على Unix sockets.
الخطوة 1: بناء وتثبيت Astra-Ares
نسخ مستودع المصدر، ثبّت تبعيات Node.js ديالو، شغّل الإعداد الآلي، وصايب روابط الأوامر العامة:
git clone https://github.com/miuuyy/Astra-Ares.git
cd Astra-Ares
npm ci
npm run setup
npm link
الإعداد كيحمّل نسخة Codex محددة، كيطبّق التصحيح المرفق، وكيبنيها أوتوماتيكياً. ما محتاجش تعدّل Codex يدوياً.
الأمر npm link كيظهر جوج أوامر فالطرفية ديالك: astra-ares وares. النسخة التجريبية كتتوزّع من المصدر؛ حالياً ما كاين لا حزمة npm منشورة لا تحميل مسبق البناء ديال Ares. راجع وثائق التثبيت ديال المشروع باش تعرف المستجدات، وإعادة استعمال البناء، والحذف، والتشغيل بلا رابط عام.
الخطوة 2: إعداد مزوّد Jev
التثبيتات الجديدة كتستعمل OpenRouter كمزوّد افتراضي ديال Jev. صايب مفتاح OpenRouter API، وتأكد باللي الحساب فيه رصيد مموّل، وبدا واجهة الإعداد:
ares configure
لسّق المفتاح فالطلب المخفي. Astra-Ares كيخزّنو فإعدادات المستخدم الخاصة ديالك خارج المستودع المنسوخ.
بيانات اعتماد Jev منفصلة على حساب Codex اللي كتستعملو للوصول لـ Astra. إلا احتاج الـ CLI المصحّح للمصادقة، دخل بهاد الأمر:
astra-ares login
مزوّدو Jev الآخرين والخيارات ديال متغيّرات البيئة مشروحين فـ دليل الإعداد ديال المشروع.
الخطوة 3: تشغيل Codex بالاستدلال التكيّفي
شغّل طرفية Codex المصحّحة:
astra-ares
حلّ منتقي /model الأصلي واختار Astra-Jev. بروفايلات Ares الجديدة كتختار هاد المدخل افتراضياً. من بعد تقدر ترسل مهمة وتستعمل طريقة العمل العادية ديال Codex، بما فيها الأدوات، والموافقات، والإلغاء، والتاريخ.
ملي Jev كيبدّل مستوى المجهود وCodex كيأكد عليه، كيبان فالنص إشعار مشابه لهاد الشي:
Jev LOW → HIGH ✓ APPLIED
Step 3 · next 2 generation(s) · 321 ms
APPLIED ماشي غير إشعار بتوصية: كيعني باللي Codex أكد أن الإعدادات تطبّقات على الجيل الجاي. الإشعار كيبان من بعد التطبيق الأصلي.
أمثلة على الاستعمال الأساسي
فتح مستودع معيّن
استعمل -C باش تبدا الخدمة فمجلد مشروع محدد:
astra-ares -C /path/to/project
استئناف آخر جلسة ديال Ares
astra-ares resume --last
Ares كيستعمل بروفايل Codex بوحدو، وهاد الأمر كيعاود يفتح آخر سيشن من داك البروفايل، ماشي سيشن تابع لتثبيت Codex العادي.
بدّل مفتاح Jev
ares configure
عطّل Jev فسيشن وحدة
حلّ /model واختار Astra العادي ولا موديل آخر. Codex غادي يبقى خدام بلا توجيه Jev.
كيفاش كيخدم الاختيار التكيّفي
- Codex كيوصل لنقطة مراقبة مؤهلة قبل ما يتولّد موديل.
- Ares كيحضّر سياق محدود فيه المهمة، التقدّم العلني، والنشاط الأخير ديال الأدوات.
- Jev كيختار مستوى المجهود فالتفكير ومدة صلاحية فيها 1 ولا 2 ولا 5 ولا 10 ديال التوليدات.
- Codex كيطبّق الإعدادات المختارة باستعمال آلية الإعداد الأصلية ديال Astra.
- Astra كيولّد جواب وقد يستعمل أداة وحدة ولا كثر.
- Ares كيطلب قرار آخر ملي كتسالي مدة الصلاحية ولا كيوقع حدث كيلغيها.
الخطوة كتعني توليدة وحدة ديال الموديل، ماشي نداء واحد لأداة. التوليدة الواحدة تقدر تنتج عدة نداءات للأدوات. القرارات كتوقع قبل التوليدة الجاية، من بعد ما كيدخلو نتائج الأدوات المتاحة للمحادثة.
Jev كيقيّم شحال خاص من التفكير من بعد، بالنسبة لهدف المستخدم. مثلاً، قراية ملف ما كتعنيش بوحدها بلي المجهود خاصو يكون ضعيف، حيث تفسير الملف يقدر يكون هو الجزء الصعيب.
فهم مدد الصلاحية
إلا اختار Jev مدة صلاحية ديال عشر توليدات، Ares كيطلب قرار فالخطوة 1 ومن بعد فالخطوة 11. الخطوات من 2 حتى لـ10 كتعاد فيها نفس الاختيار المقبول بلا طلبات إضافية لـJev.
المدة كتسالي بكري إلا دخلات معطيات جديدة من المستخدم، ولا فشلات أداة، ولا تبدّل الموديل، ولا تبدّل مجهود التفكير يدوياً. من بعد كيتستاشر Jev فَنقطة المراقبة المؤهلة الجاية. فشل الأداة كيطلب إعادة التقييم؛ وما كيشعلش تصعيد محدد مسبقاً.
شنو كيوصل لـJev من السياق
Jev ما كيتوصلش بالسياق الداخلي الكامل وغير المحدود ديال Astra. المنظور ديال المُقيّم فيه:
- المهمة الأصلية ولا الحالية والطلبات السابقة المحتافظ بها ديال المستخدم
- التقدّم العلني، الخطط، وملخصات التفكير المنشورة
- آخر ستة ديال نداءات الأدوات والنتائج المرتابطة بها
- حتى لـ1,000 توكن محلي من مجموع نص النتائج لكل نداء أداة، باستعمال اقتطاع صريح من البداية والنهاية
- طلب كامل للمُقيّم محمي بحدّ ديال 28,000 توكن محلي
التفكير الخاص ولا المشفّر مستبعد. الطلبات الكبيرة بزاف للمُقيّم كتوقف بشكل صريح عوض ما تتصيفط فالصمت. المُرمّز المحلي كيعطي تقدير للميزانية وماشي بالضرورة مطابق للمُرمّز ديال Jev. هاد الحدود كتأثر غير على المنظور ديال Jev؛ أما Astra فكيبقى محتافظ بالمحادثة الأصلية ديالو.
سياق المهمة المحدود كيتصيفط لمزوّد Jev المهيّأ. راجع وثائق الإعداد والتسجيل قبل ما تستعمل بيانات حساسة ديال المشروع.
التشخيص وحلّ المشاكل
تأكّد من التثبيت المحلي
ares doctor
هاد الأمر كيتأكّد محلياً من التثبيت والإعداد، بلا ما يدير عمداً اختبار المزوّد اللي موصوف لتحت.
جرّب مزوّد Jev
ares doctor --probe
الاختبار كيدير طلب واحد صغير وقابل للفوترة لـJev. استعملو ملي كتدوز الفحوصات المحلية ولكن كاتفشل قرارات المُقيّم.
عاين سجلات القرارات
افتراضياً، سجلات التشغيل كتتخزّن فـ:
~/.local/share/astra-ares/runs/<run>/decisions.jsonl
هاد السجلات تقدر تعاون فمعرفة الطلبات الفاشلة للمزوّد، توقيت القرارات، والإعدادات اللي تطبّقات.
فسّر HTTP 429 بالطريقة الصحيحة
الرد HTTP 429 كيعني رفض بسبب المعدّل ولا السعة. بوحدو ما كيثبتش بلي سياق المُقيّم كبير بزاف. أخطاء HTTP المؤقتة كيتعاودو فيها المحاولة بحد أقصى ثلاث مرات ضد نفس المزوّد داخل مهلة 30 ثانية.
إلا فشلات جميع المحاولات، Ares كيوقف الدور الحالي بشكل باين. ما كينتاقلش فالصمت لمزوّد آخر، وما كيختارش موديل آخر، وما كيختلقش مستوى للمجهود. شوف دليل حلّ المشاكل ديال المستودع لمزيد من الفحوصات.
نصائح متقدمة
وازن بين سرعة الاستجابة وكلفة المُقيّم
كل قرار جديد ديال Jev كيضيف ذهاب وإياب مع المزوّد ومعالجة محلية لنقطة المراقبة. مادامت مدة الصلاحية خدامة، نقاط المراقبة كتتعالج محلياً بلا طلب آخر لـJev. لذلك المدد الأطول تقدر تنقص من وتيرة الطلبات، مع أن Jev، ماشي المستخدم، هو اللي كيختار المدة الموصوفة فالتنفيذ المرجعي.
استعمل تأكيدات باينة ملي كتتحقق من التكامل
ملي كتختبر السلوك التكيّفي، قلّب على الحالة APPLIED عوض ما تفترض بلي توصية Jev وصلات لـAstra. التأكيد كيتصدر غير من بعد ما كيطبّق Codex الإعداد الأصلي.
تذكّر حدود القياس الحالية
المشروع فيه اختبارات أصلية بتركيبات ثابتة لتطبيق الإعدادات والحفاظ على بادئة الطلب. ولكن ما تقاساتش حتى الآن معدلات إصابة ذاكرة التخزين المؤقت ديال أعباء العمل ولا الوفورات مقارنة مع مجهود تفكير ثابت. اعتبر ادعاءات الكفاءة هدفاً تصميمياً خاصو يتتحقق عليه فالأعباء ديالك.
شغّل حزمة اختبارات التطوير
المساهمون يقدرو يثبتو الاعتماديات ويشغلو الاختبارات العادية بهاد الشكل:
npm ci
npm test
اختبارات التكامل الأصلية كتحتاج بالإضافة لـBun والنسخة المرقّعة ديال Codex:
JEV_TEST_BINARY="$HOME/.local/share/astra-ares/bin/codex" npm run test:native
اختبارات التركيبات المحلية ما كتحتاج حتى مفاتيح API. مجموعات التحقق من المصدر الأصلي ونسخة الرقعة مثبتة فـpatches/upstream.json.
الخلاصة
كيبيّن Astra-Ares كيفاش يقدر واحد الوكيل يبدّل مجهود الاستدلال ديال GPT-6 Astra بين الأجيال، مع الحفاظ على المحادثة الموجودة، والاتصال المباشر بـ OpenAI، وبادئة الطلب الأصلية. الإعداد الآلي ديالو كيخلّي التجربة سهلة، ولكن باقي غير معاينة تقنية مبكّرة مبنية على Codex CLI منفصل ومصحّح. استعمل أدوات التشخيص ديالو، وراجع سجلات القرارات، وتحقّق من الأداء على أعباء الخدمة ديالك قبل ما تعتبره أداة يومية للتطوير.
