بث مباشر 18.11 · الدفعة 318 نوفمبر، 19:00 بتوقيت موسكو — ورشة عملية مجانية لوكلاء الذكاء الاصطناعي · الدفعة 3 تبدأ 23.11ورشة 18 نوفمبر ←الدفعة 3 (23.11)
إصداركود / SDK · جاهز للعملHabr AI→ المصدر

إعداد Qwen Code: ملف QWEN.md والوكلاء الفرعيون وبيئة العزل تقلّل هدر التوكنات

بعد التثبيت، يعيد Qwen Code استكشاف المستودع في كل مرة، ويسأل مجددًا عن أمور كان يكفي قولها مرة واحدة، وأنت تدفع ثمن ذلك توكنات. فهو مثلًا لا يعرف أن الحزم في المشروع تُثبَّت عبر pnpm لا npm، فيستوضح الأمر في كل مرة. تُدوَّن مثل هذه الأوامر والمحظورات في ملف QWEN.md الذي يقرؤه الوكيل في بداية الجلسة. يعرض هذا التحليل، المبني على الإصدار 0.28.0، ست إعدادات تقلّل بعدها الأسئلة والتكاليف.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
إعداد Qwen Code: ملف QWEN.md والوكلاء الفرعيون وبيئة العزل تقلّل هدر التوكنات
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1يُرسَل QWEN.md مع كل طلب، لذلك يُدفع ثمن كل سطر زائد مرات عديدة
يفحص وضع Auto كل أمر بواسطة نموذجحدّد نموذجًا رخيصًا عبر /model --fast
حقيقة رئيسية #3لا يستطيع الوكيل الفرعي المراجِع، الذي لا يملك write_file وedit، تعديل الشيفرة فعليًا

يعمل Qwen Code بعد التثبيت «كما هو»: يعيد في كل مرة استكشاف المستودع، ويكرر الأسئلة نفسها، ويهدر التوكنات على أمور كان يكفي قولها مرة واحدة. تخيّل أن الحزم في مشروعك تُثبَّت عبر pnpm لا npm، وأن الاختبارات تُشغَّل بأمر خاص. الوكيل لا يعرف ذلك، فيسأل في كل جلسة أو يخمّن.

تُدوَّن هذه المعلومات مرة واحدة في ملف QWEN.md، أي مذكرة دائمة للمشروع يقرؤها الوكيل في بداية كل جلسة. روجع هذا التحليل على وثائق Qwen Code للإصدار 0.

28.0 (نوفمبر 2026)، وهو يتناول ست إعدادات: QWEN.md، والقواعد، وأوضاع التأكيد، وخوادم MCP (أدوات خارجية)، والوكلاء الفرعيين (مساعدون متخصصون بصلاحيات مقلَّصة)، وبيئة العزل (عزل أوامر الوكيل).

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

الذاكرة والقواعد: قلها مرة واحدة

توجد الإعدادات في موضعين: الملف ~/.qwen/settings.json ينطبق عليك في جميع المشاريع، أما .qwen/settings.json في جذر المستودع فينطبق على هذا المشروع فقط، ويمكن إيداعه (commit) في المستودع ليصل إلى الفريق كله. لا حاجة إلى وضع مفاتيح API فيهما: فلها متغيرات البيئة أو الإعدادات الخاصة بالمستخدم.

QWEN.md ملف Markdown عادي. يمكن أن يكون هناك ثلاثة ملفات، وتُحمَّل كلها معًا: ~/.qwen/QWEN.md لك في جميع المشاريع، وQWEN.md في الجذر لكامل الفريق، و.qwen/QWEN.local.md لك وحدك في هذا المشروع. يُحمَّل الملف المحلي بعد الملف المشترك، لذلك يمكن استخدامه لاستكمال تعليمات الفريق أو تجاوزها. أما إضافته إلى .gitignore فعليك القيام بها يدويًا. وإذا كان في المستودع ملف AGENTS.md مخصص لأدوات ذكاء اصطناعي أخرى، فسيقرؤه Qwen Code أيضًا.

