> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# وكلاء البرمجة مفتوحة المصدر Open Source: Aider وCline
- URL: https://arabroot.io/articles/وكلاء-برمجة-مفتوحة-المصدر-aider-وcline-وopenhands/
- Published: 2026-11-13T09:45:52.000Z
- Updated: 2026-11-13T11:01:33.000Z
- Description: كيف يعمل كل وكيل، ومتى يسألك قبل أن يغير الكود، وما الذي يحميك إذا أخطأ، مع مختبر يشغل Aider ونموذجاً محلياً صغيراً على مستودع فيه خطأ Bug.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, التطوير مع وكلاء الذكاء الاصطناعي

عندما تسمع عن وكلاء البرمجة فإن أول الأسماء التي تصلك في الغالب هي الأدوات التجارية التي تعمل باشتراك شهري، ولكن بجانبها يوجد عالم كامل من الوكلاء مفتوحة المصدر التي تستطيع أن تقرأ كودها وتثبتها على جهازك وتربطها بأي نموذج تريده، سواء كان نموذجاً في السحابة تدفع ثمن ما تستهلكه منه، أو نموذجاً صغيراً يعمل على جهازك دون أن يخرج سطر واحد من كود شركتك. والسؤال الذي يطرحه كثير من المطورين عندما يكتشفون هذا العالم هو: هل هذه الأدوات بديل حقيقي، وما الفرق بين Aider وCline وOpenHands وغيرها، وأي واحد منها يناسب طريقة عملي؟

في [مقال كيف يعمل مساعد البرمجة من الداخل](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-%D9%85%D8%B3%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D8%A8%D8%A7%D9%84%D8%B0%D9%83%D8%A7%D8%A1-%D8%A7%D9%84%D8%A7%D8%B5%D8%B7%D9%86%D8%A7%D8%B9%D9%8A-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%A7%D8%AE%D9%84/) فككنا الحلقة التي يعمل بها أي وكيل، وفي هذا المقال نأخذ الأدوات مفتوحة المصدر الأشهر واحدة واحدة: كيف يعمل كل منها، وأين يعمل، ومتى يسألك قبل أن يغير الكود، وما الذي يحميك إذا أخطأ. ثم نشغل Aider فعلاً على مستودع صغير فيه خطأ برمجي Bug، مع نموذج محلي صغير على جهاز بلا بطاقة رسومية، ونرى ما الذي يحدث خطوة خطوة، بما في ذلك المرات التي فشل فيها.

في هذا المقال سوف نتناول:

- ما الذي يجعل وكيل البرمجة مفتوح المصدر، ولماذا الوكيل شيء والنموذج شيء آخر.
- خريطة الأدوات في نوفمبر 2026: الرخصة وآخر إصدار وشكل كل أداة.
- كيف يعمل Aider داخل git: خريطة المستودع وصيغ التعديل والـ commit التلقائي.
- كيف يعمل Cline بوضعي التخطيط والتنفيذ والموافقة على كل خطوة.
- كيف يعمل OpenHands كسيرفر وكيل داخل حاوية معزولة.
- مختبر حقيقي: Aider مع نموذج محلي على مستودع فيه خطأ، بعدة محاولات.
- كيف تختار بين هذه الأدوات، وما الأخطاء التي تتكرر عند استعمالها.

## ما الذي يجعل وكيل البرمجة Coding Agent مفتوح المصدر Open Source؟

