استخدم Editor لعرض ملفات المصدر في مشروع Atoms الخاص بك وإدارتها. يمكنك العثور على الملفات، ومعاينة التنسيقات المدعومة، ومقارنة التغييرات، وإضافة الرمز إلى Chat كسياق، وتنزيل ملفات أو مجلدات فردية أو المشروع بالكامل.

يغطي هذا الدليل فقط الملفات المخزنة في مساحة عمل المشروع. تتم إدارة الملفات التي تم تحميلها في Chat، والوسائط التي تم إنشاؤها، والبيانات السحابية، والإصدارات المنشورة، والملفات من الخدمات المتصلة بشكل منفصل.

قبل أن تبدأ

• استخدم متصفحًا على جهاز كمبيوتر. تكون تجربة Editor محدودة على الأجهزة المحمولة.
• انتظر حتى ينتهي Agent قبل إجراء تغييرات يدوية على الملفات نفسها.
• افتح أحدث إصدار من المشروع. إذا كنت تعرض إصدارًا أقدم، فحدد Restore في عناصر التحكم بالإصدار، ثم أكد Restore، وانتظر حتى يكتمل الاستعادة قبل التحرير.
• قد يتطلب تحرير مشروع أو تنزيله باقة مدفوعة مؤهلة.

لا تضع أبدًا كلمات المرور أو مفاتيح API أو Tokens الوصول أو أي أسرار أخرى مباشرةً في ملفات المصدر أو Chat.

فتح Editor

1. افتح مشروعًا موجودًا.
2. حدد Editor من شريط أدوات المشروع.
3. انتظر حتى يتم تحميل شجرة الملفات وعارض الملفات.

تظهر شجرة الملفات على اليسار. يفتح الملف المحدد على اليمين في محرر رموز أو معاينة. تعتمد الأدوات المعروضة لملف ما على تنسيقه وحالة المشروع الحالية.

العثور على الملفات ومعاينتها

البحث حسب اسم الملف أو المجلد

1. حدد Search أعلى شجرة الملفات.
2. أدخل جزءًا من اسم ملف أو مجلد.
3. حدد نتيجة مطابقة لفتحها.

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

ابحث في شجرة ملفات Editor حسب اسم الملف أو المجلد.

معاينة ملف

حدد ملفًا في الشجرة. يمكن لـ Atoms معاينة ملفات الرموز والنصوص الشائعة، وملفات HTML وMarkdown وDOCX وXLSX، والصور، وملفات الصوت والفيديو المدعومة، وملفات PDF وCSV، ودفاتر Jupyter. تعتمد المعاينة المتاحة على نوع الملف.

إذا تعذر معاينة ملف أو مجلد، فقم بتنزيله وافتحه في تطبيق متوافق.

تحرير رمز المشروع

1. افتح ملف رمز أو نص مدعومًا.
2. أجرِ تغييراتك في المحرر.
3. انتظر حتى ينتهي مؤشر الحفظ. يقوم الحفظ بمزامنة جلسة التحرير الحالية، لكنه لا يطبق الجلسة بالكامل بعد.
4. حدد Preview للتحقق من النتيجة عندما تكون المعاينة متاحة.
5. حدد Submit all لتطبيق الجلسة، أو Discard all للتراجع عن التعديلات في تلك الجلسة.

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

عاين جلسة تحرير Editor أو تجاهلها أو أرسلها.

إذا كان Editor للقراءة فقط

قد يمنع Editor التغييرات مؤقتًا بينما يعمل Agent، أو أثناء تنفيذ الحفظ، أو إذا كنت تعرض إصدارًا أقدم من المشروع. وقد يكون أيضًا للقراءة فقط لمشروع غير مدعوم أو لحساب لا يملك الوصول المطلوب.

انتظر حتى تنتهي العملية الحالية، وافتح أحدث إصدار، وحدّث الصفحة. إذا كنت تعرض إصدارًا أقدم، فحدد Restore في عناصر التحكم بالإصدار، ثم أكد Restore، وانتظر حتى يكتمل الاستعادة، ثم أعد فتح أحدث إصدار. تأكد من أن مؤشر Read only لم يعد ظاهرًا قبل التحرير.

استخدام الرمز في Chat ومقارنة التغييرات

إضافة ملف كامل إلى Chat

افتح الملف، وانقر على ... العمودية ثم Select file عندما يكون الإجراء متاحًا. يمكنك أيضًا كتابة # في Chat واختيار ملف مشروع. تتم إضافة الملف كسياق لطلبك التالي.

افتح إجراءات الملف الحالي وحدد Select file.

مقارنة تغيير

حدد Diff عندما يكون متاحًا لمقارنة الإصدارين الأصلي والمعدل من الملف قبل تطبيق التغيير.

إدارة الملفات والمجلدات

استخدم ... بجوار عنصر في شجرة الملفات لرؤية الإجراءات المتاحة لذلك الملف أو المجلد. بناءً على العنصر وحالة المشروع، يمكنك إنشاء الملفات والمجلدات أو تحميلها أو إعادة تسميتها أو تنزيلها أو حذفها.

1. حدد موقع الملف أو المجلد في الشجرة.
2. حدد ....
3. اختر الإجراء المطلوب واتبع المطالبة الظاهرة على الشاشة.

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

بعض إجراءات الملفات غير متاحة بينما يقوم Agent بتغيير المشروع أو أثناء حفظ جلسة تحرير. انتظر حتى تنتهي العملية الحالية ثم حاول مرة أخرى.

تنزيل الرمز والملفات

تنزيل الملف الحالي

1. افتح الملف في Editor.
2. حدد Download من إجراءات الملف الحالي.
3. افتح موقع التنزيل في المتصفح وتحقق من الملف.

تنزيل مجلد

1. حدد ... بجوار المجلد.
2. حدد Download. يقوم Atoms بتجميع المجلد كأرشيف ZIP.
3. افتح الأرشيف وتحقق من محتوياته.

تنزيل المشروع الحالي

1. في Editor، حدد Download Project أسفل شجرة الملفات.
2. اترك الصفحة مفتوحة بينما يقوم Atoms بإعداد الأرشيف.
3. افتح ملف ZIP الذي تم تنزيله وتحقق من الملفات التي تحتاجها.

يجب أن تكون مسجل الدخول. قد يتطلب تنزيل مصدر المشروع الحالي باقة مدفوعة مؤهلة. قد لا يكون تنزيل Editor متاحًا أيضًا في عرض مشروع مشترك للقراءة فقط.

التصدير من Share

يمكنك أيضًا فتح Share وتحديد Export. يوفّر ذلك طريقة أخرى لتصدير المشروع كملف ZIP. راجع الأرشيف الذي تم تنزيله قبل الاعتماد عليه كتسليم أو نسخة احتياطية.

افتح Share وحدد Export لتنزيل المشروع.