تخطّي إلى المحتوى الرئيسي
أدلة إعداد Studio سيتولى مساعدي الذكي إعداده

دع مساعدك الذكي يُعدّ Studio

يمكن لمساعد برمجة بالذكاء الاصطناعي على جهازك، مثل Claude Code أو Codex أو Cursor، أن ينشر Studio على الإنترنت نيابةً عنك. أنت تلصق تعليمات جاهزة. يقرأ مساعدك دليل الإعداد المرفق في حزمة Studio نفسها، ويحدد معك أيّهما أنسب: استضافة الويب لديك أم حساب Cloudflare، ويسألك قبل أن يغيّر أي شيء.

الأفضل لـ
الأشخاص الذين يستخدمون بالفعل مساعد برمجة بالذكاء الاصطناعي يستطيع تشغيل الأوامر على جهازهم، لأي نوع من Studio: على استضافة الويب أو في Cloudflare.
ما تحتاج إليه
Maxisnap لنظام Windows أو Mac، مع تسجيل الدخول بالحساب الذي لديه Studio؛ ومساعد برمجة بالذكاء الاصطناعي على جهازك؛ وبيانات تسجيل الدخول إلى استضافتك أو حساب Cloudflare.
المدة
بأقل تدخل منك: تجيب عن أسئلة مساعدك وتوافق على كل تغيير.
ما تحصل عليه
Studio نفسه كما في خيارات الإعداد الأخرى، على استضافة الويب لديك أو في حساب Cloudflare الخاص بك.

ما يتبعه مساعدك

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

  • أن يسألك قبل كل عملية رفع أو نشر أو تغيير على خادم أو حساب، وأن يخبرك بالضبط بما سيغيّره.
  • ألّا يحذف ما هو موجود بالفعل أو يستبدله أو يعيد تسميته أبدًا: ملفات الموقع أو سجلات DNS أو Workers أو الحاويات أو قواعد البيانات. إذ يضيف Studio أشياء جديدة فقط.
  • أن يُبقي المفاتيح وكلمات المرور خارج الملفات التي ينشئها.
  • أن يعطيك عنوان Studio ومفتاح المسؤول في النهاية، لتتمكن من ربط Maxisnap.

احصل على Studio على جهازك

  • على Windows: في Maxisnap، افتح الإعدادات ← الحساب ← معالج إعداد Maxisnap Studio، وانقر على «ابدأ الآن»، ثم «تنزيل لوحة المعلومات». يحفظ Maxisnap ملف ZIP الخاص بـ Studio في مجلد التنزيلات لديك ويفتح ذلك المجلد.
  • على Mac: في Maxisnap، افتح «Settings»‏ ← «Welcome & Help»‏ ← «Studio Setup Guide»، وانقر على «Get Started» ثم «Download Dashboard». يحفظ Maxisnap ملف ZIP الخاص بـ Studio في مجلد التنزيلات لديك.

فك ضغط ملف ZIP. على Windows، انقر عليه بزر الماوس الأيمن واختر «استخراج الكل». وعلى Mac، انقر عليه نقرًا مزدوجًا.

انسخ موقع المجلد المستخرج؛ ستلصقه في الخطوة 3. على Windows، انقر بزر الماوس الأيمن على المجلد واختر «نسخ كمسار». وعلى Mac، حدّد المجلد واضغط Option+Command+C.

ملف تعليمات مساعدي الذكاء الاصطناعي موجود في ذلك المجلد:

AGENTS.md

ما ستراه مجلد Studio المستخرج: ثلاثة مجلدات (cloudflare وdocs وsnaps)، وصفحة Start Here، وتعليمات مساعدي الذكاء الاصطناعي.

اعتمد علامتك التجارية، إن رغبت

انقر نقرًا مزدوجًا على «Maxisnap Studio - Start Here.html»، وصمّم شعارك وألوانك وخطوطك، وانقر على «Lock in my branding». سيستخدم مساعدك ذلك. ويمكنك أيضًا تخطي هذه الخطوة وتغيير العلامة التجارية لاحقًا من لوحة التحكم ضمن «Branding».

انسخ التعليمات

انسخ هذه التعليمات، واستبدل السطر الموجود بين الأقواس الزاوية بمجلد Studio لديك، ثم الصقها في مساعدك.

Set up Maxisnap Studio for me.