أسرع طريقة للبدء هي الأمر /init: يدرس الشيفرة وينشئ مسودة تتضمن أوامر البناء والاصطلاحات التي عثر عليها. القاعدة الأهم: الإيجاز والتحديد. وتحذّر الوثائق من أنه كلما طال الملف قلّ التزام النموذج به. فعبارة «استخدم مسافة بادئة من مسافتين في TypeScript» تؤدي الغرض، أما «اكتب الشيفرة بعناية» فلا. إضافة إلى ذلك، يُرسَل QWEN.md مع كل طلب في كل جلسة، فكل سطر زائد يعني توكنات تدفع ثمنها مرات عديدة.

إلى جانب الملف توجد الذاكرة التلقائية: يحفظ Qwen Code ملاحظات بنفسه في ~/.qwen/projects/<المشروع>/memory/. الأمر /remember يحفظ فورًا، و/forget يحذف، و/memory يعرض الملفات المحمَّلة. لكن الذاكرة التلقائية تعمل «بقدر الإمكان»، لذا اكتب كل ما هو إلزامي في QWEN.md.

إذا تضخم الملف، تُنقل بعض التعليمات إلى القواعد (rules): ملفات Markdown في .qwen/rules/. للقاعدة حقل paths: مثل 'src/*/.tsx'. عندها لا تدخل تعليمات React إلى السياق إلا حين يفتح الوكيل ملفًا مطابقًا. وما دام يعدّل Makefile فهي لا تشغل أي حيّز. القاعدة التي لا تحتوي paths تعمل مثل QWEN.md. وقواعد المشروع لا تُحمَّل إلا إذا كنت تثق بالمجلد (trusted folder).

التأكيدات وMCP والوكلاء الفرعيون

أوضاع التأكيد خمسة: Plan (للقراءة فقط)، وAsk Permissions (يسأل عن التعديلات والأوامر معًا)، وAuto-Edit (يعدّل الملفات بنفسه، وينفّذ الأوامر بموافقتك)، وAuto (يقرر مصنِّف)، وYOLO (ينفّذ كل شيء بنفسه، ولا يُستخدم إلا في بيئة معزولة). يتم التبديل بالضغط على Shift+Tab (في Windows: Tab) أو عبر /approval-mode. في الإصدارات الحديثة يكون الوضع الافتراضي Auto: يقيّم نموذج مصنِّف منفصل كل أمر، وكل وصول إلى الشبكة، وكل استدعاء لأداة MCP. وهذه طلبات إضافية إلى API. وإذا لم يُحدَّد نموذج سريع، يُستخدم النموذج الرئيسي، فتكلّف كل عملية فحص ما يكلّفه طلب كامل. لذلك حدّد نموذجًا رخيصًا بالأمر /model --fast أو عبر "fastModel" في الإعدادات، أو انتقل إلى Auto-Edit.

تُحدَّد الأذونات الدقيقة في كتلة permissions: يُنفَّذ ما في allow دون أسئلة (مثل git status وpnpm test)، ويسأل ask دائمًا (git push)، ويحظر deny بالكامل (rm -rf وقراءة .env). أما الملف .qwenignore، مثل .agentignore أو .aiignore، فيعمل مثل .gitignore ويوفّر السياق، لكنه لا يحمي الأسرار: فليست كل الأدوات تأخذه في الاعتبار.

MCP (Model Context Protocol) معيار مفتوح لربط قواعد البيانات وأنظمة تتبع المهام والوثائق. يُضاف الخادم بالأمر qwen mcp add؛ والخيار --scope project يحفظه في إعدادات المشروع. يُوصى بنقل http للخدمات البعيدة، وstdio للبرامج المحلية وDocker، أما sse فقد أصبح قديمًا. وأوصاف الأدوات تشغل جزءًا من السياق أيضًا، لذا اربط ما تحتاج إليه فقط، وقيّد المجموعة عبر includeTools أو excludeTools.

