---
title: "تشغيل وكلاء البرمجة ليلًا: عزل وgit وسقف للتكلفة | BroadRouter"
description: "إعداد عملي لتشغيل وكلاء البرمجة دون مراقبة: العزل، ونقاط حفظ git، وملفات المهام، وحدود الخطوات، والمراجعة الصباحية، وجلسات الخطط بسعر ثابت طوال الليل."
url: https://broadrouter.com/ar/blog/overnight-coding-agent-runs/
lang: ar
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/blog/overnight-coding-agent-runs/) (حُدّث في 2026-11-16).

# كيف تشغّل وكلاء البرمجة طوال الليل دون مراقبة، بأمان

بقلم فريق BroadNet Inference · قراءة في 5 دقائق · تاريخ النشر 2026-11-14 · آخر تحديث 2026-11-16

شغّل الوكيل في حاوية أو آلة افتراضية لا يُربط فيها إلا المستودع، على فرع git خاص به، مع إيداع بعد كل خطوة مكتملة. أعطه ملف مهمة مكتوبًا، وحدًا أقصى للخطوات، وموعدًا نهائيًا بالساعة، ثم راجع الفرع صباحًا. وجلسة خطة بسعر ثابت، مثل خطة البدر من BroadNet بسعر $60، تثبّت الفاتورة في أسوأ الأحوال.

## أبرز النقاط

-   العزل أولًا: حاوية أو آلة افتراضية لا يُربط فيها إلا المستودع، ولا بيانات اعتماد للإنتاج.
-   فرع أو git worktree لكل وكيل، مع إيداع بعد كل خطوة، يجعل كل تغيير قابلًا للمراجعة والتراجع.
-   ملف مهمة بتعريف واضح لمعنى "الانتهاء" أفضل من أمر من سطر واحد.
-   الحد الأقصى للخطوات، والموعد النهائي، وحارس التكرار، توقف التشغيلات العالقة قبل الصباح.
-   جلسة الخطة بلا عدّاد للرموز، فليلة من عمل الوكيل تكلّف سعر الخطة أيًا كان عدد الرموز.

**في هذه الصفحة**

1.  1\. كيف تعزل وكيلًا يعمل دون مراقبة؟
2.  2\. لماذا تمنح كل وكيل فرعه الخاص؟
3.  3\. ماذا يحوي ملف المهمة؟
4.  4\. ما الحراس الذين يوقفون وكيلًا عالقًا؟
5.  5\. أيهما أرخص ليلًا: جلسة خطة أم الفوترة لكل رمز؟
6.  6\. كيف تراجع التشغيل في الصباح؟
7.  كيف تجرّبه بأمان في الليلة الأولى؟

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

هذه قائمة تحقق لإعداد ذلك.

## 1\. كيف تعزل وكيلًا يعمل دون مراقبة؟

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