Maxisnap Studio is a self-hosted dashboard for the screenshots and screen recordings the Maxisnap desktop app uploads: a private library plus branded share links. It comes in two editions with the same features: a PHP app for ordinary web hosting, and a Cloudflare Worker that uses R2 and D1.

Everything is in this folder on my computer:
  <the folder where I extracted the Studio download>

Start by reading AGENTS.md in that folder. It explains both editions, the exact install steps, what must stay private, and how to check the result.
If I locked in my branding, it is in snaps.zip; AGENTS.md says what to do if it is missing.

Goal: Work out with me whether the PHP edition (my web hosting) or the Cloudflare Workers edition fits my setup, then install it.

Rules:
- Ask me before you upload, deploy, or change anything on a server or in an account, and tell me exactly what you will change.
- Never delete, overwrite or rename existing website files, DNS records, Workers, buckets or databases. Studio only adds new things.
- Keep keys and passwords out of files you create and out of chat transcripts where you can.
- When it works, give me the Studio address and the Admin key so I can connect the Maxisnap app (on Windows, Settings, Account, Maxisnap Studio setup wizard, step 4; on a Mac, Settings, Welcome & Help, Studio Setup Guide, “I already have a dashboard”).

أجب عن أسئلة مساعدك

  1. أخبره بمكان موقعك: على استضافة ويب (cPanel أو hPanel أو Plesk وما شابه)، أو على Cloudflare، أو أنه غير موجود بعد. وإذا لم يكن لديك موقع، فإصدار Cloudflare هو الخيار الآمن.
  2. وبالنسبة إلى استضافة الويب، فإنه يخبرك بما يجب رفعه وأين، أو يرفعه نيابةً عنك إذا منحته حق الوصول إلى استضافتك.
  3. بالنسبة إلى Cloudflare، يطلب منك رمز API من Cloudflare. أنشئ الرمز في Cloudflare من «My Profile»‏ ← «API Tokens» بالأذونات التي يسردها مساعدك، والصقه في الطرفية بنفسك.

راجع خطوات حساب Cloudflare والتخزين والرمز في دليل حساب Cloudflare المجاني.

راجع خطته قبل أن توافق

قبل أي نشر على Cloudflare، يعرض عليك مساعدك الخطة. يسرد «Will create» ما سيُنشأ: Worker واحدًا وحاوية R2 واحدة وقاعدة بيانات D1 واحدة، ويسرد «Will not touch» كل ما عدا ذلك في الحساب. وعلى استضافة الويب، يخبرك بالمجلد الذي سيضيفه. لا توافق إلا عندما تبدو القائمة صحيحة.

ما ستراه ملخص مساعدك لما سينشئه وما سيتركه كما هو، بانتظار موافقتك.

اربط Maxisnap وجرّبه

عندما يعمل، يعطيك مساعدك عنوان Studio الخاص بك ومفتاح المسؤول الخاص به. احتفظ بالمفتاح في مكان آمن، مثل مدير كلمات المرور لديك.

  • Maxisnap لنظام Windows: افتح الإعدادات ← الحساب ← معالج إعداد Maxisnap Studio، وانقر على «ابدأ الآن»، ثم على «التالي» حتى الخطوة 4، «ربط Maxisnap». الصق عنوان Studio الخاص بك ومفتاحه، وانقر على «اختبار الاتصال»، ثم «التالي»، ثم «إنهاء وحفظ» في الصفحة الأخيرة. يمكنك استخدام مفتاح المسؤول الذي ظهر لك أثناء الإعداد، أو رمز رفع من «People & access» في لوحة التحكم.
  • Maxisnap لنظام Mac: افتح «Settings»‏ ← «Welcome & Help»‏ ← «Studio Setup Guide» واختر «I already have a dashboard». الصق عنوان Studio الخاص بك ومفتاحه، وانقر على «Test Connection»، ثم «Next»، ثم «Finish & Save».

التقط شيئًا ما ثم انقر على «رفع» (أو «Upload» على Mac) في المحرر. وعلى Windows، يلتقط Ctrl+Alt+7 منطقة ويرفعها فورًا. ويصل رابط المشاركة إلى الحافظة.

الخطوات التالية: أضف فريقك في لوحة التحكم ضمن «People & access» (يحصل كل شخص على رمزه ودوره الخاص)، وغيّر شعارك أو ألوانك في أي وقت ضمن «Branding».

