التطوير عن بُعد في Zed: SSH والمهام والمعاينات المحلية

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

يربط التطوير عن بُعد في Zed محرّرك المحلي بنسخة عمل عبر SSH. تبقى الواجهة على حاسوبك المحمول، بينما تعمل خوادم اللغات والمهام والطرفيات على المضيف البعيد. توضّح وثائق الاتصال عن بُعد في Zed هذا التقسيم.

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

ما الذي يبقى محليًا وما الذي يعمل على المضيف البعيد

حدّد مواقع المحرّر ونسخة العمل ومسارات التنفيذ

ابدأ بتحديد المكان الذي يجري فيه العمل. النافذة التي تبدو محلية لا تخبرك بالكثير عن العملية التي تعمل خلفها. تحدّد البنية الموثّقة موقع كل مكوّن:

وجود مضيف يحتوي على أدوات أو بيانات يحتاج إليها مشروعك يمنحك سببًا للعمل عن بُعد. الاتصال وحده لا يوفّر بيئة قابلة لإعادة الإنشاء ولا دليلًا على تحسّن الأداء.

تعامل مع طلبات الذكاء الاصطناعي بوصفها مسارًا منفصلًا

يحتاج الذكاء الاصطناعي إلى مراجعة مستقلة. تصف النظرة العامة للاتصال عن بُعد التواصل المحلي مع النماذج، بينما تميّز وثائق خصوصية الذكاء الاصطناعي في Zed بين مسارات الطلبات الخاصة بمفاتيح المزوّدين والبوابات والوكلاء الخارجيين وسلاسل محادثات الطرفية. لا يمكنك استنتاج وجهة الموجّه من موقع نسخة العمل.

ابدأ بمضيف لديك تصريح لاستخدامه ونسخة عمل مخصّصة للتطوير

تأكّد من الوصول عبر SSH دون إضعاف التحقّق

يفترض هذا الدليل أن لديك بالفعل تصريحًا للوصول إلى مضيف تطوير. جهّز سلسلة أدواته بصورة مستقلة، واختر نسخة عمل مخصّصة خارج بيئة الإنتاج. اسم المضيف devbox.example.com وهمي؛ استبدله بالمضيف المعتمد لديك عند تخطيط الاتصال.

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

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

تحقّق من متطلبات الخادم البعيد وسلسلة الأدوات

يحتاج المضيف إلى ملف تنفيذي مطابق لخادم Zed. تسرد وثائق التطوير عن بُعد مضيفات macOS وLinux وWindows مع قيود، منها عدم شمول الاختبارات جميع توزيعات Linux. اقرأ متطلبات مضيفك الفعلي قبل اعتماد الإعداد.

استخدم قائمة التحضير التالية:

• يعمل وصول SSH المعتمد لديك دون إضعاف التحقّق.
• تستطيع المنصة البعيدة تشغيل خادم Zed المطابق.
• توجد نسخة العمل المخصّصة وبيئة تشغيل المشروع بالفعل.
• يتوفّر مسار معتمد لتنزيل الملف التنفيذي للخادم أو إيصاله.

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

ضع الإعدادات وفحوص بيئة التشغيل في المكان الصحيح

افصل بين الإعدادات المحلية وإعدادات الخادم والمشروع

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

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

افحص بيئة التشغيل البعيدة دون طباعة البيئة كاملةً

لمشروع Node.js على مضيف تطوير شبيه بـ Unix، يمكنك النظر في إجراء الفحوص التالية المقتصرة على القراءة في الطرفية البعيدة. نفترض صدفة متوافقة مع أسلوب POSIX، وتوفّر الأداة hostname، وتثبيت بيئة تشغيل Node.js. تشغيل هذه الأوامر في صدفة منفصلة على الحاسوب المحمول يجيب عن السؤال الخطأ.

hostname
pwd
command -v node
node --version

يطبع hostname اسم المضيف عند تشغيله دون وسيط؛ ويعرض pwd دليل العمل. يبيّن command -v كيفية عثور الصدفة على الأمر، وقد يحدّد اسمًا مستعارًا أو دالة بدلًا من مسار ملف تنفيذي. ويطبع node --version إصدار Node.js. يوثّق مرجع hostname سلوك الأمر، ولا يوثّق دعم Zed لنظام OpenBSD.

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

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

لمشروعات تحزيم Python، تتناول قائمة التحقّق من البناء والنشر باستخدام uv حدًا إضافيًا: عمل نسخة المشروع لا يثبت أن الحزمة الموزّعة تعمل.

اجعل المهام البعيدة تستخدم الدليل والملف المحفوظ والسياق المقصودة

اختر نطاق المهمة وسياسة الحفظ بعناية

ضع مهام المشروع في .zed/tasks.json. تتاح المهام العامة عبر المشروعات. تحدّد وثائق المهام في Zed النطاقين، وتجعل جذر المشروع الحالي دليل العمل الافتراضي.

لا يطبع تعريف مهمة المشروع المقترح هذا سوى ذلك الدليل على مضيف شبيه بـ Unix:

[
  {
    "label": "inspect-task-directory",
    "command": "pwd",
    "save": "none"
  }
]

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

يستحق إعداد الحفظ الافتراضي الانتباه. مع none، قد يختلف محتوى المحرّر المعدّل عن الملف الذي تقرؤه الأداة. اختر current لحفظ محتوى المحرّر النشط، أو all لحفظ جميع المحتويات المعدّلة، كما يوضّح مرجع المهام. تحقّق من الملفات التي سيغيّرها هذا الاختيار قبل اعتماده.