-   **حاوية أو آلة افتراضية**، لا حساب المستخدم الرئيسي في حاسوبك. تغطي [وثائق الأمان](https://docs.docker.com/engine/security/) في Docker الضوابط؛ وكحد أدنى شغّله كمستخدم غير root، وأسقط الصلاحيات (capabilities) التي لا تحتاجها.
-   **اربط المستودع فقط.** لا مجلد منزلي، ولا مفاتيح SSH، ولا بيانات اعتماد سحابية، ولا `~/.config` مليء بالرموز السرية.
-   **لا أسرار إنتاج.** استخدم قواعد بيانات اختبار ومفاتيح API وهمية. وإذا احتاج الوكيل إلى خدمة حقيقية، فأعطه مفتاحًا محدود النطاق قابلًا للإبطال.
-   **قيّد الشبكة.** يحتاج الوكيل إلى واجهة النموذج وربما إلى سجلّ حزم. ونادرًا ما يحتاج إلى أي شيء آخر.
-   **لا صلاحيات دفع.** دعه يودِع محليًا، وادفع أنت بعد المراجعة.

مفتاح API الخاص بالنموذج هو بيانات الاعتماد الوحيدة التي يجب أن يملكها الوكيل. استخدم مفتاحًا مُنشأً لهذا الغرض، وإذا كان مزوّدك يدعم ذلك، فقيّده بعنوان IP الخارجي لبيئة العزل. تدعم مفاتيح BroadNet [قوائم السماح لعناوين IP](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/) بحد أقصى 32 مدخلًا، فيصبح المفتاح المسرَّب عديم الفائدة من أي مكان آخر.

## 2\. لماذا تمنح كل وكيل فرعه الخاص؟

اعمل على فرع مخصّص، لا على `main` أبدًا. وإذا شغّلت أكثر من وكيل، فأعطِ كلًّا منها مجلد عمل خاصًا به باستخدام [git worktree](https://git-scm.com/docs/git-worktree):

```bash
git worktree add ../agent-tests-api -b agent/tests-api
git worktree add ../agent-lint-fixes -b agent/lint-fixes
```

كل worktree نسخة عمل مستقلة من المستودع نفسه، فلا يكتب الوكلاء فوق ملفات بعضهم، ويُظهر كل فرع بالضبط ما فعله وكيل واحد.

ثم **أودِع بعد كل خطوة مكتملة.** يفعل Aider ذلك افتراضيًا. وللوكلاء الآخرين، أضفه إلى التعليمات أو أحِط الحلقة بحيث يحدث إيداع كلما نجحت الاختبارات. وتاريخ من الإيداعات الصغيرة يحوّل عبارة “كسر الوكيل شيئًا في الثالثة فجرًا” إلى “الإيداع 14 كسره؛ احتفظ بالإيداعات من 1 إلى 13”.

## 3\. ماذا يحوي ملف المهمة؟

الأمر المكوّن من سطر واحد الذي ينجح تفاعليًا يفشل ليلًا، لأنه لا أحد هناك ليجيب عن أول سؤال يطرحه الوكيل. اكتب ملف مهمة:

```markdown
# Task: add unit tests to src/billing/

## Goal
Every public function in src/billing/ has at least one unit test.

## Done when
- `pytest tests/billing` passes
- coverage for src/billing/ is reported (no target)
- no changes outside tests/billing/ except fixing obvious bugs, each in its own commit

## Rules
- Do not change public function signatures.
- If a function is untestable without a refactor, list it in NOTES.md and move on.
- Run `pytest tests/billing -x` after each new test file.

## Notes
Append decisions and skipped items to NOTES.md as you go.
```

قسم “Done when” (متى تكتمل المهمة) هو الجزء المهم. فهو يمنح الوكيل طريقة لمعرفة أنه انتهى، ويمنحك طريقة للتحقق. ويؤدي ملف الملاحظات دور الذاكرة أيضًا إذا أُعيد التشغيل أو ضُغط السياق؛ راجع [إدارة السياق للوكلاء طويلي التشغيل](https://broadrouter.com/ar/blog/long-running-agent-context-management/).

## 4\. ما الحراس الذين يوقفون وكيلًا عالقًا؟

“دون مراقبة” يعني أن أحدًا لن يلاحظ الوكيل العالق حتى الصباح. أربعة حراس:

1.  **حد أقصى للخطوات.** عدد أقصى ثابت لاستدعاءات النموذج في كل مهمة.
2.  **موعد نهائي.** توقّف عند وقت محدد بالساعة، مثل 07:00، أيًا كانت الحالة.
3.  **كشف التكرار.** توقّف حين يعيد استدعاء الأداة نفسه النتيجة نفسها ثلاث مرات، أو حين لا يتغيّر أي ملف لعدد محدد من الخطوات.
4.  **مهلة لكل أداة.** لا ينبغي أن تُعلّق مجموعة اختبارات متوقفة الليلة كلها.

وحين يُطلق أحد الحراس، ينبغي أن يكتب الوكيل السبب في ملف الملاحظات ويخرج بشكل نظيف. ويشرح دليل تكلفة وكلاء البرمجة، في قسم [حدّد سقفًا للخطوات في كل مهمة](https://broadrouter.com/ar/blog/cut-coding-agent-llm-costs/)، لماذا تهم حدود الخطوات وحدود إعادة المحاولة في التكلفة.

ومن السهل تشغيل Aider بهذه الطريقة: إذ تعرض [وثائق السكربتات](https://aider.chat/docs/scripting.html) الخيار `--message` لتشغيل تعليمة واحدة ثم الخروج، و`--yes-always` لقبول طلبات التأكيد تلقائيًا. أحِط ذلك بحلقة صدفة على قائمة مهام، مع `timeout` حول كل تشغيل، فيصبح لديك طابور ليلي بسيط.

## 5\. أيهما أرخص ليلًا: جلسة خطة أم الفوترة لكل رمز؟

التشغيل الليلي يغيّر سؤال التكلفة. فلا أحد يراقب العدّاد، والوكيل العالق قد يدور في حلقة لساعات.

**على مفتاح بالفوترة لكل رمز**، تعتمد التكلفة على مقدار ما يرسله الوكيل. والوكلاء يعيدون إرسال السياق في كل خطوة، فيتراكم تشغيل مدته ثماني ساعات. ويساعد التخزين المؤقت للأوامر كثيرًا (المدخلات المخزَّنة مؤقتًا على [DeepSeek V4.1 Flash](https://broadrouter.com/ar/models/deepseek-v4.1-flash/) بسعر $0.0055 لكل مليون رمز مقابل $0.175 للمدخلات الجديدة)، لكن رموز الإخراج والاستدلال المنطقي تُحاسَب كاملة. فتحتاج إلى ميزانية رموز لكل تشغيل وحد إنفاق على الحساب.

**على جلسة خطة**، لا يوجد عدّاد للرموز. فجلسة البدر (Full Moon) بسعر $60 شهريًا لاستخدام غير محدود لـ DeepSeek V4.1 Flash، وهذا هو السقف مهما طال تشغيل الوكيل أو دار في حلقات. وفي العمل الليلي هذه هي الميزة الأساسية: الفاتورة في أسوأ الأحوال معروفة قبل أن تنام.

|  | مفتاح بالفوترة لكل رمز | جلسة خطة |
| --- | --- | --- |
| أسوأ تكلفة لليلة عالقة | تزداد مع الرموز | ثابتة عند سعر الخطة |
| الوكلاء المتوازيون | حتى 4 طلبات قيد التنفيذ لكل مفتاح دفع حسب الاستخدام | طلب واحد في كل مرة لكل جلسة |
| النماذج | كل نماذج المحادثة | DeepSeek V4.1 Flash فقط |
| هل ما زلت تحتاج إلى الحراس؟ | نعم، للتكلفة والوقت | نعم، للوقت |

ملاحظتان عمليتان عن الجلسات. تشغّل الجلسة طلبًا واحدًا في كل مرة، فيتناوب وكيلان يتشاركان جلسة واحدة؛ وتعمل المهام على الجلسة الواحدة بالتتابع، وهذا مقبول غالبًا ليلًا. وإذا أردت وكلاء يعملون جنبًا إلى جنب، فاشترِ جلسة لكل وكيل. ويتناول مقال [الوكلاء المتوازيون على API بسعر ثابت](https://broadrouter.com/ar/blog/run-parallel-coding-agents-flat-rate/) الحسابات.

وبالسرعة المعتادة البالغة نحو 100 رمز في الثانية، تستطيع جلسة واحدة إنتاج نحو 259 مليون من رموز الإخراج في شهر من الاستخدام المتواصل. أما هل يتفوّق ذلك على التسعير لكل رمز في حالتك، فيعتمد على الحجم؛ ومثال BroadNet المحسوب لوكيل برمجة يعمل بدوام كامل يبلغ نحو $65.40 شهريًا بالدفع حسب الاستخدام. احسب أرقامك في [حاسبة السعر الثابت مقابل السعر لكل رمز](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/). كما تحتاج التشغيلات الطويلة دون مراقبة إلى انضباط في السياق وإعادة محاولات تصمد أمام الأعطال: راجع [المهل وإعادة المحاولات ونقاط الحفظ](https://broadrouter.com/ar/blog/long-running-agents-timeouts-retries/).

## 6\. كيف تراجع التشغيل في الصباح؟

لا تتحقق قيمة التشغيل الليلي إلا عند المراجعة. فاجعلها سريعة:

1.  **اقرأ NOTES.md أولًا.** ما الذي أنهاه الوكيل، وما الذي تخطّاه، وأين علق؟
2.  **تحقّق من سبب التوقف.** انتهى، أم بلغ حد الخطوات، أم الموعد النهائي، أم التكرار؟
3.  **شغّل الاختبارات بنفسك.** لا تثق بتقرير الوكيل عن نجاح الاختبارات.
4.  **اقرأ الفروقات إيداعًا إيداعًا.** فالإيداعات الصغيرة تجعل التغييرات السيئة سهلة الاكتشاف والحذف.
5.  **ادمج (squash) أو أعد تأسيس (rebase) ما تحتفظ به**، ثم افتح طلب دمج عاديًا.

في معظم الصباحات ستحتفظ بمعظم العمل وتصلح بضعة إيداعات يدويًا. وفي الصباحات السيئة تحذف فرعًا. وفي الحالتين، لم يلمس شيء `main` دونك.

## كيف تجرّبه بأمان في الليلة الأولى؟

ابدأ بمهمة واحدة محددة جيدًا، ووكيل واحد، وجلسة واحدة. وساعة من خطة الشهاب (Meteor) ($1) تكفي للتحقق من أن إعداد العزل والفرع والحراس يعمل قبل أن تترك أي شيء يعمل طوال الليل. وللوكيل نفسه، يحوي [دليل Aider](https://broadrouter.com/ar/guides/aider-unlimited-deepseek/) إعدادات الاتصال الدقيقة، ويساعدك مقال [أفضل نموذج مفتوح لوكلاء البرمجة](https://broadrouter.com/ar/blog/best-open-model-for-coding-agents/) في اختيار نموذج، ويتناول [كيف تعمل جلسات الخطط](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/) المفاتيح والجلسات.

أدوات مجانية لهذا الموضوع (بالإنجليزية)

-   [Agent run cost estimator](https://broadrouter.com/tools/agent-run-cost-estimator/) Context growth per step, total tokens and cost of one agent run, with a DeepSeek session comparison.
-   [LLM batch job planner](https://broadrouter.com/tools/llm-batch-job-planner/) Run time, binding limit, cost per model and the flat sessions needed to finish a big job by a deadline.
-   [Flat-rate vs per-token LLM cost calculator](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/) Break-even between an unlimited plan and paying per token, per agent.
-   [LLM rate limit and concurrency calculator](https://broadrouter.com/tools/llm-rate-limit-calculator/) Which limit binds first: RPM, TPM or concurrency, with Little's law.

[أدوات مجانية (بالإنجليزية)](https://broadrouter.com/tools/)

## مصطلحات في هذا المقال

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[التزامن (Concurrency)](https://broadrouter.com/ar/glossary/concurrency/)

التزامن (concurrency) هو عدد الطلبات التي تكون لدى العميل قيد التنفيذ في الوقت نفسه. وكثيرًا ما تضع واجهات LLM API سقفًا له لكل مفتاح أو خطة، بمعزل عن عدد الطلبات في الدقيقة، لأن كل طلب مفتوح يشغل قدرة من وحدة GPU حتى تكتمل استجابته.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[رموز الإدخال والإخراج (Input and output tokens)](https://broadrouter.com/ar/glossary/input-and-output-tokens/)

رموز الإدخال هي الرموز (التوكنات) التي يقرؤها نموذج اللغة في الطلب، ومنها أمر النظام وسجل المحادثة وتعريفات الأدوات والصور. ورموز الإخراج هي الرموز التي يولّدها في الرد، بما فيها الاستدلال المنطقي. وتسعّر واجهات LLM API كلًّا منهما على حدة عادةً، والإخراج أغلى في الغالب.

[وكيل البرمجة بالذكاء الاصطناعي (AI coding agent)](https://broadrouter.com/ar/glossary/coding-agent/)

وكيل البرمجة بالذكاء الاصطناعي أداة برمجية يعمل فيها نموذج لغة على قاعدة شيفرة في حلقة: يقرأ الملفات ويعدّلها، وينفّذ أوامر كالاختبارات، ويقرأ المخرجات، ثم يقرّر الخطوة التالية حتى تنتهي المهمة أو يُبلغ حدّ معيّن.

[استدعاء الأدوات (Tool calling)](https://broadrouter.com/ar/glossary/tool-calling/)

استدعاء الأدوات، ويُسمّى أيضًا استدعاء الدوال (function calling)، ميزة في واجهات LLM API يُرجع فيها النموذج طلبًا منظَّمًا لتشغيل دالة عرّفها المطوّر، مع معاملات بصيغة JSON. ويشغّل التطبيق الدالة ويعيد النتيجة؛ فالنموذج لا يشغّل الشيفرة بنفسه أبدًا.

[النموذج مفتوح الأوزان (Open-weight model)](https://broadrouter.com/ar/glossary/open-weight-model/)

النموذج مفتوح الأوزان نموذج تعلّم آلي تُنشر أوزانه المدرَّبة ليحمّلها أي أحد ويشغّلها، عادةً بموجب ترخيص له شروط. ويختلف عن الذكاء الاصطناعي مفتوح المصدر بالكامل، الذي يُصدر أيضًا شيفرة التدريب ومعلومات مفصّلة عن بيانات التدريب، ليتمكن الآخرون من دراسة النموذج وإعادة إنتاجه.

[خطة LLM API بسعر ثابت (Flat-rate LLM plan)](https://broadrouter.com/ar/glossary/flat-rate-llm-plan/)

خطة LLM بسعر ثابت هي خطة تحتسب سعرًا ثابتًا لفترة، كالشهر، مقابل الوصول إلى واجهة API لنموذج لغة، بدل الاحتساب لكل رمز (توكن). وتحدّ هذه الخطط عادةً شيئًا آخر، مثل التزامن أو السرعة أو النماذج أو نوافذ الاستخدام، لذا تهم الحدود بقدر ما يهم السعر.

## أسئلة شائعة

### هل من الآمن ترك وكيل يشغّل أوامر الصدفة دون مراقبة؟

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

### كم مهمة ليلية تتحملها جلسة خطة واحدة؟

تشغّل الجلسة طلبًا واحدًا في كل مرة، فتعمل المهام على الجلسة الواحدة واحدة تلو الأخرى. رتّبها في طابور متتابع على جلسة واحدة، أو اشترِ جلسة لكل وكيل تريد تشغيله بالتوازي.

### ماذا لو كسر الوكيل البناء أثناء الليل؟

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

### ما المهام التي تناسب التشغيل الليلي؟

العمل المحدّد جيدًا والقابل للاختبار، مثل نقل مواضع الاستدعاء إلى API جديدة، وإضافة اختبارات لوحدات بلا اختبارات، وإصلاح تحذيرات lint في قاعدة الشيفرة كلها، وترقية التبعيات. أما أعمال التصميم المفتوحة فالأفضل أن تُنجز بمشاركة إنسان.

## تابع القراءة

-   [10 طرق لخفض تكلفة LLM في وكلاء البرمجة، مع التوفير المتوقع](https://broadrouter.com/ar/blog/cut-coding-agent-llm-costs/)
-   [كيف تشغّل وكلاء برمجة متوازيين على LLM API بسعر ثابت](https://broadrouter.com/ar/blog/run-parallel-coding-agents-flat-rate/)
-   [إدارة السياق للوكلاء طويلي التشغيل مع نافذة بمليون رمز](https://broadrouter.com/ar/blog/long-running-agent-context-management/)
-   [LLM API بسعر ثابت أم الدفع لكل رمز؟ حساب نقطة التعادل](https://broadrouter.com/ar/blog/flat-rate-vs-pay-per-token-llm-api/)
-   [حقن الأوامر في وكلاء البرمجة: دفاعات تصمد فعلًا](https://broadrouter.com/ar/blog/prompt-injection-coding-agents/)
-   [كم يكلّف تشغيل واحد لوكيل برمجة: الخطوات ونمو السياق والتخزين المؤقت](https://broadrouter.com/ar/blog/ai-coding-agent-run-cost/)
-   [Claude Code مع النماذج المفتوحة: الوكلاء ونقاط النهاية الأصلية والحدود](https://broadrouter.com/ar/blog/claude-code-with-openai-compatible-models/)
-   [دليل: تشغيل Aider على DeepSeek V4.1 Flash غير المحدود](https://broadrouter.com/ar/guides/aider-unlimited-deepseek/)
-   [دليل: كيف تعمل خطط LLM API غير المحدودة مع الوكلاء](https://broadrouter.com/ar/guides/unlimited-llm-api-sessions/)
-   [دليل: اربط مفاتيح API بخوادمك عبر قوائم عناوين IP المسموح بها](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-overnight-coding-agent-runs&utm_content=page-cta) ·

**المصادر**

-   [وثائق Docker، أمان Docker Engine](https://docs.docker.com/engine/security/)
-   [وثائق Git، git-worktree](https://git-scm.com/docs/git-worktree)
-   [وثائق Aider، تشغيل aider بالسكربتات](https://aider.chat/docs/scripting.html)
-   [خطط BroadNet Inference غير المحدودة](https://inference.broadnet.ai/ar/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-blog-overnight-coding-agent-runs&utm_content=sources)