إذا حدث خطأ ما

يقول مساعدك إنه لا يستطيع فتح الملفات أو تشغيل الأوامر

استخدم مساعد برمجة يعمل على جهازك ويستطيع العمل داخل مجلد، مثل Claude Code أو Codex أو Cursor. أما المحادثة في علامة تبويب بالمتصفح فلا تستطيع رؤية مجلد Studio لديك ولا تشغيل أداة النشر.

لا يجد مساعدك ملف التعليمات

تحقق من المجلد الذي لصقته في التعليمات. يجب أن يكون مجلد Studio المستخرج وليس ملف ZIP، وهو يحتوي على ملف التعليمات الخاص بمساعدي الذكاء الاصطناعي.

يقول مساعدك إن Node.js غير موجود أو قديم جدًا

تحتاج أداة النشر على Cloudflare إلى Node.js 20 أو أحدث. ثبّت إصدار LTS الحالي من nodejs.org، أو دع مساعدك يثبّته بعد أن يخبرك بما سيفعله، ثم ابدأ من جديد. أما Studio على استضافة الويب فلا يحتاج إلى Node.js.

يطلب منك مساعدك لصق رمز أو كلمة مرور في المحادثة

الصقه في الطرفية بدلًا من ذلك، عندما يطلبه الأمر، حتى لا يبقى في سجل المحادثة. وإذا كنت قد لصقت رمز Cloudflare في المحادثة بالفعل، فاحذفه في Cloudflare من «My Profile»‏ ← «API Tokens» بعد أن يعمل Studio لديك، وأنشئ رمزًا جديدًا عندما تحتاج إليه مرة أخرى.

يريد مساعدك حذف شيء أو استبداله أو إعادة تسميته

قل لا. يضيف Studio أشياء جديدة فقط، وتطلب تعليماته من مساعدك ألّا يحذف أبدًا ملفات الموقع أو سجلات DNS أو Workers أو الحاويات أو قواعد البيانات الموجودة، ولا يستبدلها ولا يعيد تسميتها. اطلب منه اختيار اسم جديد بدلًا من ذلك.

يقول مساعدك إن ملف العلامة التجارية مفقود

لم تعتمد علامتك التجارية بعد. افتح «Maxisnap Studio - Start Here.html»، وصمّم علامتك التجارية وانقر على «Lock in my branding»، أو اطلب من مساعدك المتابعة بمظهر Maxisnap. يمكنك تغييرها لاحقًا من لوحة التحكم ضمن «Branding».

يُرجع الفحص النهائي لمساعدك الرمز 401 أو 404

{"error":"unauthorized"}

الرمز 401 يعني أن المفتاح خاطئ: استخدم مفتاح المسؤول تمامًا كما عرضه الإعداد. أما الرمز 404، أو ظهور صفحة ويب بدلًا من رد قصير، فيعني أن العنوان أو المجلد خاطئ، أو (على استضافة الويب) أن قواعد ‎.htaccess الخاصة بـ Studio يجري تجاهلها.

توقف النشر على Cloudflare في منتصف العملية

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

لا يتصل Maxisnap بالعنوان والمفتاح اللذين أعطاك إياهما مساعدك

العنوان هو الذي تفتح عليه لوحة تحكم Studio، ويبدأ بـ https://, ‎مثل https://yourcompany.com/snaps. انسخ المفتاح دون مسافات قبله أو بعده. ويشرح دليل ربط Studio موجود مسبقًا معنى كل رسالة.

لا تزال بحاجة إلى مساعدة؟

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

  • خيار الإعداد الذي اخترته والخطوة التي أنت فيها.
  • لقطة شاشة للشاشة، مع أي رسالة خطأ كاملة.
  • المكان الذي ستضع فيه Studio: حساب Cloudflare جديد أو حالي، أو اسم مزوّد استضافة الويب لديك.
  • إصدار Maxisnap لديك: على Windows في الإعدادات ← حول؛ وعلى Mac ضمن «Maxisnap»، ثم «About Maxisnap».

يُرجى عدم إرسال مفتاح المسؤول أو مفتاح Cloudflare أو كلمة مرور. لا نحتاج إليها لمساعدتك.

أدلة إعداد أخرى