Astro

تجهيز نطاق النشر#

فعّل إظهاره على موقعي لوكيل Make Agent Fast (صفحة الوكيل ← انشره مباشرةً ← أداة الموقع)، ثم أضف نطاقات Astro الدقيقة الخاصة بالتطوير والمعاينة والإنتاج ضمن عناوين المواقع المسموح بها. المهم هو المخطط (scheme) واسم المضيف والمنفذ كما تظهر في المتصفح في النهاية، وليس مضيف البناء ولا عنوان URL للمستودع.

الإضافة إلى تخطيط مشترك#

ضع أداة التحميل الخارجية القياسية قبل </body> مباشرةً في تخطيط Astro الذي ينبغي أن يمتلك زر التشغيل.

---
// src/layouts/BaseLayout.astro
---

<html lang="en">
  <body>
    <slot />

    <script
      is:inline
      src="https://makeagent.fast/embed.js?v=20261022-open"
      data-agent="YOUR_SITE_SLUG"
      data-position="right"
      data-label="Ask us"
      async
    ></script>
  </body>
</html>

تُخبر is:inline Astro بالإبقاء على وسم السكربت الخارجي وسمات data-* الخاصة به كما هي بدلًا من تجميعه أو تحويله. تظل أداة التحميل عامة ومستقلة عن أي إطار عمل؛ لا تستورِدها داخل وحدة خادم.

الاقتصار على صفحات محددة#

استخدم تخطيطًا متداخلًا أو أدرج الوسم في صفحات .astro المحددة فقط. تجنّب وضع الوسم نفسه في التخطيط الأساسي وفي الصفحة معًا. تتجاهل أداة التحميل أي جذر مكرر بنفس المعرّف (slug)، لكن تكرار HTML يجعل التنقل وعملية الإزالة أصعب في التتبع.

إذا كانت انتقالات العرض (view transitions) من جهة العميل في Astro مفعّلة، فاختبر التحميل المباشر للصفحات والتنقل داخل التطبيق. يُفضَّل استخدام تخطيط مشترك ثابت للوكيل المعروض في الموقع كله. أما للسلوك الخاص بمسارات معينة، فاحذف السكربت وmaf-embed-root-YOUR_SITE_SLUG معًا عند مغادرة المسار، قبل إدراج سكربت جديد لاحقًا.

ضبط CSP والموافقة#

لا تزال ترويسات الاستضافة الثابتة هي التي تتحكم في المتصفح. اسمح بـ https://makeagent.fast في script-src وframe-src وسياسة الاتصال المعنية. إذا كان مدير الموافقة يحجب السكربت، فحمّل الوسم بعد الحصول على الموافقة المطلوبة فقط، بدلًا من إضعاف CSP أو تجاوز الموافقة.

التحقق من المخرجات المبنية#

1. شغّل بناء الإنتاج في Astro وافحص ملف HTML الناتج للتأكد من بقاء وسم data-agent.
2. افتح الصفحة المنشورة في نافذة خاصة.
3. تأكد من وجود جذر تضمين واحد ونجاح طلبات أداة التحميل وiframe.
4. تنقّل بين مسارات Astro وتأكد من الاستمرارية المقصودة.
5. أرسل رسالة حقيقية واختبر السلوك على الجوال والميكروفون.

استكشاف الأخطاء وإصلاحها#

لا يتوفر حاليًا محوّل Astro منشور على npm؛ استخدم أداة التحميل المستضافة الموضّحة هنا.