استكشاف الأخطاء

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

الودجت لا يظهر

السبب الأكثر شيوعًا هو Content-Security-Policy صارمة في صفحتك. يحقن الودجت أنماطه داخل Shadow DOM عبر عنصر style، لذا فإن style-src التي تمنع الأنماط المضمّنة تحجبه — اسمح بـ 'unsafe-inline' ضمن style-src (الأنماط لا تغادر الـ shadow root الخاص بالودجت أبدًا). تُظهر وحدة تحكم المتصفح انتهاك CSP عندما يكون هذا هو السبب.

تأكد أيضًا أن script-src يسمح بـ cdn.syncanix.com (حيث يُقدَّم widget.js) وأن connect-src يسمح بـ api.syncanix.com (التي يتحدث إليها).

الصفحات التي تفرض Trusted Types ‏(require-trusted-types-for 'script') مدعومة: تعمل الأداة وتحاور دون تمرير أي سلسلة نصية إلى مصارف DOM. فقط إذا كانت سياستك تقيّد أيضًا أسماء السياسات عبر توجيه trusted-types، فاسمح بـ syncanix-widget (تحدي الحماية من الروبوتات) وsyncanix-widget-sw (عامل الخدمة دون اتصال) وdompurify (منقّي الإجابات) — وإلا فستتراجع هذه الميزات الاختيارية بسلاسة بينما تستمر المحادثة في العمل.

الطلب الأول بطيء، أو يفشل مرة ثم يعمل

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

الاكتشاف لم يجد شيئًا، أو اختار إطار العمل الخطأ

شغّل syncanix doctor أولًا — يفحص إصدار Node وإطار العمل المكتشف وصحة الإعدادات ومفتاح API دفعة واحدة. إن أخطأ الاكتشاف (المستودعات المختلطة قد تربكه)، فسمِّ إطار العمل صراحةً: syncanix init --framework <name>.

إن فحص الاكتشاف مجلدات لا ينبغي له (كود مورَّد، ملفات مولَّدة)، فأضفها إلى .syncanixignore وأعد التشغيل.

فشل الإثراء، أو تحتاج إلى العمل دون اتصال

مرّر --offline لكتابة الكتالوج محليًا دون رفعه؛ ومن دون مفاتيح نماذج مهيأة، يُكمل syncanix init --offline --yes الاكتشاف دون إثراء. ملف الكتالوج حتمي، لذا لا تُربك إعادة التشغيل لاحقًا مراجعتك.

مشكلات تسجيل الدخول

يخزّن syncanix login رمزًا مولَّدًا من لوحة التحكم في ~/.syncanix/credentials (يقرؤه أنت فقط)؛ ويزيله syncanix logout. إن فشل الرفع بخطأ مصادقة، فشغّل syncanix doctor — يخبرك إن كان المفتاح المخزَّن صالحًا — ثم سجّل الدخول مجددًا.

تغيير قرار موافقة محفوظ

قرار موافقتك على الإثراء محفوظ في .syncanix/consent.json. لتغييره احذف الملف وأعد تشغيل syncanix init — يظهر سؤال الموافقة من جديد.

الخطوات التالية