פתרון תקלות

התחילו מהסימפטום שלכם. כל פתרון בעמוד הזה הוא התרופה האמיתית שנשלחת היום — וכשצריך בן אדם, הסעיף האחרון אומר בדיוק לאן לכתוב.

הווידג׳ט לא מופיע

הסיבה הנפוצה ביותר היא 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') נתמכים: הווידג'ט נטען ומשוחח בלי להזין מחרוזת לשום sink. רק אם המדיניות שלכם מגבילה גם את שמות המדיניות באמצעות הנחיית trusted-types, אפשרו את syncanix-widget (אתגר הגנת בוטים), את syncanix-widget-sw (service worker למצב לא-מקוון) ואת dompurify (מנקה התשובות) — אחרת היכולות האופציונליות האלה מתדרדרות בצורה מבוקרת והצ'אט ממשיך לעבוד.

הבקשה הראשונה איטית, או נכשלת פעם אחת ואז עובדת

בסביבות עבודה שקטות, הבקשה הראשונה אחרי חוסר פעילות ארוך עשויה לקחת כמה שניות עד שקיבולת ה-serverless מתעוררת, ובמקרים נדירים נכשלת פעם אחת. הווידג׳ט מנסה שוב אוטומטית את טעינת התצורה שלו. אם אתם קוראים ל-API ישירות, התייחסו לכישלון בודד של בקשה ראשונה אחרי חוסר פעילות כניתן לניסיון חוזר.

הגילוי לא מצא כלום, או בחר פריימוורק שגוי

הריצו קודם syncanix doctor — הוא בודק את גרסת Node, הפריימוורק שזוהה, תקינות התצורה ומפתח ה-API במעבר אחד. אם הזיהוי טעה (ריפו מעורב יכול לבלבל אותו), נקבו בפריימוורק במפורש: syncanix init --framework <name>.

אם הגילוי סרק תיקיות שלא היה צריך (קוד vendored, קבצים מחוללים), הוסיפו אותן ל-.syncanixignore והריצו שוב.

ההעשרה נכשלה, או שאתם צריכים לעבוד אופליין

העבירו --offline כדי לכתוב את הקטלוג מקומית בלי להעלות; בלי מפתחות מודל מוגדרים, syncanix init --offline --yes משלים את הגילוי בלי העשרה. קובץ הקטלוג דטרמיניסטי, כך שריצה חוזרת מאוחר יותר לא מטלטלת את הסקירה שלכם.

בעיות התחברות

syncanix login שומר טוקן שנוצר בלוח הבקרה ב-~/.syncanix/credentials (קריא רק לכם); syncanix logout מסיר אותו. אם העלאות נכשלות בשגיאת אימות, הריצו syncanix doctor — הוא אומר אם המפתח השמור נפתר — והתחברו מחדש.

שינוי החלטת הסכמה שמורה

החלטת ההסכמה להעשרה שמורה ב-.syncanix/consent.json. כדי לשנות אותה, מחקו את הקובץ והריצו שוב syncanix init — שאלת ההסכמה תופיע מחדש.

השלבים הבאים