الوكيل الفرعي (subagent) مساعد منفصل له تعليماته وأدواته وسياقه. يمكنه قراءة مئة ملف، بينما يتلقى الوكيل الرئيسي النتيجة النهائية فقط. توجد ملفاته في .qwen/agents/ (وللملفات الخاصة بالمشروع الأولوية) أو في ~/.qwen/agents/. المراجِع الذي يعمل بـ model: fast والأدوات read_file وgrep_search وglob وrun_shell_command لا يستطيع تعديل الشيفرة، لأنه لا يملك write_file ولا edit. القيد الموثوق هو قائمة tools، لا approvalMode: فإذا كانت الجلسة الرئيسية في YOLO، فإن وكيلًا فرعيًا بوضع plan سيجد نفسه في YOLO رغم ذلك.

بيئة العزل: ما يستطيع الوكيل فعله حتى دون أن يسأل

تحسم الأوضاع ما إذا كان الوكيل سيسأل، أما بيئة العزل فتحدد ما يستطيع فعله حتى لو لم يسأل. وإذا كنت تعمل ولو أحيانًا في Auto أو YOLO، فأنت بحاجة إليها. في أحدث الإصدارات ظهر لنظام Linux وضع يعمل فيه Qwen Code نفسه كالمعتاد، بينما تُنفَّذ أوامر الوكيل وعمليات الملفات في عزل عبر bwrap (Bubblewrap).

ابدأ بـ /init، واختصر QWEN.md، وانقل التعليمات الخاصة إلى القواعد، وحدّد /model --fast، ووزّع الأوامر بين allow وdeny، وأنشئ مراجِعًا للقراءة فقط، وفعّل بيئة العزل.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول الذاكرة والقواعد: قلها مرة واحدة؟

توجد الإعدادات في موضعين: الملف ~/.qwen/settings.json ينطبق عليك في جميع المشاريع، أما .qwen/settings.json في جذر المستودع فينطبق على هذا المشروع فقط، ويمكن إيداعه (commit) في المستودع ليصل إلى الفريق كله. لا حاجة إلى وضع مفاتيح API فيهما: فلها متغيرات البيئة أو الإعدادات الخاصة بالمستخدم. QWEN.md ملف Markdown عادي. يمكن أن يكون هناك ثلاثة ملفات، وتُحمَّل كلها معًا: ~/.qwen/QWEN.md لك في جميع المشاريع، وQWEN.md في الجذر لكامل الفريق، و.qwen/QWEN.local.md لك وحدك في هذا المشروع.

ما أبرز التفاصيل حول التأكيدات وMCP والوكلاء الفرعيون؟

أوضاع التأكيد خمسة: Plan (للقراءة فقط)، وAsk Permissions (يسأل عن التعديلات والأوامر معًا)، وAuto-Edit (يعدّل الملفات بنفسه، وينفّذ الأوامر بموافقتك)، وAuto (يقرر مصنِّف)، وYOLO (ينفّذ كل شيء بنفسه، ولا يُستخدم إلا في بيئة معزولة). يتم التبديل بالضغط على Shift+Tab (في Windows: Tab) أو عبر /approval-mode. في الإصدارات الحديثة يكون الوضع الافتراضي Auto: يقيّم نموذج مصنِّف منفصل كل أمر، وكل وصول إلى الشبكة، وكل استدعاء لأداة MCP. وهذه طلبات إضافية إلى API.

ما أبرز التفاصيل حول بيئة العزل: ما يستطيع الوكيل فعله حتى دون أن يسأل؟

تحسم الأوضاع ما إذا كان الوكيل سيسأل، أما بيئة العزل فتحدد ما يستطيع فعله حتى لو لم يسأل. وإذا كنت تعمل ولو أحيانًا في Auto أو YOLO، فأنت بحاجة إليها. في أحدث الإصدارات ظهر لنظام Linux وضع يعمل فيه Qwen Code نفسه كالمعتاد، بينما تُنفَّذ أوامر الوكيل وعمليات الملفات في عزل عبر bwrap (Bubblewrap). ابدأ بـ /init، واختصر QWEN.md، وانقل التعليمات الخاصة إلى القواعد، وحدّد /model --fast، ووزّع الأوامر بين allow وdeny، وأنشئ مراجِعًا للقراءة فقط، وفعّل بيئة العزل.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
ما رأيك؟
جارٍ تحميل التعليقات…