عند إعداد مهمة لاحقة تعتمد على ملفات، اتّبع الفصل بين command وargs في وثائق المهام، بما في ذلك طريقة التعامل مع المتغيرات في المسارات التي تحتوي على مسافات. لا يتضمّن مثال pwd هذا أي وسيط لملف. ولا يخبرك بشيء عن المُدخل الذي سيقرؤه اختبار.

ميّز بين سياق إعادة التشغيل وإعادة استخدام الطرفية

اختيار ملف مختلف لا يغيّر بالضرورة إعادة التشغيل. يعيد Zed افتراضيًا استخدام السياق الذي سبق تحديد قيمه، بما فيه متغيرات الملفات التي جرى التقاطها سابقًا. يضع مثال التحكّم في إعادة التشغيل الخيار reevaluate_context على الإجراء task::Rerun ضمن تعيين لاختصار لوحة المفاتيح. وهو ليس حقلًا في قالب المهمة.

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

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

تتبّع مسار تطبيق ويب بعيد حتى معاينته في متصفح عبر localhost

افصل بين استماع التطبيق وإعادة التوجيه عبر SSH

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

يربط المقتطف المقترح التالي المنفذ المحلي 8080 بالمنفذ البعيد باستخدام إعداد ssh_connections.port_forwards الموثّق في Zed. ادمجه في الاتصال الخاص بالمضيف المصرّح لك باستخدامه، مع الحفاظ على بقية قائمة اتصالاتك.

{
  "ssh_connections": [
    {
      "host": "devbox.example.com",
      "port_forwards": [
        { "local_port": 8080, "remote_port": 3000 }
      ]
    }
  ]
}

تتبّع مسار الطلب المقصود إلى التطبيق الذي يعمل بالفعل:

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

أبقِ المعاينة مرتبطة بـ localhost

تربط الإعدادات الافتراضية لإعادة التوجيه في Zed الطرفين بـ localhost. أبقِ هذه الإعدادات لهذه المعاينة. ضبط local_host على 0.0.0.0 يربط الخدمة بجميع الواجهات المحلية. اضبط الاتصال وإعادة التوجيه المقصودين قبل زيارة http://localhost:8080؛ فما زال localhost في المتصفح يشير إلى حاسوبك المحمول.

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

استخدم دليل المضيف والمهمة والمعاينة لفحص مشروع تطوير واحد

دليل المضيف والمهمة والمعاينة هو قائمة تحقّق تحريرية نقترحها في هذا الدليل. يجمع الحدود الموثّقة في مصفوفة لاتخاذ القرار؛ وهو ليس ميزة في Zed أو معيارًا متّبعًا في القطاع، ولم يُختبَر بوصفه طريقة للنشر.

المضيف: حدّد نسخة العمل ونطاق الإعدادات

استخدم نسخة عمل واحدة لمشروع تطوير غير حساس. احسم المضيف ونطاق الإعدادات اللذين تفحصهما قبل تشخيص التطبيق.

المهمة: افحص بيئة التشغيل والمُدخل المحفوظ

اقرأ مُدخلات الأمر بالعناية نفسها التي تقرأ بها تسميته. افحص سلوك خادم اللغة بصورة مستقلة عن نتائج الطرفية.

المعاينة: تحقّق من الاستماع ومسار المتصفح

تتبّع الطلب حتى تجد أول موضع لعدم التطابق. صحّح تلك الطبقة قبل تغيير إعداد آخر.

احتفظ بسجل صغير خلال التجربة. تدعم هذه الملاحظات قرارًا بشأن الإعداد؛ ولا تقيس تحسّنًا في الأداء.

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

{
  "framework": "host-task-preview",
  "checks": ["authorized-checkout", "saved-task-input", "running-app-and-local-forward"],
  "status": "proposed-unexecuted"
}

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

أخطاء شائعة وحدود: SSH ليس بيئة عزل أو سياسة لخصوصية الذكاء الاصطناعي

صحّح الافتراض قبل تغيير الإعداد

انتبه إلى هذه الأخطاء في التشخيص:

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

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

راجع الثقة بشجرة العمل وتوجيه الذكاء الاصطناعي بصورة منفصلة

يحتفظ Zed بسجلات الثقة بشجرة العمل على نحو منفصل لكل مضيف SSH. يمنع الوضع المقيّد تطبيق إعدادات المشروع وتثبيت أو تشغيل خوادم اللغات وخوادم MCP غير الموثوقة التابعة لها؛ لكن الأدوات الموثوقة على المستوى العام تظل قادرة على العمل. راجع إعدادات المشروع وتعليماته، إلى جانب الأدوات التي يمكنه استدعاؤها، قبل منحه الثقة. منح الثقة الشاملة حل غير مناسب لمسألة تتعلّق بالصلاحيات. الثقة بشجرة العمل لا توفّر بيئة عزل كاملة.

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

إذا كان المسار الذي اخترته يتضمّن بوابة، فإن دليل Vercel AI Gateway يحتوي على قائمة تحقّق منفصلة للتوجيه وسياسة المزوّد. لا يعني هذا الرابط أن جلسة Zed لديك تستخدم البوابة. لا يحتاج التحرير الأساسي عن بُعد إلى استدعاء للذكاء الاصطناعي؛ وتشير البداية السريعة للذكاء الاصطناعي في Zed إلى عنصر تعطيل الذكاء الاصطناعي في محرّر الإعدادات.

اعرف متى تُبقي المشروع محليًا

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

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