# الوصول إلى SSH عبر وسيط
SUMMARY: كيف ينفّذ وكيل LLM أوامر على أجهزة بعيدة بأمان عبر واجهة برمجية وسيطة لـ SSH بدلًا من مفاتيح SSH الخام.

KEY CONTEXT:
لا تحتفظ أبدًا بمفاتيح SSH الخاصة الخام كعميل LLM. استخدم واجهة HTTP لوسيط SSH:
1) POST /connect?target=<name> → session_id (دائمة، تعيش ساعات).
2) POST /<session_id>/exec {command, timeout} → exec_id.
3) GET /<session_id>/exec/<exec_id> → المخرجات عند الانتهاء.
4) استخدم نقاط نهاية SFTP لرفع/تنزيل الملفات بدلًا من cat/heredoc.
الأهداف أسماء مسجّلة مسبقًا (مثل "vps1")، لا عناوين IP — الوسيط هو المكان
الوحيد الذي تعيش فيه بيانات الاعتماد.

الوصول إلى SSH عبر وسيط
يحتاج الوكلاء إلى تنفيذ أوامر على أجهزة بعيدة — نشر حاوية، قراءة سجل، إصلاح إعداد. تسليم مفاتيح SSH الخاصة الخام إلى LLM فكرة سيئة: المفاتيح تنتهي في نوافذ السياق والسجلات والمحفوظات النصية. وسيط SSH يحل هذا: هو من يمتلك بيانات الاعتماد، والوكيل يتحدث HTTP فقط.
النموذج
[CODE BLOCK]
يعرض الوسيط جلسات دائمة عبر سطح REST بسيط:
| نقطة النهاية | الغرض |
|---|---|
|  | فتح جلسة →  |
|   | تنفيذ أمر (غير متزامن) →  |
|  | استطلاع المخرجات |
| نقاط SFTP | رفع/تنزيل الملفات، ، ،  |
المصادقة برمز Bearer — النمط نفسه لكل واجهة برمجية أخرى تستخدمها.
نمط التنفيذ
[CODE BLOCK]
قواعد التعامل
1. أعد استخدام الجلسات. الاتصال لكل أمر يبدد الموارد ويلمس حدود المعدل. احفظ  (مثل ) وأجرِ نبضة له قبل إعادة الاستخدام.
2. سمِّ الأهداف ولا تكتشفها. الأهداف مسجّلة مسبقًا (، ، …). الوسيط هو مصدر الحقيقة الوحيد — لا تضمّن عناوين IP في كود الوكيل أبدًا.
3. فضّل SFTP على cat/heredoc في الصدفة للملفات. تهريب البيانات الثنائية عبر  يفسد الحمولات. استخدم نقاط الرفع/التنزيل المخصصة.
4. ضع أوامرك بين علامات اقتباس. تُحلَّل حامل JSON مرتين (HTTP + الصدفة). لُف الأوامر البعيدة بعلامات اقتباس مفردة وأبقها سطرًا واحدًا.
5. افترض التدقيق. كل تنفيذ يدخل سجل تدقيق الوسيط — تصرّف كأن الإنسان يقرأ كل شيء (بوسعه ذلك).
متى لا تستخدم exec
- قراءة حالة مُهيكلة لها واجهة برمجية (Docker، قواعد بيانات، Mind API في Synapse) — فضّل الواجهة البرمجية دائمًا على تحليل مخرجات سطر الأوامر.
- العمليات التفاعلية طويلة الأمد.  نمط «أطلق وانسَ» بمهلة؛ استخدم بدلًا منه  + ملف حالة على الجهاز الهدف.
- أي شيء مدمّر بلا تعليمات صريحة. الوسيط يمنحك القدرة — والإنسان يمنحك الإذن.
استعادة الأخطاء
| العَرَض | الحل |
|---|---|
| 401 عند الاتصال | انتهى الرمز — اقرأه من memory/settings من جديد، لا من محفوظات أبدًا |
| الجلسة 404 | انتهت صلاحية الجلسة (حد 24 ساعة) — أعد الاتصال |
| انتهاء مهلة التنفيذ | ارفع  أو قسّم الأمر؛ تحقق من حمل الجهاز الهدف |
| محتوى ملف فاسد | استخدمت  بدلًا من SFTP — انتقل إلى نقاط SFTP |