التوثيق

إضافة سياق للوكلاء

وكلاء الشيفرة (Claude Code وCodex وKimi وPi وOpenCode…) لا يعرفون إلا ما يبلغ مدخلاتهم. إضافة السياق هي طريقة تسليمهم مسارات الملفات ومقاطع الشيفرة دون إعادة كتابة: اسحب ملفات من Explorer، أو اسحب نصًا محددًا من محرر الشيفرة وعرض diff لـ Git، مباشرة إلى طرفية الوكيل أو صندوق دردشة Copilot.

سحب الملفات

اضغط ملفًا — أو تحديدًا متعددًا — في قائمة ملفات Explorer واسحبه:

  • فوق طرفية: تُكتب المسارات الكاملة عند نقطة الإفلات، مفصولة بمسافات، جاهزة لأن تصبح جزءًا من مطالبتك التالية للوكيل;
  • فوق صندوق دردشة Copilot: تُدرج المسارات في مسودة الرسالة، واحدًا في كل سطر، لتجميع مطالبة متعددة الملفات قبل الإرسال.

المسارات المسحوبة من مدير ملفات نظام التشغيل والمُفلتة فوق طرفية تُنصّ تلقائيًا، فتنجو الأسماء المحتوية مسافات سليمة.

سحب ملف من قائمة Explorer إلى طرفية يكتب مساره الكامل

سحب الشيفرة المحددة كسياق

حدد نصًا في محرر الشيفرة أو في diff لـ Git، ثم اضغط التحديد نفسه واسحبه فوق طرفية:

  • عندما يشغّل الطرفية وكيل شيفرة، يُدرج الإفلات كتلة سياق — مسار الملف، ونطاق الأسطر، والمقطع مغلّفًا بسياج شيفرة:
File: crates/vterm/src/ui/terminal_view.rs
Lines: 558-566
```
fn can_accept_native_drop(&self, info: &DndInfo) -> bool { … }
```
  • عندما تكون الطرفية على مطالبة صدفة عادية، يكتب الإفلات النص المحدد الخام بدلًا من ذلك، فيصلح الإيماءة ذاتها للأوامر العادية;
  • عند عرض diff عند تنفيذ معين، تحمل الكتلة إضافةً سطر Commit: يثبّت المراجعة الدقيقة.

نسخ السياق

تسكن الكتلة نفسها قائمة الزر الأيمن: ينسخها Copy Context في محرر الشيفرة وعرض diff إلى الحافظة. الصقها في صندوق دردشة Copilot — أو لأي وكيل آخر — حين يكون السحب غير عملي. يعرض التحريك أعلاه الكتلة الناتجة في مدخلات الوكيل.

نصائح

  • تحديد متعدد في Explorer لإفلات عدة مسارات دفعة واحدة;
  • يرسل صندوق دردشة Copilot مباشرة إلى الطرفية كمدخل مكتوب (انظر سجل وكيل الشيفرة)، فالسياق المضاف هناك يبلغ الوكيل تمامًا كأنك كتبته;
  • ادمجه مع التأكيد التلقائي ليدع الوكيل يتصرف على السياط المُفلت دون مطالبات إضافية.