דיווח על באגים ותכונות

כרטיס השואב Dreame פועל כחלק מהאינטגרציה של dreame_vacuum Home Assistant ולא מחזיק במאגר נפרד. כל דיווחי הבאגים, בקשות התכונות והדיונים נשלחים למאגר האינטגרציה הראשי.

כותרות בעיות

כותרות הבעיות חייבות להראות בבירור את הקשר לכרטיס ה-Dreame Vacuum, לדוגמה [Card] Map is not loading. זה מבדיל בין בעיות ספציפיות לכרטיס לבין בעיות באינטגרציה הכללית.

בדוק עדכונים

בדיקה ב-HACS מבטיחה שהגרסה העדכנית ביותר של האינטגרציה dreame_vacuum פועלת לפני פתיחת בעיה. באג מדווח או בקשת תכונה עשויים כבר להתקיים בגרסה חדשה.

פתיחת בעיה ב-GitHub

בקשת תכונה

רעיונות ותכונות חדשות ושיפורים תמיד מתקבלים בברכה.

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

דיווח על באג

מתן מידע ברור ומפורט כאשר מתרחשת התנהגות בלתי צפויה מזרז את תהליך הפתרון.

ראיות חזותיות

נדרשת צילום מסך מלא או הקלטת מסך המראה את הבעיה בלוח המחוונים עבור רכיב UI חזותי זה.

קבלת לוגים של Home Assistant

פתרון תקלות בגרפיקה של הממשק, כפתורים שבורים או כשלים בטעינה דורש בדיקה של השגיאות שמתרחשות מאחורי הקלעים בממשק. Home Assistant לוכד ומקליט באופן אוטומטי את השגיאות לדפדפן ולממשק. לוגים אלה נלקחים ישירות ממערכת Home Assistant.

לכידת לוגים מהממשק של Home Assistant:

1. שחזור הבעיה קודם, כגון לחיצה על הכפתור השבור או רענון הדף אם הכרטיס נכשל בטעינה, מבטיח שהשגיאה תתועד ממש לפני בדיקת היומנים.
2. ניווט אל הגדרות, ולאחר מכן מערכת ואז יומנים בסרגל הצד של Home Assistant.
3. לחיצה על כפתור הורד יומן מלא בתחתית הדף שומרת את הקובץ homeassistant.log באופן מקומי.
4. שימוש באפשרות הצג יומנים מלאים או בתפריט הנפתח (שלוש נקודות) בפינה הימנית העליונה מציג את היומנים הגולמיים ישירות בדפדפן.
5. סינון קובץ היומן שהורד, או העתקת הודעות השגיאה הרלוונטיות, מכין אותן לצירוף לבעיה ב-GitHub.

הגן על נתונים רגישים

קובץ homeassistant.log המלא מכיל מידע רגיש, כגון סיסמאות, אסימונים או מזהים אישיים מאינטגרציות אחרות. חילוץ ושיתוף רק של החלקים הקשורים ל-frontend או ל-dreame_vacuum מגנים על מידע זה. את כל קובץ הלוג יש לא להעלות לציבור מבלי לסקור את תוכנו.