يعيد وكلاء البرمجة إرسال أجزاء كبيرة من مستودعك في كل جولة، لذا تتضخم الفوترة بالرمز (التوكن) بسرعة. أما جلسة الخطة غير المحدودة فتلغي العدّاد. تتبع هذه الخطوات إعداد Aider المتوافق مع OpenAI.
1. ثبّت Aider
python -m pip install aider-install
aider-install
2. وجّهه إلى BroadNet Inference
export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY='your-broadnet-plan-key'
على Windows، استخدم setx OPENAI_API_BASE https://inference.broadnet.ai/v1 وsetx OPENAI_API_KEY your-key، ثم افتح طرفية جديدة. يوصي توثيق Aider بإعادة تشغيل الصدفة بعد setx.
أبقِ /v1 في نهاية عنوان الأساس؛ فـ Aider يضيف مسار chat completions بنفسه.
3. شغّله على قاعدة الشيفرة
cd /path/to/your/project
aider --model openai/broadnet/deepseek-v4.1-flash
البادئة openai/ تطلب من Aider استخدام نقطة النهاية المتوافقة مع OpenAI، والباقي هو معرّف النموذج في BroadNet. سيعرض Aider التحذير: “Unknown context window size and costs, using sane defaults.” (ترجمة: حجم نافذة السياق والتكاليف غير معروفين، تُستخدم قيم افتراضية معقولة.) وهذا متوقع للنماذج غير الموجودة في قائمته المدمجة. وتقول صفحة تحذيرات النماذج إن هذا التحذير يمكن تجاهله عادةً.
4. اختياري: عرّف Aider بالنموذج
لإزالة التحذير وترك مساحة للنموذج كي يستدل، أضف ملفين إلى مجلدك الرئيسي أو إلى جذر المستودع. يقرأ Aider الملفين من أي من المكانين، كما يشرح توثيق الإعدادات المتقدمة للنماذج.
.aider.model.metadata.json:
{
"openai/broadnet/deepseek-v4.1-flash": {
"max_input_tokens": 1048576,
"litellm_provider": "openai",
"mode": "chat"
}
}
.aider.model.settings.yml:
- name: openai/broadnet/deepseek-v4.1-flash
edit_format: diff
extra_params:
max_tokens: 16000
صيغة التعديل الافتراضية في Aider للنماذج غير المعروفة هي whole، وهي تعيد إرسال الملفات كاملة. أما diff فترسل الكتل المعدّلة فقط. وإن فشل تطبيق التعديلات، فاحذف سطر edit_format للعودة إلى whole.
نصائح
- نافذة Aider واحدة، جلسة واحدة. إن شغّلت نسختين من Aider في الوقت نفسه، فاشترِ جلستين، وإلا انتظرت إحداهما الأخرى.
- الاستدلال يستهلك رموزًا. يستدل DeepSeek V4.1 Flash قبل أن يجيب، وBroadNet تحتسب ذلك ضمن
max_tokens. راجع لماذا تعود الإجابات فارغة. - جرّب ساعة أولًا. تكلّف خطة الشهاب (Meteor) $1 لساعة واحدة، وهذا يكفي للحكم عليها في مهمة حقيقية.
حل المشكلات
- 401 Unauthorized. المتغير
OPENAI_API_KEYمفقود أو خاطئ أو منتهي الصلاحية. تأكّد أن الصدفة التي تشغّل Aider تحمل المتغير؛ وعلى Windows افتح طرفية جديدة بعدsetx. - الطلبات تذهب إلى OpenAI بدلًا من BroadNet. المتغير
OPENAI_API_BASEغير مضبوط في هذه الصدفة، أو اسم النموذج ينقصه البادئةopenai/. شغّلecho $OPENAI_API_BASEللتحقق. - النموذج غير موجود. يجب أن يكون الجزء الذي يلي
openai/هوbroadnet/deepseek-v4.1-flashتمامًا. مفتاح الخطة يغطي DeepSeek V4.1 Flash فقط؛ أما نماذج BroadNet الأخرى فتحتاج إلى مفتاح دفع حسب الاستخدام. - ردود فارغة أو مبتورة. ارفع
max_tokensفي.aider.model.settings.ymlكما هو موضح أعلاه. - التعديلات لا تُطبَّق. أعد
edit_formatإلىwhole، أو جرّب--edit-format wholeفي سطر الأوامر. - ردود بطيئة أو 429. جلسة الخطة تشغّل طلبًا واحدًا في كل مرة، فتنتظر نافذة Aider الثانية في الطابور. ويسمح مفتاح الدفع حسب الاستخدام بـ 30 من الطلبات في الدقيقة و4 في آن واحد. راجع الأخطاء وإعادة المحاولة.
تفضّل وكيلًا داخل VS Code؟ راجع دليل إعداد Cline، أو قارن بينها في Cline مقابل Roo Code مقابل Aider.