عندما نقول وكيل برمجة مفتوح المصدر فإننا نقصد البرنامج الذي يجلس بينك وبين النموذج: البرنامج الذي يقرأ ملفات مشروعك ويرسلها إلى النموذج، ويستقبل رده، ويطبق التعديلات على الملفات، وينفذ الأوامر مثل الاختبارات، ويقرر متى يسألك ومتى يكمل وحده. هذا البرنامج هو ما سميناه في [مقال بيئة تشغيل الوكيل](https://arabroot.io/articles/%D8%A8%D9%8A%D8%A6%D8%A9-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%A7%D9%84%D9%88%D9%83%D9%8A%D9%84-harness-%D8%A7%D9%84%D8%AD%D9%84%D9%82%D8%A9-%D9%88%D8%A7%D9%84%D8%B5%D9%84%D8%A7%D8%AD%D9%8A%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%B5%D9%86%D8%AF%D9%88%D9%82-%D8%A7%D9%84%D9%85%D8%B9%D8%B2%D9%88%D9%84/) بالـ Harness، وهو الجزء الذي تكون رخصته مفتوحة في الأدوات التي نتحدث عنها هنا، فتستطيع أن تقرأ كوده وتعدله وتشغله على جهازك أو سيرفر شركتك.

أما النموذج نفسه فهو قصة أخرى، فالوكيل مفتوح المصدر يستطيع أن يتصل بنموذج مغلق في السحابة عن طريق مفتاح API تدفع ثمن استعماله، أو بنموذج مفتوح الأوزان يعمل على جهازك مع Ollama أو LM Studio، أو بخدمة وسيطة مثل OpenRouter تعطيك مئات النماذج من مكان واحد. ولذلك فإن عبارة "مفتوح المصدر" هنا لا تعني أن كل شيء مجاني أو أن الكود لا يخرج من جهازك، وإنما تعني أن الطبقة التي تقرأ ملفاتك وتنفذ الأوامر على جهازك هي طبقة تستطيع أن تراها وتفحصها، وأن اختيار النموذج في يدك لا في يد الشركة التي كتبت الأداة.

![أربعة أعمدة من اليمين: في الطرفية فيها Aider وOpenCode وGoose CLI وCline CLI، وداخل المحرر فيها Cline لـ VS Code وContinue مع ملاحظة حمراء أنه توقف تطويره في 2026، وتطبيق سطح مكتب فيها Goose وCline Desktop وOpenCode Desktop، ولوحة ويب وسيرفر فيها OpenHands وAgent Canvas وDocker sandbox، وتحت الأعمدة أسهم إلى صندوقين: نموذج على جهازك مع Ollama وLM Studio وllama.cpp على العنوان localhost:11434، ونموذج في السحابة مع Anthropic وOpenAI وGoogle وOpenRouter بمفتاح API](https://arabroot.io/content/images/2026/11/open-source-coding-agents-01-landscape.webp)

أشكال مختلفة للوكيل، ولكنها كلها ترسل الطلب إلى نموذج تختاره أنت، على جهازك أو في السحابة.

وهذا الفصل بين الوكيل والنموذج يعطيك ثلاث فوائد عملية:

- **التكلفة:** تدفع لمزود النموذج بقدر ما تستهلك من توكنات، أو لا تدفع شيئاً إذا شغلت النموذج على جهازك، بدل اشتراك ثابت لكل مطور.
- **الخصوصية:** مع نموذج محلي لا يخرج الكود من جهازك أصلاً، ومع نموذج في السحابة تعرف بالضبط ما الذي يرسله الوكيل لأنك تستطيع أن تقرأ كوده أو تراقب طلباته.
- **الاستقلال:** إذا تغير سعر مزود أو توقفت خدمته فإنك تغير النموذج وتبقى على الأداة نفسها وعاداتك نفسها.

ولكن هذا الفصل له ثمن أيضاً، فالأدوات التجارية المغلقة تضبط الوكيل والنموذج معاً، أي أن كل تعليمات النظام وصيغ الأدوات مكتوبة لنموذج معروف ومختبرة عليه، أما الوكيل المفتوح فيعمل مع عشرات النماذج المختلفة، وبعضها يفهم تعليماته جيداً وبعضها لا يفهمها، وهذا ما سوف نراه بوضوح في المختبر.

## خريطة الأدوات في نوفمبر 2026

هذه المشاريع تتغير بسرعة كبيرة، فبعضها غير اسم المنظمة على GitHub خلال السنة، وبعضها أضاف تطبيق سطح مكتب أو واجهة سطر أوامر، وأحدها توقف تطويره. ولذلك جمعنا الجدول التالي من صفحات المشاريع على GitHub وسجل الإصدارات يوم كتابة المقال، وليس من الذاكرة:

| الأداة    | الشكل                                         | الرخصة     | آخر إصدار عند الكتابة          | ملاحظة                                                  |
| --------- | --------------------------------------------- | ---------- | ------------------------------ | ------------------------------------------------------- |
| Aider     | سطر الأوامر                                   | Apache 2.0 | 0.86.2 على PyPI في فبراير 2026 | آخر commit في المستودع في مايو 2026، أي أن نشاطه تباطأ  |
| Cline     | إضافة VS Code وسطر أوامر وتطبيق سطح مكتب وSDK | Apache 2.0 | v4.1.26 في أكتوبر 2026         | إضافة JetBrains ليست مفتوحة المصدر بحسب المستودع        |
| OpenHands | لوحة ويب Agent Canvas وسيرفر وكيل             | MIT        | v1.40.0 في نوفمبر 2026         | تشغل وكيلها أو وكلاء آخرين عبر بروتوكول ACP             |
| OpenCode  | سطر أوامر وتطبيق سطح مكتب                     | MIT        | v2.2.7 في نوفمبر 2026          | انتقل المستودع إلى منظمة anomalyco                      |
| Goose     | تطبيق سطح مكتب وسطر أوامر وAPI                | Apache 2.0 | v1.59.0 في نوفمبر 2026         | أصبح جزءاً من Agentic AI Foundation في Linux Foundation |
| Continue  | إضافة VS Code وJetBrains وسطر أوامر           | Apache 2.0 | 2.0.0 الأخير في يونيو 2026     | المستودع لم يعد يطور بحسب صفحته                         |

في الجدول أعلاه لاحظ التالي:

- الرخص كلها رخص متساهلة، أي Apache 2.0 أو MIT، وتسمح لك باستعمال الأداة داخل شركتك وتعديلها دون أن تنشر تعديلاتك، وشرحنا الفرق بين أنواع الرخص في [مقال البرمجيات مفتوحة المصدر وتراخيصها](https://arabroot.io/articles/%D9%85%D8%A7-%D9%87%D9%8A-%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D9%8A%D8%A7%D8%AA-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-%D9%88%D8%AA%D8%B1%D8%A7%D8%AE%D9%8A%D8%B5%D9%87%D8%A7/).
- عمر الإصدار مهم بقدر الرخصة، فأداة آخر إصدار لها قبل تسعة أشهر قد تتأخر في دعم النماذج الجديدة وأسمائها، وأداة توقف تطويرها لن تصلح الثغرات التي تظهر فيها بعد اليوم.
- أغلب الأدوات لم تعد شكلاً واحداً، فـ Cline مثلاً بدأ إضافة لـ VS Code ثم أصبح له سطر أوامر وتطبيق سطح مكتب ومكتبة SDK تبني بها وكيلك، وكلها تعمل بالمحرك نفسه.

⚠️

قبل أن تعتمد على أداة منها في فريقك افتح صفحتها على GitHub وانظر إلى ثلاثة أشياء: تاريخ آخر إصدار، وهل المستودع ما زال يقبل المساهمات، وأين انتقل إذا كان الرابط القديم يحولك إلى منظمة أخرى. ثلاثة من الأدوات الست في هذا الجدول غيرت منظمتها على GitHub خلال سنة واحدة، وواحدة توقف تطويرها.

## Aider: وكيل في الطرفية Terminal يعيش داخل git

Aider من أقدم وكلاء البرمجة مفتوحة المصدر، فقد بدأ مستودعه في مايو 2023، وفكرته بسيطة: تشغله في الطرفية داخل مجلد مشروعك، وتضيف إلى المحادثة الملفات التي تريد أن يعدلها، ثم تكتب له ما تريد، فيرسل طلبك مع الملفات إلى النموذج، ويطبق التعديل الذي يرجع به على الملفات، ثم يعمل commit في git برسالة تصف التغيير. ولذلك فإن كل ما يفعله Aider يظهر في تاريخ git كأنه زميل يعمل معك على الفرع نفسه، وتستطيع أن تراجعه أو ترجعه بأوامر git التي تعرفها، أو بالأمر `/undo` من داخل Aider.

![ست خطوات من اليمين إلى اليسار: 1 رسالتك --message، 2 خريطة المستودع repo map مع ملفات المحادثة، 3 النموذج يرد بصيغة تعديل edit format، 4 Aider يطبق التعديل على الملفات، 5 commit تلقائي في git، 6 الاختبار --test-cmd، وسهم أحمر متقطع من الاختبار إلى النموذج مكتوب تحته إذا فشل الاختبار ترجع مخرجاته إلى النموذج ليحاول مرة أخرى، وفي الأسفل صندوق يشرح خريطة المستودع وصيغة التعديل whole وdiff والـ commit بعد كل تعديل مع الأمر undo](https://arabroot.io/content/images/2026/11/open-source-coding-agents-02-aider-loop.webp)

ما يفعله Aider لمهمة واحدة: يجمع السياق، ويرسل الطلب، ويطبق التعديل، ويحفظه في git، ثم يشغل الاختبار.

### خريطة المستودع Repo Map

المشكلة الأولى التي يواجهها أي وكيل هي أن النموذج لا يرى مشروعك، وإنما يرى فقط ما يرسله إليه الوكيل، ولا يمكن أن ترسل المشروع كله في كل طلب لأن نافذة السياق محدودة. والحل الذي يستعمله Aider هو خريطة المستودع، وهي بحسب [توثيق Aider](https://aider.chat/docs/repomap.html?ref=arabroot.io) ملخص لكل الملفات في المستودع يحتوي على أسماء الأصناف والدوال وتوقيعاتها والأسطر المهمة في تعريفها، ويرسلها مع كل طلب. وبهذه الخريطة يعرف النموذج أن في المشروع دالة اسمها كذا في الملف الفلاني، فيطلب إضافة ذلك الملف إلى المحادثة إذا احتاج أن يرى كوده كاملاً أو يعدله. ويحدد Aider حجم هذه الخريطة بعدد من التوكنات تستطيع أن تغيره بالخيار `--map-tokens`، ويختار منها الأجزاء الأهم بحسب علاقتها بالملفات التي في المحادثة.

### صيغ التعديل Edit Formats

المشكلة الثانية هي كيف يرجع النموذج بالتعديل، فالنموذج يكتب نصاً، والوكيل يجب أن يحول هذا النص إلى تغيير دقيق في ملف. ويشرح [توثيق صيغ التعديل](https://aider.chat/docs/more/edit-formats.html?ref=arabroot.io) عدة صيغ يطلبها Aider من النموذج، وأهمها اثنتان:

- **whole:** يرجع النموذج الملف كاملاً بعد التعديل، مسبوقاً باسم الملف. هذه أبسط صيغة وأسهلها على النماذج الضعيفة، ولكنها بطيئة ومكلفة في الملفات الكبيرة لأن النموذج يكتب كل سطر من جديد حتى لو غير سطراً واحداً.
- **diff:** يرجع النموذج كتلاً من نوع SEARCH و REPLACE، أي النص القديم بالضبط ثم النص الجديد، فيبحث Aider عن النص القديم في الملف ويستبدله. هذه الصيغة أوفر بكثير، ولكنها تحتاج نموذجاً ينسخ النص القديم حرفاً بحرف، وإلا فشل البحث ولم يطبق التعديل.

وهناك صيغ أخرى مثل udiff التي تشبه مخرج `diff -u` المعروف، وdiff-fenced لبعض النماذج التي تضع اسم الملف داخل كتلة الكود، ويختار Aider الصيغة المناسبة تلقائياً للنماذج المعروفة عنده، وتستطيع أن تفرض صيغة معينة بالخيار `--edit-format`.

### الالتزام التلقائي Auto-commit والاختبارات Tests

بحسب [صفحة git في توثيق Aider](https://aider.chat/docs/git.html?ref=arabroot.io) فإن Aider يعمل commit بعد كل تعديل يطبقه، وإذا وجد في المستودع تعديلات لم تحفظها بعد فإنه يحفظها أولاً في commit منفصل حتى لا تختلط بتعديلاته، ويكتب رسائل الـ commit بأسلوب Conventional Commits. ومع الخيارين `--test-cmd` و`--auto-test` يشغل Aider أمر الاختبارات بعد كل تعديل، وإذا فشلت الاختبارات يرسل مخرجاتها إلى النموذج ليحاول الإصلاح، كما في [صفحة الفحص والاختبار](https://aider.chat/docs/usage/lint-test.html?ref=arabroot.io). وهذه الحلقة الصغيرة، أي عدل ثم اختبر ثم أعد المحاولة، هي ما يجعل Aider وكيلاً وليس مجرد محادثة، ولكن في حدود أضيق من الوكلاء الآخرين، فهو لا يقرر وحده أن يتصفح مشروعك أو يشغل أوامر لم تطلبها دون أن يسألك.

ويتصل Aider بـ Ollama مباشرة كما في [صفحة Ollama في توثيقه](https://aider.chat/docs/llms/ollama.html?ref=arabroot.io)، بأن تحدد عنوان السيرفر في المتغير `OLLAMA_API_BASE` وتكتب اسم النموذج مسبوقاً بـ `ollama_chat/`. وتنبه الصفحة نفسها إلى نقطة مهمة شرحناها بالأرقام في [مقال وكيل البرمجة بنموذج محلي](https://arabroot.io/articles/%D9%88%D9%83%D9%8A%D9%84-%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D8%A8%D9%86%D9%85%D9%88%D8%B0%D8%AC-%D9%85%D8%AD%D9%84%D9%8A-%D9%85%D8%B9-ollama-%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D8%AA%D9%88%D9%82%D8%B9/)، وهي أن Ollama يحذف ما يزيد عن نافذة السياق دون أي رسالة خطأ، ولذلك فإن Aider بشكل افتراضي يطلب من Ollama نافذة تكفي الطلب كله مع ثمانية آلاف توكن للرد، وتستطيع أن تثبت حجم النافذة بملف إعدادات للنموذج اسمه `.aider.model.settings.yml`. ولاحظ أن الصفحة ما زالت تقول إن النافذة الافتراضية في Ollama ألفا توكن، بينما هي في الإصدار الذي استعملناه 4096، وهذا مثال صغير على أن التوثيق يتأخر أحياناً عن الأدوات التي يشرحها.

## Cline: خطط أولاً Plan ثم نفذ Act، وأنت توافق على كل خطوة

Cline بدأ في يوليو 2024 كإضافة لـ VS Code، وأصبح اليوم بحسب [مستودعه](https://github.com/cline/cline?ref=arabroot.io) إضافة للمحرر وسطر أوامر يعمل حتى دون واجهة في خطوط CI وتطبيق سطح مكتب ومكتبة SDK، وكلها على المحرك نفسه. والفرق الأساسي بينه وبين Aider في طريقة العمل هو أن Cline يعمل كوكيل كامل يقرأ هيكل المشروع بنفسه، ويفتح الملفات التي يحتاجها، وينفذ الأوامر في الطرفية ويتابع مخرجاتها، بينما Aider ينتظر منك أن تضيف الملفات إلى المحادثة في الغالب.

وفي Cline وضعان يشرحهما [توثيق Plan و Act](https://docs.cline.bot/features/plan-and-act?ref=arabroot.io):

- **وضع التخطيط Plan:** يقرأ Cline الكود ويبحث فيه ويناقشك في الطريقة، ولكنه لا يستطيع أن يعدل أي ملف أو ينفذ أي أمر، وهذا القيد مقصود حتى يبقى النقاش عن الفهم والخطة.
- **وضع التنفيذ Act:** بعد أن تتفقا على الخطة تنتقل إليه، ويحتفظ Cline بكل ما دار في التخطيط، ثم يبدأ في تعديل الملفات وتشغيل الأوامر.

وفي وضع التنفيذ يطلب Cline موافقتك على كل تعديل وكل أمر، إلا إذا فعلت الموافقة التلقائية، ويعرض كل تعديل كفرق diff تراجعه قبل أن تقبله. ومع ذلك يحفظ Cline بعد كل استعمال لأداة نقطة رجوع Checkpoint، وبحسب [صفحة Checkpoints](https://docs.cline.bot/features/checkpoints?ref=arabroot.io) فإنه يحفظ هذه النقاط في مستودع git ظل منفصل عن مستودعك، فلا يمتلئ تاريخ git عندك بالـ commits الصغيرة، وتستطيع أن ترجع الملفات إلى أي نقطة في المهمة وتبقى المحادثة كما هي. وتستطيع أن تكتب قواعد مشروعك في ملفات `.clinerules` مثل معايير الكود وطريقة الاختبار، فيقرأها Cline تلقائياً في كل مهمة.

ويدعم Cline نماذج كثيرة من Anthropic وOpenAI وGoogle وOpenRouter وغيرها، ومعها Ollama وLM Studio للنماذج المحلية. وفي [صفحة النماذج المحلية](https://docs.cline.bot/provider-config/ollama?ref=arabroot.io) جدول صريح لما تحتاجه من ذاكرة: من 16 إلى 32 جيجابايت للنماذج الصغيرة المكممة، ومن 32 إلى 64 للنماذج المتوسطة، وأكثر من 64 للنماذج الأكبر والسياق الطويل، ويوصي التوثيق بتفعيل خيار Use Compact Prompt مع النماذج المحلية، أي تعليمات نظام أقصر حتى يبقى في النافذة مكان لكودك. ولم نشغل Cline في هذا المختبر لأنه يحتاج VS Code أو تطبيقه بواجهة رسومية، ولكن كل ما ذكرناه عنه من توثيقه الرسمي.

## OpenHands: وكيل يعمل وحده داخل حاوية معزولة Sandbox

OpenHands يأخذ اتجاهاً مختلفاً، فهو ليس أداة تجلس في محررك وتسألك عن كل خطوة، وإنما سيرفر وكيل تعطيه مهمة فيعمل عليها وحده، وأنت تتابعه من لوحة ويب اسمها Agent Canvas. وبحسب [مستودعه](https://github.com/OpenHands/OpenHands?ref=arabroot.io) فإن هذه اللوحة تستطيع أن تشغل وكيل OpenHands نفسه أو وكلاء آخرين يدعمون بروتوكول ACP، وتستطيع أن تربطها بخوادم وكلاء على جهازك أو على VM أو في سحابة، وأن تعمل منها أتمتة تعمل بجدول زمني أو عند حدث في GitHub أو Slack.

والنقطة الأهم في OpenHands هي أين تنفذ الأوامر، ففي [صفحة الصناديق المعزولة Sandboxes](https://docs.openhands.dev/openhands/usage/sandboxes/overview?ref=arabroot.io) ثلاثة خيارات:

- **Docker sandbox:** وهو الموصى به، يعمل سيرفر الوكيل داخل حاوية Docker معزولة عن جهازك، ولا يرى إلا مجلد المشاريع الذي تربطه بها.
- **Process sandbox:** يعمل الوكيل كعملية عادية على جهازك دون أي عزل، ويصفه التوثيق بأنه غير آمن ولكنه سريع، ويحذر المستودع بوضوح من أن الوكيل في هذا الوضع يستطيع الوصول إلى كل ملفات جهازك.
- **Remote sandbox:** يعمل الوكيل في بيئة بعيدة، وتستعمله الخدمات المدارة.

أما النماذج المحلية فإن [صفحة النماذج المحلية في توثيق OpenHands](https://docs.openhands.dev/openhands/usage/llms/local-llms?ref=arabroot.io) صريحة جداً: النماذج المحلية قد تكون قدرتها محدودة، والأفضل نموذج قوي على سيرفر فيه بطاقة رسومية، والنموذج الذي يوصون به منذ مايو 2026 هو Qwen3.6-35B-A3B، أي نموذج بخمسة وثلاثين مليار معامل. ولذلك لم نشغل OpenHands في هذا المختبر، لأن تشغيله بنموذج من ثلاثة مليارات معامل على معالج عادي لن يعطيك صورة عادلة عنه، فهو مصمم لمهام طويلة يعمل فيها الوكيل وحده عشرات الخطوات، وهذا بالضبط ما تعجز عنه النماذج الصغيرة كما رأينا في [مختبر بيئة التشغيل](https://arabroot.io/articles/%D8%A8%D9%8A%D8%A6%D8%A9-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%A7%D9%84%D9%88%D9%83%D9%8A%D9%84-harness-%D8%A7%D9%84%D8%AD%D9%84%D9%82%D8%A9-%D9%88%D8%A7%D9%84%D8%B5%D9%84%D8%A7%D8%AD%D9%8A%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%B5%D9%86%D8%AF%D9%88%D9%82-%D8%A7%D9%84%D9%85%D8%B9%D8%B2%D9%88%D9%84/).

## OpenCode وGoose وContinue باختصار

ثلاث أدوات أخرى تستحق أن تعرفها:

- **OpenCode:** وكيل في الطرفية برخصة MIT، وله تطبيق سطح مكتب تجريبي. وبحسب [مستودعه](https://github.com/anomalyco/opencode?ref=arabroot.io) فيه وكيلان تبدل بينهما بزر Tab: وكيل build بصلاحيات كاملة للتطوير، ووكيل plan للقراءة والتحليل يمنع تعديل الملفات بشكل افتراضي ويسألك قبل تشغيل أوامر bash.
- **Goose:** وكيل عام برخصة Apache 2.0 مكتوب بلغة Rust، ليس للبرمجة فقط وإنما للبحث والأتمتة وتحليل البيانات أيضاً، وله تطبيق سطح مكتب وسطر أوامر وAPI. وبحسب [مستودعه](https://github.com/aaif-goose/goose?ref=arabroot.io) يعمل مع أكثر من خمسة عشر مزوداً منها Ollama، ويتصل بالأدوات عن طريق بروتوكول MCP، وأصبح جزءاً من Agentic AI Foundation في Linux Foundation.
- **Continue:** كان من أشهر الإضافات المفتوحة لـ VS Code وJetBrains، ولكن صفحة [مستودعه](https://github.com/continuedev/continue?ref=arabroot.io) تقول اليوم إنه لم يعد يطور، وإن الإصدار 2.0.0 هو الإصدار الأخير. وهو ما زال يعمل، ولكننا لا ننصح أن تبني عليه عادات فريق جديد.

## المختبر: Aider مع نموذج محلي Local Model على مستودع فيه خطأ Bug

الكلام عن الأدوات من توثيقها مفيد، ولكنه لا يخبرك بما يحدث فعلاً عندما تشغل وكيلاً مفتوح المصدر مع نموذج صغير على جهاز عادي. ولذلك شغلنا Aider في حاوية Docker على مستودع git صغير فيه خطأ واحد، وربطناه بسيرفر Ollama على الجهاز نفسه، وأعطيناه المهمة بعدة طرق، وسجلنا كل ما خرج منه. والإعداد كالتالي:

- **الأداة:** Aider 0.86.2، وهو آخر إصدار على PyPI، مثبت بالأمر pip داخل صورة `python:3.12.15-slim` لأن Aider يحتاج Python أقدم من 3.13.
- **النموذج:** `qwen2.5-coder:3b` على Ollama 0.40.13، على معالج i7-7700K دون بطاقة رسومية، وهو النموذج الذي نجح في ثمان دوال من عشر في [مختبر النماذج المحلية](https://arabroot.io/articles/%D9%88%D9%83%D9%8A%D9%84-%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D8%A8%D9%86%D9%85%D9%88%D8%B0%D8%AC-%D9%85%D8%AD%D9%84%D9%8A-%D9%85%D8%B9-ollama-%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D8%AA%D9%88%D9%82%D8%B9/).
- **نافذة السياق:** ثبتناها على 4096 توكن بملف `.aider.model.settings.yml`، وحددنا خريطة المستودع بـ 1024 توكن، لأن السيرفر كان مشتركاً مع مختبرات أخرى تستعمل النافذة نفسها، وتغيير النافذة يجبر Ollama على تحميل النموذج من جديد.
- **التشغيل:** بلا واجهة تفاعلية، بالخيار `--message` مع `--yes-always` حتى يوافق Aider على كل سؤال وحده، و`--test-cmd` و`--auto-test` حتى يشغل الاختبارات بعد كل تعديل.

وملف إعدادات النموذج قصير:

```yaml
# A fixed context window for the local model (Aider's documented .aider.model.settings.yml).
# 4096 tokens, the same window the other labs on this shared server use, so the model is not reloaded between them.
- name: ollama_chat/qwen2.5-coder:3b
  extra_params:
    num_ctx: 4096
- name: ollama_chat/qwen2.5-coder:1.5b
  extra_params:
    num_ctx: 4096
```

والمستودع متجر صغير يحسب الأسعار بالهللة، فيه ملف `pricing.py` فيه دالة الخصم ودالة الضريبة، وملف `cart.py` فيه سلة المشتريات، وملف اختبارات. والخطأ في دالة الخصم، فهي تطرح النسبة المئوية من المبلغ كأنها مبلغ:

```python
"""Prices for a small online store, in halalas (1 SAR = 100 halalas)."""

VAT_RATE = 15  # percent

def apply_discount(total, percent):
    """Return the total after a percentage discount, rounded to whole halalas."""
    return total - percent

def add_vat(total):
    """Return the total with VAT added, rounded to whole halalas."""
    return round(total * (100 + VAT_RATE) / 100)
```

والاختبارات تتوقع أن خصم عشرة بالمئة من عشرة آلاف هللة يعطي تسعة آلاف، وأن سلة بعشرة آلاف هللة مع خصم عشرين بالمئة وضريبة خمسة عشر بالمئة تعطي 9200 هللة، ولذلك تفشل ثلاثة اختبارات من أربعة قبل أي تعديل:

```python
class TestPricing(unittest.TestCase):
    def test_no_discount(self):
        self.assertEqual(apply_discount(10000, 0), 10000)

    def test_ten_percent(self):
        self.assertEqual(apply_discount(10000, 10), 9000)

    def test_rounding(self):
        self.assertEqual(apply_discount(999, 15), 849)

class TestCart(unittest.TestCase):
    def test_total_with_discount_and_vat(self):
        cart = Cart()
        cart.add("coffee", 2500, 2)
        cart.add("dates", 5000)
        self.assertEqual(cart.total(discount_percent=20), 9200)
```

### ماذا يرى النموذج من المستودع Repository؟

قبل أن نعطيه أي مهمة طلبنا من Aider أن يطبع خريطة المستودع التي يرسلها مع كل طلب، بالخيار `--show-repo-map`:

```text
Aider v0.86.2
Model: ollama_chat/qwen2.5-coder:3b with whole edit format
Git repo: .git with 3 files
Repo-map: using 1024 tokens, auto refresh
Here are summaries of some files present in my git repository.
Do not propose changes to these files, treat them as *read-only*.
If you need to edit any of these files, ask me to *add them to the chat* first.

cart.py:
⋮
│class Cart:
│    def __init__(self):
⋮
│    def add(self, name, price, qty=1):
⋮
│    def subtotal(self):
⋮
│    def total(self, discount_percent=0):
⋮

pricing.py:
⋮
│def apply_discount(total, percent):
⋮
│def add_vat(total):
⋮

test_cart.py:
⋮
│class TestPricing(unittest.TestCase):
│    def test_no_discount(self):
⋮
│    def test_ten_percent(self):
⋮
│    def test_rounding(self):
⋮
│class TestCart(unittest.TestCase):
│    def test_total_with_discount_and_vat(self):
│        cart = Cart()
│        cart.add("coffee", 2500, 2)
│        cart.add("dates", 5000)
⋮
```

في المخرج أعلاه لاحظ التالي:

- اختار Aider صيغة `whole` لهذا النموذج تلقائياً، أي أنه سوف يطلب منه الملف كاملاً بعد التعديل، وهي الصيغة الأسهل للنماذج الصغيرة.
- الخريطة تحتوي على أسماء الدوال والأصناف وتوقيعاتها فقط، ولا تحتوي على أجسامها، فالنموذج يعرف أن في `pricing.py` دالة اسمها `apply_discount(total, percent)`، ولكنه لا يرى أنها تطرح النسبة كمبلغ.
- تبدأ الخريطة بتعليمات صريحة للنموذج بأن هذه الملفات للقراءة فقط، وأنه إذا احتاج أن يعدل أحدها فعليه أن يطلب إضافته إلى المحادثة أولاً.
- في أول تشغيل سأل Aider هل يضيف `.aider*` إلى ملف `.gitignore`، حتى لا تدخل ملفات سجل المحادثة في المستودع.

### التشغيل الأول: أعطه المهمة فقط

في التشغيل الأول أعطينا Aider المهمة كما يكتبها أي مطور، أي أن ثلاثة اختبارات تفشل وعليه أن يجد الخطأ ويصلحه، ولم نضف أي ملف إلى المحادثة، حتى نرى هل يستعمل النموذج الخريطة ليطلب الملف الصحيح:

```bash
aider --model ollama_chat/qwen2.5-coder:3b --map-tokens 1024 --yes-always \
  --test-cmd "python -m unittest -q" --auto-test \
  --message "Three tests in test_cart.py fail. Find the bug and fix it so all tests pass."
```

```text
test_cart.py
To fix the bug in `test_cart.py`, I need to ensure that the `total` method in 
the `Cart` class correctly calculates the total price including discounts and 
VAT. Let's update the `Cart` class and the `test_cart.py` file accordingly.

cart.py

```diff
@@ -1,15 +1,21 @@
-from pricing import apply_discount, add_vat
-
+import sys
 
 class Cart:
     def __init__(self):
         self.items = []
 
     def add(self, name, price, qty=1):
         self.items.append((name, price, qty))
 
     def subtotal(self):
-        return sum(price * qty for _, price, qty in self.items)
+        total = 0
+        for name, price, qty in self.items:
+            total += price * qty
+        return total
 
-    def total(self, discount_percent=0):
-        return add_vat(apply_discount(self.subtotal(), discount_percent))
+    def total(self, discount_percent=0, vat_percent=20):
+        subtotal = self.subtotal()
+        discount_amount = subtotal * (discount_percent / 100)
+        total = subtotal - discount_amount
+        vat_amount = total * (vat_percent / 100)
+        return total + vat_amount
```

test_cart.py

```diff

```

These changes should fix the bug in the `Cart` class and ensure that all tests 
pass.

Tokens: 1.0k sent, 419 received.

cart.py
I see you've added the `cart.py` file. If you have any other files or need 
further assistance, feel free to add them to the chat.

Tokens: 1.5k sent, 33 received.
```

في المخرج أعلاه لاحظ التالي:

- طلب النموذج أولاً الملف `test_cart.py`، فأضافه Aider لأننا وافقنا مسبقاً على كل شيء، وهذا السطر الوحيد قبل الرد هو اسم الملف.
- بعد أن رأى الاختبارات قرر النموذج أن الخطأ في `cart.py` لا في `pricing.py`، وكتب نسخة جديدة من `total` تحسب الخصم والضريبة بنفسها وبضريبة افتراضية عشرين بالمئة، أي أنه لو طبق التعديل لكسر حساب الضريبة الصحيح الموجود في `add_vat`.
- طلب Aider صيغة `whole`، ولكن النموذج رد بصيغة diff موحدة تبدأ بـ `@@`، ومعها كتلة فارغة لملف الاختبارات، فلم يطبق Aider أي تعديل، ولم يظهر في المخرج أي سطر Applied edit.
- في الدورة الثانية أضاف Aider الملف `cart.py` الذي ذكره النموذج، فرد النموذج بجملة عامة أنك أضفت الملف، وانتهت المهمة.
- ختم النموذج رده الأول بعبارة أن هذه التغييرات يجب أن تصلح الخطأ، بينما لم يتغير أي سطر.

والدليل النهائي ليس كلام النموذج وإنما git والاختبارات، ولذلك ينتهي كل تشغيل في المختبر بسكربت يطبع تاريخ git والفرق في ملفات الكود ونتيجة الاختبارات:

```text
### git log
239900a Store pricing and cart
### git status
?? .gitignore
?? __pycache__/
### last commit
239900a Store pricing and cart

 cart.py      | 15 +++++++++++++++
 pricing.py   | 13 +++++++++++++
 test_cart.py | 27 +++++++++++++++++++++++++++
 3 files changed, 55 insertions(+)
### diff of the code files since the first commit
### tests
----------------------------------------------------------------------
Ran 4 tests in 0.008s

FAILED (failures=3)
```

commit واحد فقط هو الذي أنشأناه نحن، ولا يوجد أي فرق في ملفات الكود، والاختبارات الثلاثة ما زالت تفشل. ولاحظ أن هذا السلوك بالضبط هو ما يجعل طريقة Aider مريحة رغم الفشل: لا يوجد أي تعديل نصف مطبق في ملفاتك، فإما commit واضح أو لا شيء.

### التشغيل الثاني: أضف الملف الصحيح، ثم انتظر بلا نهاية

في التشغيل الثاني فعلنا ما ينصح به توثيق Aider، أي أضفنا الملف الذي فيه الخطأ `pricing.py` إلى المحادثة، وأضفنا ملف الاختبارات للقراءة فقط بالخيار `--read` حتى يراه النموذج ولا يعدله، وأبقينا الصيغة `whole`. والنتيجة كانت مفاجئة:

```text
Added pricing.py to the chat.
Added test_cart.py to the chat (read-only).

https://aider.chat/HISTORY.html#release-notes

litellm.APIConnectionError: Ollama_chatException - litellm.Timeout: Connection 
timed out after 600.0 seconds.
Retrying in 0.2 seconds...
litellm.APIConnectionError: Ollama_chatException - litellm.Timeout: Connection 
timed out after 600.0 seconds.
Retrying in 0.5 seconds...
litellm.APIConnectionError: Ollama_chatException - litellm.Timeout: Connection 
timed out after 600.0 seconds.
Retrying in 1.0 seconds...
litellm.APIConnectionError: Ollama_chatException - litellm.Timeout: Connection 
timed out after 600.0 seconds.
Retrying in 2.0 seconds...
litellm.APIConnectionError: Ollama_chatException - litellm.Timeout: Connection 
timed out after 600.0 seconds.
Retrying in 4.0 seconds...
litellm.APIConnectionError: Ollama_chatException - litellm.Timeout: Connection 
timed out after 600.0 seconds.
Retrying in 8.0 seconds...
litellm.APIConnectionError: Ollama_chatException - litellm.Timeout: Connection 
timed out after 600.0 seconds.
Retrying in 16.0 seconds...
litellm.APIConnectionError: Ollama_chatException - litellm.Timeout: Connection 
timed out after 600.0 seconds.
Retrying in 32.0 seconds...
litellm.APIConnectionError: Ollama_chatException - litellm.Timeout: Connection 
timed out after 600.0 seconds.
```

كل طلب انتهى بانتهاء مهلة الاتصال، ثم أعاد Aider المحاولة بفواصل تتضاعف، حتى استسلم بعد تسع محاولات، وأعدنا التشغيل بمهلة نصف ساعة لكل طلب فتكرر الشيء نفسه. وسجل Ollama يوضح ما حدث من جهة السيرفر:

```text
# Ollama server log: every /api/chat request from Aider (127.0.0.1) in this lab, times UTC, with the run it belongs to
[GIN] 2026/11/13 - 04:14:30 | 200 | 4m20s | 127.0.0.1   <- run 1
[GIN] 2026/11/13 - 04:18:24 | 200 | 3m50s | 127.0.0.1   <- run 1
[GIN] 2026/11/13 - 04:29:18 | 500 | 10m0s | 127.0.0.1   <- run 2, timeout 600 s
[GIN] 2026/11/13 - 04:39:18 | 500 | 10m0s | 127.0.0.1   <- run 2, timeout 600 s
[GIN] 2026/11/13 - 04:49:19 | 500 | 10m0s | 127.0.0.1   <- run 2, timeout 600 s
[GIN] 2026/11/13 - 04:59:20 | 500 | 10m0s | 127.0.0.1   <- run 2, timeout 600 s
[GIN] 2026/11/13 - 05:09:22 | 500 | 10m0s | 127.0.0.1   <- run 2, timeout 600 s
[GIN] 2026/11/13 - 05:19:26 | 500 | 10m0s | 127.0.0.1   <- run 2, timeout 600 s
[GIN] 2026/11/13 - 05:29:34 | 500 | 10m0s | 127.0.0.1   <- run 2, timeout 600 s
[GIN] 2026/11/13 - 05:39:50 | 500 | 10m0s | 127.0.0.1   <- run 2, timeout 600 s
[GIN] 2026/11/13 - 05:40:14 | 499 | 1h39m50s | 127.0.0.1   <- stopped first try of run 1 (8192 window)
[GIN] 2026/11/13 - 05:50:23 | 500 | 10m0s | 127.0.0.1   <- run 2, timeout 600 s
[GIN] 2026/11/13 - 05:54:26 | 200 | 3m40s | 127.0.0.1   <- run 3
[GIN] 2026/11/13 - 05:55:53 | 200 | 1m20s | 127.0.0.1   <- run 3
[GIN] 2026/11/13 - 06:27:05 | 500 | 30m0s | 127.0.0.1   <- run 2 again, timeout 1800 s
[GIN] 2026/11/13 - 06:57:06 | 500 | 30m0s | 127.0.0.1   <- run 2 again, timeout 1800 s
[GIN] 2026/11/13 - 07:27:06 | 500 | 30m0s | 127.0.0.1   <- run 2 again, timeout 1800 s
[GIN] 2026/11/13 - 07:57:07 | 500 | 30m0s | 127.0.0.1   <- run 2 again, timeout 1800 s
[GIN] 2026/11/13 - 08:27:09 | 500 | 30m0s | 127.0.0.1   <- run 2 again, timeout 1800 s
[GIN] 2026/11/13 - 08:57:13 | 500 | 30m0s | 127.0.0.1   <- run 2 again, timeout 1800 s
[GIN] 2026/11/13 - 09:27:21 | 500 | 30m0s | 127.0.0.1   <- run 2 again, timeout 1800 s
[GIN] 2026/11/13 - 09:57:37 | 500 | 30m0s | 127.0.0.1   <- run 2 again, timeout 1800 s
[GIN] 2026/11/13 - 10:28:09 | 500 | 30m0s | 127.0.0.1   <- run 2 again, timeout 1800 s
[GIN] 2026/11/13 - 10:29:53 | 200 | 1m20s | 127.0.0.1   <- run 4
[GIN] 2026/11/13 - 10:30:17 | 200 | 22.82s | 127.0.0.1   <- run 4
# lines with "slot context shift" in the same server log, all clients: 40
```

في المخرج أعلاه لاحظ التالي:

- طلبات التشغيلات الأخرى انتهت في دقيقة إلى أربع دقائق، أما طلبات التشغيل الثاني فكل واحد منها بقي يعمل حتى المهلة بالضبط، عشر دقائق في المرة الأولى وثلاثين في الثانية، أي أن السيرفر لم ينه الرد أبداً.
- في السجل نفسه أربعون سطراً فيها context shift، أي أن رداً وصل إلى نهاية نافذة 4096 فحذف السيرفر نصف السياق ليكمل الكتابة بدل أن يتوقف. والسجل لا يربط هذه الأسطر بطلب معين، ولكنها تتفق مع رد لا ينتهي، وهو ما رأيناه في مختبر النماذج المحلية حين لم يتوقف النموذج من نفسه في الإكمال التلقائي.
- Aider نفسه لم يخطئ هنا، فهو أرسل الطلب وانتظر وأعاد المحاولة كما يجب، ولكن غياب حد لطول الرد جعل جهازاً كاملاً يعمل قرابة ست ساعات في المحاولتين دون نتيجة.
- السطر الذي مدته ساعة وتسع وثلاثون دقيقة هو محاولة أولى للتشغيل الأول بنافذة 8192 أوقفنا حاويتها بعد تسع دقائق، ومع ذلك لم يسجل السيرفر نهاية هذا الطلب إلا بعد ساعة ونصف تقريباً من إيقافها، أي أن إيقاف الوكيل لا يعني دائماً أن السيرفر توقف عن العمل على طلبه.

ولنتأكد من هذا التفسير أعدنا التشغيل الثاني بالملفات نفسها والصيغة نفسها، وأضفنا سطراً واحداً إلى ملف إعدادات النموذج هو `num_predict: 1024`، وهو خيار في Ollama يحدد أقصى عدد من التوكنات يكتبها النموذج في الرد الواحد:

```yaml
# Same window as model.settings.yml, plus a cap on the reply length (Ollama's num_predict),
# so a reply that never ends stops at 1024 tokens instead of running until the client times out.
- name: ollama_chat/qwen2.5-coder:3b
  extra_params:
    num_ctx: 4096
    num_predict: 1024
```

وهذه المرة انتهى التشغيل كله في أقل من خمس دقائق، ورأينا لأول مرة ما كان النموذج يكتبه:

```text
To fix the bug in `test_cart.py`, I need to ensure that the `Cart` class 
correctly calculates the subtotal and total with discounts and VAT. Let's update
the `Cart` class and the test cases accordingly.

cart.py
```

```text
test_cart.py
```

```text
+    def test_total_with_discount_and_vat_no_items(self):
+        cart = Cart()
+        self.assertEqual(cart.total(discount_percent=20), 0)
 
+    def test_total_with_discount_and_vat_no_items_no_vat(self):
+        cart = Cart()
+        self.assertEqual(cart.total(discount_percent=20, vat=False), 0)
+
+    def test_total_with_discount_and_vat_no_items_no_vat_no_items(self):
+        cart = Cart()
+        self.assertEqual(cart.total(discount_percent=20, vat=False), 0)
+
+    def test_total_with_discount_and_vat_no_items_no_vat_no_items_no_vat(self):
+        cart = Cart()
+        self.assertEqual(cart.total(discount_percent=20, vat=False), 0)
+
+    def 
test_total_with_discount_and_vat_no_items_no_vat_no_items_no_vat_no_items(self):
+        cart = Cart()
+        self.assertEqual(cart.total(discount_percent=20, vat=False), 0)
+
```

```text
+    def 
test_total_with_discount_and_vat_no_items_no_vat_no_items_no_vat_no_items_no_vat
_no_items_no_vat_no_items_no_vat_no_items_no_vat(self):
+        cart = Cart()
+        self.assertEqual(cart.total(discount_percent=20, vat=False), 0)
+
+    def 
test_total_with_discount_and_vat_no_items_no_vat_no_items_no_vat_no_items_no_vat
_no_items_no_vat_no_items_no_vat_no_items_no_vat_no_items(self):
+        cart = Cart()
+        self.assertEqual(cart.total(discount_percent=20, vat=False), 0)
+
+  25 /  27 lines [███████████████████████████░░░]  93%
```

Tokens: 1.1k sent, 1.0k received.

cart.py
I see you've added `cart.py`. If you have any more files to add or any other 
changes you need, please let me know!

Tokens: 2.4k sent, 30 received.
```

في المخرج أعلاه لاحظ التالي:

- بدأ النموذج بتعديل `cart.py` الذي لم يكن في المحادثة، ثم انتقل إلى ملف الاختبارات الذي أضفناه للقراءة فقط، وبدأ يضيف إليه اختبارات جديدة.
- كل اختبار جديد هو الاختبار السابق نفسه مع إضافة كلمتين إلى اسمه، أي أن النموذج دخل في حلقة تكرار لا يخرج منها، ولو لم يكن هناك حد لاستمر حتى تنتهي المهلة كما حدث في التشغيل الثاني.
- السطر Tokens يقول إن النموذج استقبل ألف توكن تقريباً ثم توقف، وهذا هو الحد الذي وضعناه بالضبط.
- لم يطبق Aider أي شيء، لأن `cart.py` لم يكن في المحادثة، وملف الاختبارات للقراءة فقط، والاختبارات ما زالت تفشل.

أي أن الحد لم يجعل النموذج يصلح الخطأ، ولكنه حول ست ساعات من الانتظار إلى خمس دقائق، وأظهر لنا السبب. ولذلك فإن أول إعداد تضيفه مع أي نموذج محلي هو حد لطول الرد، سواء في ملف إعدادات Aider أو في إعدادات النموذج نفسه في Ollama.

### التشغيل الثالث: صيغة التعديل diff والكود الذي لا وجود له

في التشغيل الثالث أعطينا النموذج الملفات نفسها، ولكن فرضنا صيغة `diff` بالخيار `--edit-format diff`، لنرى هل يكتب كتل SEARCH و REPLACE بشكل صحيح:

```text
### Step 3: Identify the Bug

Let's look at the `total` method in `cart.py`:

```python
def total(self, discount_percent=0):
    """Return the total after a percentage discount, rounded to whole 
halalas."""
    subtotal = self.subtotal()
    return round(subtotal - discount_percent)
```

The bug is in the `total` method. The `discount_percent` is being subtracted 
from the `subtotal`, which is incorrect. The `discount_percent` should be 
applied to the `subtotal` before rounding.

### Step 4: Fix the Bug

We need to modify the `total` method to apply the discount to the `subtotal` 
before rounding:

```python
def total(self, discount_percent=0):
    """Return the total after a percentage discount, rounded to whole 
halalas."""
    subtotal = self.subtotal()
    discounted_subtotal = subtotal - (subtotal * (discount_percent / 100))
    return round(discounted_subtotal)
```

### Step 5: Apply the Fix

Here are the *SEARCH/REPLACE* blocks to fix the bug in `cart.py`:

cart.py
```python
<<<<<<< SEARCH
def total(self, discount_percent=0):
    """Return the total after a percentage discount, rounded to whole 
halalas."""
    subtotal = self.subtotal()
    return round(subtotal - discount_percent)
=======
def total(self, discount_percent=0):
    """Return the total after a percentage discount, rounded to whole 
halalas."""
    subtotal = self.subtotal()
    discounted_subtotal = subtotal - (subtotal * (discount_percent / 100))
    return round(discounted_subtotal)
>>>>>>> REPLACE
```

في المخرج أعلاه لاحظ التالي:

- كتب النموذج الصيغة بشكل صحيح من حيث الشكل، أي اسم الملف ثم SEARCH ثم الفاصل ثم REPLACE.
- ولكن الكود الذي وضعه في جزء SEARCH غير موجود في أي ملف، فقد اخترع النموذج دالة `total` في `cart.py` تطرح الخصم من المجموع، وهي في الحقيقة تستدعي `apply_discount` و`add_vat` ولا تطرح شيئاً، وملف `cart.py` لم يكن في المحادثة أصلاً.
- لأن Aider يبحث عن نص SEARCH حرفاً بحرف في الملف، فإن كتلة لا يجد نصها لا تطبق، وهذه هي حماية صيغة diff: النموذج لا يستطيع أن يعدل كوداً لم يره.

```text
Tokens: 2.9k sent, 756 received.

cart.py
No additional files are needed.

Tokens: 3.9k sent, 7 received.
### git log
d5f2e60 Store pricing and cart
### git status
?? .gitignore
?? __pycache__/
### last commit
d5f2e60 Store pricing and cart

 cart.py      | 15 +++++++++++++++
 pricing.py   | 13 +++++++++++++
 test_cart.py | 27 +++++++++++++++++++++++++++
 3 files changed, 55 insertions(+)
### diff of the code files since the first commit
### tests
----------------------------------------------------------------------
Ran 4 tests in 0.006s

FAILED (failures=3)
```

ومرة أخرى لم يتغير شيء، والاختبارات ما زالت تفشل، ولم يدخل git أي commit من الوكيل.

### التشغيل الرابع: حدد له الدالة Function

في التشغيل الرابع فعلنا ما يفعله أي مطور مع زميل جديد، أي قلنا له أين الخطأ بالضبط: الدالة `apply_discount` في `pricing.py` خاطئة لأن الوسيط نسبة مئوية لا مبلغ، وأبقينا الملفات والصيغة كما في التشغيل الثاني:

```text
pricing.py

```diff
@@ -3,11 +3,11 @@
 VAT_RATE = 15  # percent
 
 
 def apply_discount(total, percent):
     """Return the total after a percentage discount, rounded to whole 
halalas."""
-    return total - percent
+    return round(total * (100 - percent) / 100)
 
 
 def add_vat(total):
     """Return the total with VAT added, rounded to whole halalas."""
     return round(total * (100 + VAT_RATE) / 100)
```

Tokens: 1.1k sent, 126 received.
Applied edit to pricing.py
Commit 7378bc7 fix: apply_discount in pricing.py is wrong: percent is a 
percentage, not an amount.
----------------------------------------------------------------------
Ran 4 tests in 0.000s

OK
```

هذه المرة نجح كل شيء في أقل من دقيقتين:

- رد النموذج مرة أخرى بصيغة diff موحدة رغم أن Aider طلب الملف كاملاً، ولكن التعديل هذه المرة على ملف موجود في المحادثة ونصه مطابق، فطبقه Aider وكتب Applied edit to pricing.py.
- عمل Aider commit فوراً برسالة تبدأ بـ `fix:` بأسلوب Conventional Commits، ثم شغل الاختبارات فنجحت الأربعة.
- الطلب الثاني القصير في سجل السيرفر، أي 22 ثانية، هو طلب كتابة رسالة الـ commit، فـ Aider يرسل الفرق إلى نموذج يسميه الضعيف weak model ليكتب الرسالة، وهو هنا النموذج نفسه.

```text
### git log
7378bc7 fix: apply_discount in pricing.py is wrong: percent is a percentage, not an amount.
f2a90e8 Store pricing and cart
### git status
?? .gitignore
?? __pycache__/
### last commit
7378bc7 fix: apply_discount in pricing.py is wrong: percent is a percentage, not an amount.
Co-authored-by: aider (ollama_chat/qwen2.5-coder:3b) <aider@aider.chat>

 pricing.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
### diff of the code files since the first commit
diff --git a/pricing.py b/pricing.py
index 50297de..3fab56f 100755
--- a/pricing.py
+++ b/pricing.py
@@ -5,7 +5,7 @@ VAT_RATE = 15  # percent
 
 def apply_discount(total, percent):
     """Return the total after a percentage discount, rounded to whole halalas."""
-    return total - percent
+    return round(total * (100 - percent) / 100)
 
 
 def add_vat(total):
### tests
----------------------------------------------------------------------
Ran 4 tests in 0.000s

OK
```

ولاحظ في الـ commit أن Aider أضاف سطر Co-authored-by باسم النموذج، فتعرف لاحقاً من تاريخ git أي التعديلات كتبها الوكيل وبأي نموذج. والتعديل سطر واحد فقط، وهو صحيح ومقرب إلى هللة كاملة كما يطلب تعليق الدالة.

![خمسة صفوف لخمسة تشغيلات: الأول دون ملفات في المحادثة اختار النموذج cart.py ورد بصيغة diff بدل whole ولم يطبق شيء، والثاني مع pricing.py لم ينته أي رد حتى المهلة تسع مرات، والثاني مع حد 1024 توكن توقف الرد بعد خمس دقائق وهو يكرر أسماء اختبارات، والثالث بصيغة diff كتب SEARCH لكود غير موجود، والرابع بعد تحديد الدالة طبق التعديل في سطر واحد وعمل commit ونجحت الاختبارات الأربعة](https://arabroot.io/content/images/2026/11/open-source-coding-agents-03-runs.webp)

نتيجة التشغيلات: النموذج الصغير نجح فقط عندما حددنا له الملف والدالة وطبيعة الخطأ.

### ماذا يعلمنا المختبر؟

- **الأداة تحميك حتى عندما يفشل النموذج:** في كل التشغيلات الفاشلة لم يتغير أي سطر في المستودع، لأن Aider لا يطبق إلا ما يستطيع أن يطابقه، ولا يعمل commit إلا لتعديل طبقه فعلاً.
- **النموذج الصغير يحتاج من يحدد له المكان:** عندما تركنا له البحث اختار ملفاً غير الذي فيه الخطأ، وعندما حددنا الدالة أصلحها في سطر واحد. وهذا يتفق مع ما رأيناه في مختبرات المسار السابقة.
- **صيغة التعديل اتفاق قد لا يلتزم به النموذج:** طلب Aider الملف كاملاً، فرد النموذج بصيغة أخرى في ثلاث مرات من أربع، وفي صيغة diff اخترع كوداً غير موجود.
- **حدد طول الرد دائماً مع النماذج المحلية:** رد واحد لا يتوقف أضاع ساعات من وقت الجهاز، وحل ذلك سطر في ملف الإعدادات.
- **الحكم هو الاختبار وgit:** النموذج قال في كل مرة إن تعديله يصلح الخطأ، والاختبارات قالت غير ذلك في كل مرة إلا الأخيرة.

## إذا أردت أن تبدأ: Aider مع Ollama خطوة خطوة

إذا أردت أن تجرب ما في المختبر على مشروعك فهذه الخطوات بالترتيب، وكلها من توثيق Aider ومن الإعداد الذي شغلناه فعلاً، وتستطيع أن تستبدل النموذج المحلي بنموذج في السحابة دون أن يتغير شيء آخر غير اسم النموذج والمفتاح.

أولاً ثبت Aider بالطريقة المكتوبة في صفحة Ollama في توثيقه، أي حزمة مساعدة تتولى التثبيت ثم أمرها:

```bash
python -m pip install aider-install
aider-install
```

ثم حدد عنوان سيرفر Ollama، وأنشئ ملف إعدادات للنموذج في مجلد المستخدم أو في جذر المستودع، وثبت فيه نافذة السياق وحداً لطول الرد، لأن هذين الرقمين هما ما غير النتيجة في المختبر:

```bash
export OLLAMA_API_BASE=http://127.0.0.1:11434
cat > ~/.aider.model.settings.yml <<'YAML'
- name: ollama_chat/qwen2.5-coder:3b
  extra_params:
    num_ctx: 4096
    num_predict: 1024
YAML
```

ثم اعمل فرعاً جديداً للمهمة، وشغل Aider داخل المستودع، وأضف الملف الذي تعرف أن الخطأ فيه، وأضف ملف الاختبارات للقراءة فقط، وأعطه أمر الاختبارات حتى يتحقق من تعديله بنفسه:

```bash
git switch -c fix-discount
aider --model ollama_chat/qwen2.5-coder:3b pricing.py --read test_cart.py \
  --test-cmd "python -m unittest -q" --auto-test
```

وبعد ذلك تكتب طلبك في الجلسة التفاعلية، وكلما كان الطلب أدق كانت النتيجة أفضل مع النماذج الصغيرة، كما رأينا في التشغيل الرابع. وإذا لم يعجبك تعديل فاكتب `/undo` فيرجع Aider آخر commit عمله، وإذا أردت أن ترى ما تغير منذ آخر رسالة فاكتب `/diff`. وعندما تنتهي راجع تاريخ الفرع بالأمر `git log -p` كما تراجع عمل أي زميل، ثم ادمجه أو احذفه.

ولاحظ ثلاثة أشياء في هذا الإعداد:

- لم نستعمل الخيار `--yes-always` هنا، لأنه في الجلسة التفاعلية يجعل Aider يوافق على إضافة أي ملف وتشغيل أي أمر يقترحه النموذج دون أن يسألك، واستعملناه في المختبر فقط لأن التشغيل كان دون إنسان أمامه.
- النافذة 4096 تكفي مستودعاً صغيراً كالذي في المختبر، أما في مشروع حقيقي فإن الخريطة والملفات تحتاج نافذة أكبر، فإما أن تكبرها بقدر ما تسمح ذاكرة جهازك، أو تترك Aider يحددها لكل طلب كما يفعل بشكل افتراضي.
- الحد 1024 توكن يكفي تعديلاً صغيراً بصيغة diff، أما صيغة whole فتحتاج حداً أكبر من طول الملف الذي يعيده النموذج، وإلا انقطع الملف في منتصفه.

## الموافقة Approval: من يقرر قبل أن يتغير الكود؟

بعد أن رأينا ما يحدث عندما يخطئ النموذج، يصبح السؤال المهم في اختيار الأداة ليس أي أداة أذكى، فالذكاء في النموذج لا في الأداة، وإنما كيف تحميك الأداة من أخطاء النموذج. والجدول التالي يجمع إجابة كل أداة من توثيقها:

![جدول من أربعة صفوف وثلاثة أعمدة: Aider يطبق التعديل مباشرة ويسألك قبل إضافة ملف إلى المحادثة أو تشغيل أمر، والأوامر على جهازك مباشرة، وشبكة الأمان commit لكل تعديل والأمر undo. Cline يطلب موافقتك على كل تعديل وكل أمر إلا إذا فعلت الموافقة التلقائية، والأوامر في طرفية جهازك، وشبكة الأمان Checkpoints في مستودع git ظل منفصل. OpenCode وكيل build بصلاحية كاملة ووكيل plan يمنع التعديل ويسأل قبل bash، والأوامر على جهازك مباشرة، وشبكة الأمان وكيل plan للقراءة فقط. OpenHands يعمل وحده على المهمة وأنت تتابعه من لوحة الويب، والأوامر في حاوية Docker أو عملية على جهازك دون عزل، وشبكة الأمان العزل في الحاوية عن بقية جهازك](https://arabroot.io/content/images/2026/11/open-source-coding-agents-04-control.webp)

أربع طرق لحمايتك من خطأ النموذج: الـ commit، والموافقة على كل خطوة، ووكيل للقراءة فقط، والعزل في حاوية.

ولاحظ أن ثلاثاً من الأدوات الأربع تنفذ الأوامر على جهازك مباشرة، أي بصلاحيات حسابك نفسه، وهذا يعني أن أي أمر يقترحه النموذج ويوافق عليه الوكيل يستطيع أن يقرأ ملفات خارج المشروع أو مفاتيح SSH أو متغيرات البيئة. ولذلك فإن القواعد التي شرحناها في مقال بيئة التشغيل تنطبق هنا كما هي: لا تفعل الموافقة التلقائية على الأوامر في مشروع فيه أسرار، واعمل على فرع منفصل دائماً، وإذا أردت أن يعمل الوكيل وحده مدة طويلة فشغله داخل حاوية أو VM لا ترى إلا المشروع.

## كيف تختار؟

لا توجد أداة أفضل من غيرها في كل الحالات، ولكن هذه قواعد عملية تساعدك في الاختيار:

- **إذا كنت تعيش في الطرفية وتريد أن ترى كل تغيير في git:** ابدأ بـ Aider أو OpenCode، فتعديلات Aider كلها commits تراجعها بأدوات git المعتادة، وOpenCode يعطيك وكيل تخطيط للقراءة فقط قبل أن تسمح بأي تعديل.
- **إذا كنت تعمل في VS Code وتريد أن توافق على كل خطوة:** Cline هو الأقرب، مع وضع التخطيط قبل التنفيذ ونقاط الرجوع بعد كل خطوة.
- **إذا أردت وكيلاً يعمل وحده على مهام طويلة أو مجدولة:** OpenHands داخل حاوية Docker، مع نموذج قوي في السحابة أو على سيرفر فيه بطاقة رسومية.
- **إذا أردت مساعداً عاماً لا يقتصر على الكود:** Goose مع إضافات MCP.
- **إذا كان جهازك عادياً دون بطاقة رسومية:** لا تتوقع أن يعمل أي وكيل منها وحده بنموذج محلي صغير، واستعمل النموذج المحلي للمهام القصيرة مع ملفات تحددها أنت، أو اربط الوكيل بنموذج أقوى في السحابة.

## أخطاء شائعة

- **أن تحكم على الأداة بنتيجة نموذج صغير:** كل ما رأيناه من فشل في المختبر سببه النموذج، ونفس Aider مع نموذج أقوى يعطيك نتيجة مختلفة تماماً. جرب الأداة بالنموذج الذي سوف تستعمله فعلاً قبل أن تحكم عليها.
- **أن تترك الوكيل يختار الملفات وحده في مشروع كبير:** مع Aider خاصة أضف الملفات التي تعرف أن الخطأ فيها، وأضف ملفات الاختبار للقراءة فقط بالخيار `--read`، فهذا وحده غير النتيجة في المختبر.
- **أن تثق بعبارة "يجب أن يصلح هذا الخطأ":** رد النموذج في التشغيل الأول قال إن تعديلاته يجب أن تصلح الخطأ، بينما لم يطبق أي تعديل أصلاً. الحكم هو الاختبار وتاريخ git، لا كلام النموذج.
- **أن تنسى نافذة السياق مع Ollama:** إذا ثبت النافذة على رقم صغير ومشروعك كبير فإن جزءاً من خريطة المستودع أو الملفات يحذف دون أي رسالة، وراقب سجل Ollama بحثاً عن كلمة truncating.
- **أن تعمل على الفرع الرئيسي مباشرة:** Aider يعمل commit على الفرع الذي أنت فيه، فإذا كنت على main فإن تعديلات الوكيل تصبح في main، واعمل دائماً على فرع للمهمة.
- **أن تختار أداة توقف تطويرها:** افحص تاريخ آخر إصدار وحالة المستودع قبل أن تبني عليها عادات فريقك.

## تدريب عملي

1. شغل المختبر كما هو بالأمر `bash run.sh` على جهازك، وقارن نتيجة التشغيلات الثلاث بما في هذا المقال، ولاحظ هل اختار النموذج الملف نفسه في التشغيل الأول.
2. غير النموذج في `run.sh` إلى نموذج أكبر يتسع له جهازك، مثل `qwen2.5-coder:7b`، وأضف له سطراً في `model.settings.yml`، ثم قارن عدد التشغيلات التي نجحت.
3. أضف إلى المستودع خطأ ثانياً في `add_vat`، واطلب من Aider إصلاح الخطأين في رسالة واحدة، ثم راجع عدد الـ commits التي عملها ورسائلها.
4. جرب الأمر `/undo` في جلسة تفاعلية مع Aider بعد تعديل لا يعجبك، وتأكد من تاريخ git أن الـ commit اختفى وأن ملفاتك رجعت كما كانت.
5. إذا كان عندك VS Code فثبت Cline واربطه بسيرفر Ollama نفسه مع خيار Use Compact Prompt، واطلب منه المهمة نفسها في وضع التخطيط أولاً، ثم قارن طريقته بطريقة Aider.

## الخلاصة

- وكيل البرمجة مفتوح المصدر هو الطبقة التي تقرأ ملفاتك وتنفذ الأوامر، والنموذج منفصل عنه تختاره أنت، محلياً أو في السحابة.
- الأدوات الأشهر في نوفمبر 2026 هي Aider وCline وOpenHands وOpenCode وGoose، كلها برخص Apache 2.0 أو MIT، وContinue توقف تطويره.
- Aider يرسل خريطة للمستودع مع كل طلب، ويطلب من النموذج صيغة تعديل محددة، ويعمل commit لكل تعديل، ويشغل الاختبارات ويعيد المحاولة إذا فشلت.
- Cline يفصل التخطيط عن التنفيذ، ويطلب موافقتك على كل تعديل وأمر، ويحفظ نقاط رجوع في مستودع git ظل.
- OpenHands يعمل وحده داخل حاوية Docker معزولة، ويوصي توثيقه بنموذج كبير على بطاقة رسومية للعمل المحلي.
- في المختبر فشل Aider مع نموذج 3B محلي في كل مرة تركنا له فيها البحث عن الخطأ، ونجح بسطر واحد وcommit واحد عندما حددنا له الدالة، ولم يغير أي ملف في المحاولات الفاشلة.
- حدد طول الرد دائماً مع النماذج المحلية: رد لا ينتهي أضاع قرابة ست ساعات، وحد 1024 توكن أنهى المحاولة نفسها في خمس دقائق.
- اختر الأداة بحسب طريقة عملك وطريقة حمايتها لك من أخطاء النموذج، ثم اختبرها بالنموذج الذي سوف تستعمله فعلاً.

وفي المقالات القادمة من هذا المسار بإذن الله نتحدث عن هندسة السياق، أي كيف تختار ما يراه الوكيل وما لا يراه، وعن ملفات التعليمات مثل AGENTS.md التي تقرؤها هذه الأدوات في كل مهمة:

[![](https://arabroot.io/content/images/2026/11/ai-coding-how-it-works-cover-cover.webp)دليلكيف يعمل مساعد البرمجة AI Coding Assistant من الداخل؟النموذج لا يفتح ملفاً ولا يشغل أمراً، وإنما يقرأ توكنات ويكتب نصاً، وبرنامج حوله ينفذ: نرى ذلك بأعيننا على نموذج مفتوح المصدر ثم نبني وكيلاً صغيراً يصلح خطأً حقيقياً.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-%D9%85%D8%B3%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D8%A8%D8%A7%D9%84%D8%B0%D9%83%D8%A7%D8%A1-%D8%A7%D9%84%D8%A7%D8%B5%D8%B7%D9%86%D8%A7%D8%B9%D9%8A-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%A7%D8%AE%D9%84/)[![](https://arabroot.io/content/images/2026/11/agent-harness-cover-cover.webp)دليلبيئة تشغيل الوكيل Harness: الصلاحيات والصندوق المعزول Sandboxالنموذج يكتب نصاً فقط، والبرنامج الذي حوله هو الذي يقرأ الملفات وينفذ الأوامر ويقرر ما يسمح به، وفي هذا الدليل نبني بيئة تشغيل صغيرة حول نموذج محلي ونرى كل جزء منها يعمل ويمنع.](https://arabroot.io/articles/%D8%A8%D9%8A%D8%A6%D8%A9-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%A7%D9%84%D9%88%D9%83%D9%8A%D9%84-harness-%D8%A7%D9%84%D8%AD%D9%84%D9%82%D8%A9-%D9%88%D8%A7%D9%84%D8%B5%D9%84%D8%A7%D8%AD%D9%8A%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%B5%D9%86%D8%AF%D9%88%D9%82-%D8%A7%D9%84%D9%85%D8%B9%D8%B2%D9%88%D9%84/)[![](https://arabroot.io/content/images/2026/11/local-models-coding-cover-cover.webp)دليلوكيل برمجة بنموذج محلي Local LLM مع Ollama: ماذا تتوقع؟خمسة نماذج برمجة على معالج عادي دون بطاقة رسومية: كم تأخذ من الذاكرة، وكم تنتظر قبل أول كلمة، وكم دالة تكتبها صحيحة، وهل يصلح الوكيل علة بنفسه.](https://arabroot.io/articles/%D9%88%D9%83%D9%8A%D9%84-%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D8%A8%D9%86%D9%85%D9%88%D8%B0%D8%AC-%D9%85%D8%AD%D9%84%D9%8A-%D9%85%D8%B9-ollama-%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D8%AA%D9%88%D9%82%D8%B9/)

## سجل التحديثات

- نوفمبر 2026: كتابة المقال، وتشغيل المختبر بـ Aider 0.86.2 مع Ollama 0.40.13 ونموذج Qwen2.5-Coder 3B على معالج دون بطاقة رسومية، والتحقق من رخص الأدوات وإصداراتها من مستودعاتها على GitHub.